suckless unix tools
Go to file
FRIGN 01de5df8e6 Audit du(1) and refactor recurse()
While auditing du(1) I realized that there's no way the over 100 lines
of procedures in du() would pass the audit.
Instead, I decided to rewrite this section using recurse() from libutil.
However, the issue was that you'd need some kind of payload to count
the number of bytes in the subdirectories and use them in the higher
hierarchies.
The solution is to add a "void *data" data pointer to each recurse-
function-prototype, which we might also be able to use in other
recurse-applications.
recurse() itself had to be augmented with a recurse_samedev-flag, which
basically prevents recurse from leaving the current device.

Now, let's take a closer look at the audit:
1) Removing the now unnecessary util-functions push, pop, xrealpath,
   rename print() to printpath(), localize some global variables.
2) Only pass the block count to nblks instead of the entire stat-
   pointer.
3) Fix estrtonum to use the minimum of LLONG_MAX and SIZE_MAX.
4) Use idiomatic argv+argc-loop
5) Report proper exit-status.
2015-03-11 23:21:52 +01:00
libutf
libutil Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
LICENSE
Makefile Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
README Mark cut(1) and cron(1) as audited in README 2015-03-11 17:33:08 +01:00
TODO Remove file(1) from TODO 2015-03-06 11:26:28 +00:00
arg.h
basename.1
basename.c
cal.1 Audit cal(1) 2015-03-08 21:28:32 +01:00
cal.c style: document intentional fallthrough 2015-03-09 00:33:13 +01:00
cat.1 Audit cat(1) 2015-03-02 00:39:26 +01:00
cat.c Make already audited tools argv-centric instead of argc-centric 2015-03-02 14:19:26 +01:00
chgrp.1 Audit chgrp(1) 2015-03-08 23:31:59 +01:00
chgrp.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
chmod.1 Audit chmod(1) 2015-03-05 19:08:28 +01:00
chmod.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
chown.1 Audit chown(1) 2015-03-09 00:42:23 +01:00
chown.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
chroot.1
chroot.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
cksum.1
cksum.c cksum: Report exit status properly 2015-03-11 12:35:29 +00:00
cmp.1
cmp.c Print usage() when -l and -s are both given in cmp(1) 2015-03-11 13:31:08 +01:00
col.1 col.1: convert to mandoc 2015-03-07 13:56:13 +01:00
col.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
cols.1 Audit cols(1) 2015-03-08 19:49:59 +01:00
cols.c Audit cols(1) 2015-03-08 19:49:59 +01:00
comm.1
comm.c Audit comm(1) 2015-03-11 13:47:08 +01:00
compat.h
config.mk
cp.1 Audit cp(1) 2015-03-02 19:15:19 +01:00
cp.c Refactor enmasse() and recurse() to reflect depth 2015-03-02 22:50:38 +01:00
cron.1
cron.c Use switch with fork() 2015-03-09 15:01:29 +01:00
crypt.h
cut.1
cut.c Audit cut(1) 2015-03-11 17:29:18 +01:00
date.1
date.c Audit date(1) 2015-03-02 15:12:19 +01:00
dirname.1
dirname.c
du.1
du.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
echo.1
echo.c Make already audited tools argv-centric instead of argc-centric 2015-03-02 14:19:26 +01:00
env.1 Audit env(1) 2015-03-02 14:53:24 +01:00
env.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
expand.1
expand.c Implement reallocarray() 2015-03-10 21:23:36 +01:00
expr.1
expr.c don't mix declarations and code (and one ** to *[]) 2015-03-06 07:33:58 +00:00
false.1
false.c
find.1
find.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
fold.1 fold: Fix usage and manpage for -width 2015-03-05 08:16:58 +00:00
fold.c fold: Fix usage and manpage for -width 2015-03-05 08:16:58 +00:00
fs.h Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
grep.1
grep.c grep, kill, renice, sort: style: put main at bottom 2015-03-08 12:51:33 +01:00
head.1 head: Fix usage and manpage 2015-03-05 08:16:56 +00:00
head.c Small fix in head.c 2015-03-06 00:32:22 +01:00
hostname.1
hostname.c
kill.1
kill.c grep, kill, renice, sort: style: put main at bottom 2015-03-08 12:51:33 +01:00
link.1
link.c
ln.1 Audit ln(1) 2015-03-05 21:14:43 +01:00
ln.c Audit ln(1) 2015-03-05 21:14:43 +01:00
logger.1 Audit logger(1) 2015-03-07 00:10:22 +01:00
logger.c Audit logger(1) 2015-03-07 00:10:22 +01:00
logname.1
logname.c
ls.1
ls.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
md5.h
md5sum.1
md5sum.c
mkdir.1
mkdir.c Small fix in mkdir.c 2015-03-06 00:34:43 +01:00
mkfifo.1
mkfifo.c Audit mkfifo(1) 2015-03-02 17:25:29 +01:00
mktemp.1
mktemp.c
mv.1 Audit mv(1) 2015-03-04 23:22:43 +01:00
mv.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
nice.1 Audit nice(1) 2015-03-02 16:53:13 +01:00
nice.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
nl.1 nl: add -l option 2015-03-10 12:55:06 +00:00
nl.c nl: add -l option 2015-03-10 12:55:06 +00:00
nohup.1 Add EXIT STATUS to nohup.1 2015-03-05 00:27:36 +01:00
nohup.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
paste.1
paste.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
printenv.1
printenv.c Make already audited tools argv-centric instead of argc-centric 2015-03-02 14:19:26 +01:00
printf.1
printf.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
pwd.1 Audit pwd(1) 2015-03-03 17:24:14 +01:00
pwd.c Audit pwd(1) 2015-03-03 17:24:14 +01:00
queue.h
readlink.1
readlink.c style: document intentional fallthrough 2015-03-09 00:33:13 +01:00
renice.1
renice.c grep, kill, renice, sort: style: put main at bottom 2015-03-08 12:51:33 +01:00
rm.1
rm.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
rmdir.1 Update rmdir.1 as well 2015-03-02 17:14:29 +01:00
rmdir.c Add argv0 to usage() in rmdir.c 2015-03-02 16:24:08 +01:00
sed.1
sed.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
seq.1
seq.c seq, xargs: style: put main at bottom 2015-03-07 13:36:40 +01:00
setsid.1
setsid.c fork: no need to _exit() on the error case 2015-03-10 20:05:18 +01:00
sha1.h
sha1sum.1
sha1sum.c
sha256.h
sha256sum.1
sha256sum.c
sha512.h
sha512sum.1
sha512sum.c
sleep.1
sleep.c
sort.1
sort.c grep, kill, renice, sort: style: put main at bottom 2015-03-08 12:51:33 +01:00
split.1
split.c staticize some functions 2015-03-07 13:33:39 +01:00
sponge.1
sponge.c Audit sponge(1) 2015-03-01 23:42:16 +01:00
strings.1
strings.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
sync.1
sync.c
tail.1 tail: Add -num to usage and fix manpage to align with head.1 2015-03-05 08:16:58 +00:00
tail.c tail: Add -num to usage and fix manpage to align with head.1 2015-03-05 08:16:58 +00:00
tar.1
tar.c Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
tee.1 Audit tee(1) 2015-03-04 23:05:11 +01:00
tee.c Audit tee(1) 2015-03-04 23:05:11 +01:00
test.1
test.c test: Minor cleanup 2015-03-05 08:04:52 +00:00
text.h
time.1 Add time(1) manpage 2015-03-05 00:22:36 +01:00
time.c fork: no need to _exit() on the error case 2015-03-10 20:05:18 +01:00
touch.1
touch.c staticize some functions 2015-03-07 13:33:39 +01:00
tr.1
tr.c Remove mallocarray(...) and use reallocarray(NULL, ...) 2015-03-11 10:50:18 +01:00
true.1
true.c
tty.1
tty.c
uname.1
uname.c
unexpand.1
unexpand.c Implement reallocarray() 2015-03-10 21:23:36 +01:00
uniq.1
uniq.c uniq: optimization: reuse the prevline buffer 2015-03-08 14:50:46 +01:00
unlink.1
unlink.c
utf.h
util.h Audit du(1) and refactor recurse() 2015-03-11 23:21:52 +01:00
uudecode.1
uudecode.c
uuencode.1
uuencode.c
wc.1
wc.c staticize some functions 2015-03-07 13:33:39 +01:00
xargs.1
xargs.c fork: no need to _exit() on the error case 2015-03-10 20:05:18 +01:00
yes.1
yes.c Make already audited tools argv-centric instead of argc-centric 2015-03-02 14:19:26 +01:00

