2014-02-12 09:34:09 -05:00
|
|
|
sbase - suckless unix tools
|
|
|
|
===========================
|
|
|
|
|
|
|
|
sbase is a collection of unix tools that are inherently portable
|
|
|
|
across UNIX and UNIX-like systems.
|
|
|
|
|
2015-01-18 13:36:13 -05:00
|
|
|
The following tools are implemented ('*' == finished, '#' == UTF-8 support,
|
2015-03-17 20:11:55 -04:00
|
|
|
'=' == implicit UTF-8 support, '|' == audited, () == petty flag):
|
2014-11-20 18:01:56 -05:00
|
|
|
|
2015-02-28 08:48:44 -05:00
|
|
|
UTILITY POSIX 2008 COMPLIANT MISSING OPTIONS
|
|
|
|
------- -------------------- ---------------
|
|
|
|
=*| basename yes none
|
2015-03-08 16:28:32 -04:00
|
|
|
=*| cal yes none
|
2015-03-01 18:36:51 -05:00
|
|
|
=*| cat yes none
|
2015-03-08 18:31:59 -04:00
|
|
|
=*| chgrp yes none
|
2015-03-05 13:08:28 -05:00
|
|
|
=*| chmod yes none
|
2015-03-08 19:37:34 -04:00
|
|
|
=*| chown yes none
|
2015-03-02 11:41:58 -05:00
|
|
|
=*| chroot non-posix none
|
2015-03-10 19:13:48 -04:00
|
|
|
=*| cksum yes none
|
2015-03-11 06:16:40 -04:00
|
|
|
=*| cmp yes none
|
2015-03-08 14:33:46 -04:00
|
|
|
#*| cols non-posix none
|
2015-03-03 04:52:34 -05:00
|
|
|
col yes none
|
2015-03-11 08:47:33 -04:00
|
|
|
=*| comm yes none
|
2015-03-02 13:15:19 -05:00
|
|
|
=*| cp yes none (-i)
|
2015-03-11 12:33:08 -04:00
|
|
|
=*| cron non-posix none
|
|
|
|
#*| cut yes none
|
2015-03-02 09:12:19 -05:00
|
|
|
=*| date yes none
|
2015-02-28 13:50:12 -05:00
|
|
|
=*| dirname yes none
|
2015-03-11 18:31:26 -04:00
|
|
|
=*| du yes none
|
2015-02-28 14:16:10 -05:00
|
|
|
=*| echo yes none
|
2015-03-02 08:50:43 -05:00
|
|
|
=*| env yes none
|
2015-03-12 19:37:37 -04:00
|
|
|
#*| expand yes none
|
2015-03-22 09:32:56 -04:00
|
|
|
#*| expr yes none
|
2015-02-28 09:12:19 -05:00
|
|
|
=*| false yes none
|
2015-02-28 08:42:26 -05:00
|
|
|
= find yes none
|
2015-03-13 18:47:41 -04:00
|
|
|
#*| fold yes none
|
2015-02-28 08:42:26 -05:00
|
|
|
=* grep yes none
|
2015-03-04 18:58:12 -05:00
|
|
|
=*| head yes none
|
2015-02-28 15:22:55 -05:00
|
|
|
=*| hostname non-posix none
|
2015-03-16 07:37:46 -04:00
|
|
|
=*| kill yes none
|
2015-02-28 13:42:26 -05:00
|
|
|
=*| link yes none
|
2015-03-05 15:14:43 -05:00
|
|
|
=*| ln yes none
|
2015-03-06 18:08:43 -05:00
|
|
|
=*| logger yes none
|
2015-03-16 19:44:18 -04:00
|
|
|
=*| logname yes none
|
2015-03-20 10:17:18 -04:00
|
|
|
#* ls no none (-C, -m, -s, -x)
|
2015-03-01 16:59:20 -05:00
|
|
|
=*| md5sum non-posix none
|
2015-03-05 12:03:08 -05:00
|
|
|
=*| mkdir yes none
|
2015-03-02 11:25:29 -05:00
|
|
|
=*| mkfifo yes none
|
2015-03-17 06:01:33 -04:00
|
|
|
=*| mktemp non-posix none
|
2015-03-04 17:22:43 -05:00
|
|
|
=*| mv yes none (-i)
|
2015-03-02 10:53:13 -05:00
|
|
|
=*| nice yes none
|
2015-03-22 11:29:50 -04:00
|
|
|
#*| nl yes none
|
2015-03-04 16:39:12 -05:00
|
|
|
=*| nohup yes none
|
2015-03-17 16:30:12 -04:00
|
|
|
#*| paste yes none
|
2015-02-28 15:47:17 -05:00
|
|
|
=*| printenv non-posix none
|
2015-03-17 16:43:01 -04:00
|
|
|
#*| printf yes none
|
2015-03-03 11:24:14 -05:00
|
|
|
=*| pwd yes none
|
2015-03-20 17:09:47 -04:00
|
|
|
=*| readlink non-posix none
|
2015-03-17 17:59:48 -04:00
|
|
|
=*| renice yes none
|
2015-02-28 15:30:20 -05:00
|
|
|
=*| rm yes none (-i)
|
2015-03-02 09:39:39 -05:00
|
|
|
=*| rmdir yes none
|
2015-03-20 10:17:18 -04:00
|
|
|
# sed yes none
|
2015-03-20 11:04:23 -04:00
|
|
|
=*| seq non-posix none
|
2015-03-01 18:20:35 -05:00
|
|
|
=*| setsid non-posix none
|
2015-03-01 16:59:20 -05:00
|
|
|
=*| sha1sum non-posix none
|
|
|
|
=*| sha256sum non-posix none
|
|
|
|
=*| sha512sum non-posix none
|
2015-02-28 14:10:25 -05:00
|
|
|
=*| sleep yes none
|
2015-02-28 08:42:26 -05:00
|
|
|
sort no -m, -o, -d, -f, -i
|
2015-03-17 17:59:48 -04:00
|
|
|
=*| split yes none
|
2015-03-01 17:42:16 -05:00
|
|
|
=*| sponge non-posix none
|
2015-03-17 18:05:50 -04:00
|
|
|
#*| strings yes none
|
2015-03-17 18:07:41 -04:00
|
|
|
=*| sync non-posix none
|
2015-03-17 18:24:43 -04:00
|
|
|
=*| tail yes none
|
Audit tar(1), add DIRFIRST-flag to recurse()
I've been wanting to do this for a while now, as tar(1) used to
be one of messiest and cruftiest tools.
First off, before walking through the audit, I'll talk about
what the DIRFIRST-flag for recurse() does.
It basically calls fn() on the first-level-dir before calling
it's subentries. It's necessary here, because else the order
of the tar-files would've been wrong (it would try to create
dir/file before creating dir/).
Now, to the audit:
1) Update manpage, fix mistake that compression is also available
for compressing. It's only available for extracting.
2) Define the major, minor and makedev macros from glibc by ourselves.
No need to rely on them, as they are common sense.
decomp()
3) Simple refactorization.
putoctal()
4) Add a truncation check for snprintf().
archive()
5) BUGFIX: Add checks to any checkable function, don't blindly call
them, this is harmful and there are 100 ways to exploit that.
6) Use estrlcpy() instead of snprintf() wherever possible, fix
alignment.
7) BUGFIX: Terminate the result-buffer of readlink(), check if
it even succeeded.
8) Fix sizeof()-formatting.
unarchive()
9) BUGFIX: Add checks to any checkable function, don't blindly call
them, this is harmful and there are 100 ways to exploit that.
10) BUGFIX: strtoul can happily return negative numbers. Add checks
for that and also if the full string has been processed.
11) Remove calls to perror(). We have eprintf, use it.
12) BUGFIX: "minor = strtoul(h->mode, 0, 8);". We need h->minor of
course.
13) Fix typo "usupported", remove fprintf-call.
print()
14) Check fread().
xt()
15) Get rid of snprintf-magic. Use estrlcat().
16) BUGFIX: check for ferror() on the tarfile.
usage()
17) Update it. The old usage() was like 1000 years old.
main()
18) Add DIRFIRST-flag to the recursor.
19) Don't print usage() when a mode is re-set. We allow this in
general.
20) Add function checks and fix error messages.
21) Add tarfilename-global for proper error-messages.
2015-03-20 20:03:35 -04:00
|
|
|
=*| tar non-posix none
|
2015-03-04 17:05:11 -05:00
|
|
|
=*| tee yes none
|
2015-03-17 18:35:11 -04:00
|
|
|
=*| test yes none
|
2015-03-04 18:29:03 -05:00
|
|
|
=*| time yes none
|
2015-03-17 18:38:09 -04:00
|
|
|
=*| touch yes none
|
2015-03-17 18:41:22 -04:00
|
|
|
#*| tr yes none
|
2015-02-28 09:12:19 -05:00
|
|
|
=*| true yes none
|
2015-02-28 13:59:34 -05:00
|
|
|
=*| tty yes none
|
2015-03-04 18:33:28 -05:00
|
|
|
=*| uname yes none
|
2015-03-17 18:45:03 -04:00
|
|
|
#*| unexpand yes none
|
2015-03-17 18:59:09 -04:00
|
|
|
=*| uniq yes none
|
2015-02-28 14:05:22 -05:00
|
|
|
=*| unlink yes none
|
2015-03-17 19:10:36 -04:00
|
|
|
=*| uudecode yes none
|
2015-03-17 19:14:56 -04:00
|
|
|
=*| uuencode yes none
|
2015-03-17 19:20:19 -04:00
|
|
|
#*| wc yes none
|
2015-02-28 08:42:26 -05:00
|
|
|
= xargs no -I, -L, -p, -s, -t, -x
|
2015-02-28 15:12:27 -05:00
|
|
|
=*| yes non-posix none
|
2014-11-20 18:01:56 -05:00
|
|
|
|
2014-02-12 13:39:13 -05:00
|
|
|
The complement of sbase is ubase[1] which is Linux-specific and
|
2014-02-12 09:34:09 -05:00
|
|
|
provides all the non-portable tools. Together they are intended to
|
|
|
|
form a base system similar to busybox but much smaller and suckless.
|
|
|
|
|
|
|
|
Building
|
|
|
|
--------
|
|
|
|
|
|
|
|
To build sbase, simply type make. You may have to fiddle with
|
|
|
|
config.mk depending on your system.
|
|
|
|
|
|
|
|
You can also build sbase-box, which generates a single binary
|
|
|
|
containing all the required tools. You can then symlink the
|
2015-02-28 09:40:16 -05:00
|
|
|
individual tools to sbase-box or run: make sbase-box-install
|
2014-02-12 09:34:09 -05:00
|
|
|
|
|
|
|
Ideally you will want to statically link sbase. If you are on Linux
|
|
|
|
we recommend using musl-libc[2].
|
|
|
|
|
|
|
|
Portability
|
|
|
|
-----------
|
|
|
|
|
|
|
|
sbase has been compiled on a variety of different operating systems,
|
|
|
|
including Linux, *BSD, OSX, Haiku, Solaris, SCO OpenServer and others.
|
|
|
|
|
|
|
|
Various combinations of operating systems and architectures have also
|
|
|
|
been built.
|
|
|
|
|
|
|
|
You can build sbase with gcc, clang, tcc, nwcc and pcc.
|
|
|
|
|
|
|
|
[1] http://git.suckless.org/ubase/
|
|
|
|
[2] http://www.musl-libc.org/
|