README

sbase - suckless unix tools
===========================

sbase  is a  collection of  unix  tools that  are inherently  portable
across UNIX and UNIX-like systems.

The following tools are implemented ('*' == finished, '#' == UTF-8 support,
'=' == implicit UTF-8 support, '|' == audited):

    UTILITY         POSIX 2008 COMPLIANT         MISSING OPTIONS
    -------         --------------------         ---------------
=*| basename        yes                          none
=*| cal             yes                          none
=*| cat             yes                          none
=*| chgrp           yes                          none
=*| chmod           yes                          none
=*| chown           yes                          none
=*| chroot          non-posix                    none
=*| cksum           yes                          none
=*| cmp             yes                          none
#*| cols            non-posix                    none
    col             yes                          none
=*| comm            yes                          none
=*| cp              yes                          none (-i)
=*| cron            non-posix                    none
#*| cut             yes                          none
=*| date            yes                          none
=*| dirname         yes                          none
=*  du              yes                          none
=*| echo            yes                          none
=*| env             yes                          none
#*  expand          yes                          none
#*  expr            yes                          none
=*| false           yes                          none
=   find            yes                          none
#*  fold            yes                          none
=*  grep            yes                          none
=*| head            yes                          none
=*| hostname        non-posix                    none
=*  kill            yes                          none
=*| link            yes                          none
=*| ln              yes                          none
=*| logger          yes                          none
=*  logname         yes                          none
=   ls              no                           (-C), -S, -f, -m, -s, -x
=*| md5sum          non-posix                    none
=*| mkdir           yes                          none
=*| mkfifo          yes                          none
=*  mktemp          non-posix                    none
=*| mv              yes                          none (-i)
=*| nice            yes                          none
=   nl              no                           -d, -f, -h, -p
=*| nohup           yes                          none
#*  paste           yes                          none
=*| printenv        non-posix                    none
#*  printf          yes                          none
=*| pwd             yes                          none
=   readlink        non-posix                    none
=*  renice          yes                          none
=*| rm              yes                          none (-i)
=*| rmdir           yes                          none
#   sed
    seq             non-posix                    none
=*| setsid          non-posix                    none
=*| sha1sum         non-posix                    none
=*| sha256sum       non-posix                    none
=*| sha512sum       non-posix                    none
=*| sleep           yes                          none
    sort            no                           -m, -o, -d, -f, -i
=*  split           yes                          none
=*| sponge          non-posix                    none
#*  strings         yes                          none
=*  sync            non-posix                    none
=*  tail            yes                          none
=*  tar             non-posix                    none
=*| tee             yes                          none
=*  test            yes                          none
=*| time            yes                          none
=*  touch           yes                          none
#*  tr              yes                          none
=*| true            yes                          none
=*| tty             yes                          none
=*| uname           yes                          none
#*  unexpand        yes                          none
=*  uniq            yes                          none
=*| unlink          yes                          none
=*  uudecode        yes                          none
=*  uuencode        yes                          none
#*  wc              yes                          none
=   xargs           no                           -I, -L, -p, -s, -t, -x
=*| yes             non-posix                    none

The  complement of  sbase  is  ubase[1] which  is  Linux-specific  and
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
individual tools to sbase-box or run: make sbase-box-install

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/