suckless unix tools https://core.suckless.org/sbase
Go to file
sin 2ef65fe317 Add command(1) to TODO
Potentially useful in certain situations, not for the 0.1 release
though.
2015-04-03 16:54:46 +01:00
libutf Add mkrunetype.awk 2015-02-23 20:36:47 +01:00
libutil libutil/getlines: style fix 2015-03-29 21:55:34 +02:00
arg.h ARGNUMF() only works on base 10 as it uses strtonum underneath 2015-01-30 16:45:44 +00:00
basename.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
basename.c Fix broken sbase-box due to multiple definitions of usage 2015-02-28 18:33:33 +00:00
cal.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cal.c style: document intentional fallthrough 2015-03-09 00:33:13 +01:00
cat.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cat.c Small style-fix in cat.c 2015-03-16 10:36:36 +01:00
chgrp.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
chgrp.c Refactor recurse() again 2015-03-19 01:08:19 +01:00
chmod.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
chmod.c Refactor recurse() again 2015-03-19 01:08:19 +01:00
chown.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
chown.c Refactor recurse() again 2015-03-19 01:08:19 +01:00
chroot.1 Finish up chroot(1) and md5sum(1) 2015-01-31 23:54:51 +01:00
chroot.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
cksum.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cksum.c cksum: Report exit status properly 2015-03-11 12:35:29 +00:00
cmp.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
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: buffer 128 lines by default 2015-03-30 21:48:26 +02:00
col.c col: dont allow col -l 0 2015-03-30 21:49:33 +02: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 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
comm.c fix some signed/unsigned warnings and style fixes 2015-03-27 22:48:05 +01:00
compat.h Add compat.h 2014-11-17 15:46:28 +00:00
config.mk Add info about NetBSD to config.mk 2015-02-20 16:24:17 +00:00
cp.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cp.c Audit cp() in libutil 2015-03-19 17:57:12 +01:00
cron.1 cron.1: path macro for /etc/crontab 2015-02-06 15:43:23 +01:00
cron.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
crypt.h Refactor cryptcheck() to allow multiple list-files and stdin 2015-03-01 22:51:52 +01:00
cut.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cut.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
date.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
date.c Audit date(1) 2015-03-02 15:12:19 +01:00
dirname.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
dirname.c Audit dirname(1) 2015-02-28 19:51:07 +01:00
du.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
du.c du: fix possible division by zero if $BLOCKSIZE is 0 2015-03-30 19:58:06 +02:00
echo.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
echo.c Do not interpret -- in echo(1) 2015-04-03 10:29:11 +01:00
env.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
env.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
expand.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
expand.c Audit expand(1) 2015-03-13 00:38:29 +01:00
expr.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
expr.c Drop maxdigits in expr(1) 2015-03-23 22:56:26 +01:00
false.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
false.c Simplify true(1) and false(1) 2014-10-03 00:03:08 +01:00
find.1 add find.1, sed.1, time.1 stubs 2015-02-28 13:46:20 +01:00
find.c find: fgetc() returns int 2015-03-27 22:48:05 +01:00
fold.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
fold.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
fs.h Audit tar(1), add DIRFIRST-flag to recurse() 2015-03-21 01:30:47 +01:00
grep.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
grep.c whitespace fixes 2015-03-27 22:48:05 +01:00
head.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
head.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
hostname.1 Audit hostname(1) 2015-02-28 21:22:55 +01:00
hostname.c Audit hostname(1) 2015-02-28 21:22:55 +01:00
kill.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
kill.c kill: No need for const int 2015-03-19 10:45:58 +00:00
LICENSE nl: add -d -p -f -h options 2015-03-19 10:10:55 +00:00
link.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
link.c Audit unlink(1) 2015-02-28 20:05:22 +01:00
ln.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
ln.c Audit ln(1) 2015-03-05 21:14:43 +01:00
logger.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
logger.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
logname.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
logname.c Audit logname(1) 2015-03-17 00:44:18 +01:00
ls.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
ls.c ls: add -f and -S options 2015-03-19 10:12:12 +00:00
Makefile Remove apathmax() and implicitly agetcwd() 2015-03-18 15:20:35 +01:00
md5.h Add crypt.[ch] and update md5sum and sha1sum 2013-07-18 09:51:17 -04:00
md5sum.1 Update *sum(1)-manpages and mark them as finished and audited 2015-03-01 22:59:20 +01:00
md5sum.c Refactor cryptcheck() to allow multiple list-files and stdin 2015-03-01 22:51:52 +01:00
mkdir.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
mkdir.c Three bugfixes in mkdir(1) 2015-03-13 12:23:22 +01:00
mkfifo.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
mkfifo.c Audit mkfifo(1) 2015-03-02 17:25:29 +01:00
mktemp.1 Finish up printenv(1) 2015-02-01 00:23:38 +01:00
mktemp.c Add estrlcat() and estrlcpy() 2015-03-17 11:24:49 +01:00
mv.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
mv.c Audit cp() in libutil 2015-03-19 17:57:12 +01:00
nice.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
nice.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
nl.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
nl.c fix some signed/unsigned warnings and style fixes 2015-03-27 22:48:05 +01:00
nohup.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
nohup.c Don't return but _exit after failed exec*() and fork() 2015-03-09 01:12:59 +01:00
paste.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
paste.c paste: fix crash with empty delimiter 2015-03-30 21:25:23 +02:00
printenv.1 Finish up printenv(1) 2015-02-01 00:23:38 +01:00
printenv.c Make already audited tools argv-centric instead of argc-centric 2015-03-02 14:19:26 +01:00
printf.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
printf.c Fix usage for printf(1) 2015-04-03 10:41:38 +01:00
pwd.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
pwd.c Remove apathmax() and implicitly agetcwd() 2015-03-18 15:20:35 +01:00
queue.h Use queue.h in grep(1) 2014-11-16 12:39:15 +00:00
readlink.1 Audit readlink(1) 2015-03-20 22:14:31 +01:00
readlink.c Audit readlink(1) 2015-03-20 22:14:31 +01:00
README POSIX 2013 audit 2015-03-27 17:25:22 +01:00
renice.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
renice.c Audit renice(1) 2015-03-17 22:15:09 +01:00
rm.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
rm.c Refactor recurse() again 2015-03-19 01:08:19 +01:00
rmdir.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
rmdir.c Add argv0 to usage() in rmdir.c 2015-03-02 16:24:08 +01:00
sed.1 add find.1, sed.1, time.1 stubs 2015-02-28 13:46:20 +01:00
sed.c sed: declare functions and global vars static (some still missing) 2015-03-27 16:20:50 +01:00
seq.1 Audit seq(1) 2015-03-20 16:05:31 +01:00
seq.c Reorder variables in seq(1) 2015-03-20 16:37:29 +01:00
setsid.1 Finish up setsid(1) 2015-02-01 00:47:32 +01:00
setsid.c fork: no need to _exit() on the error case 2015-03-10 20:05:18 +01:00
sha1.h Add crypt.[ch] and update md5sum and sha1sum 2013-07-18 09:51:17 -04:00
sha1sum.1 Update *sum(1)-manpages and mark them as finished and audited 2015-03-01 22:59:20 +01:00
sha1sum.c Refactor cryptcheck() to allow multiple list-files and stdin 2015-03-01 22:51:52 +01:00
sha256.h Add sha256sum(1) 2013-07-20 13:20:16 -04:00
sha256sum.1 Update *sum(1)-manpages and mark them as finished and audited 2015-03-01 22:59:20 +01:00
sha256sum.c Refactor cryptcheck() to allow multiple list-files and stdin 2015-03-01 22:51:52 +01:00
sha512.h Add sha512sum(1) 2013-08-04 11:00:34 -04:00
sha512sum.1 Update *sum(1)-manpages and mark them as finished and audited 2015-03-01 22:59:20 +01:00
sha512sum.c Refactor cryptcheck() to allow multiple list-files and stdin 2015-03-01 22:51:52 +01:00
sleep.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
sleep.c Audit sleep(1) 2015-02-28 20:10:25 +01:00
sort.1 Add -m and -o flags to sort(1) 2015-03-22 23:39:48 +01:00
sort.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
split.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
split.c Audit split(1) 2015-03-17 22:59:48 +01:00
sponge.1 Refactor sponge(1) code and manpage 2015-02-08 22:17:21 +01:00
sponge.c Audit sponge(1) 2015-03-01 23:42:16 +01:00
strings.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
strings.c Audit strings(1) 2015-03-17 23:05:50 +01:00
sync.1 Refactor sync(1) code and manpage 2015-02-08 22:08:14 +01:00
sync.c fix some signed/unsigned warnings and style fixes 2015-03-27 22:48:05 +01:00
tail.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
tail.c tail: allow tail -n 0 or tail -0 2015-03-30 21:24:46 +02:00
tar.1 Audit tar(1), add DIRFIRST-flag to recurse() 2015-03-21 01:30:47 +01:00
tar.c Show usage() when filtermode is given for tar-creation 2015-03-21 14:04:49 +01:00
tee.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
tee.c Audit tee(1) 2015-03-04 23:05:11 +01:00
test.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
test.c Audit test(1) 2015-03-17 23:35:11 +01:00
text.h Use size_t for number of lines in linebuf 2015-01-31 22:49:43 +00:00
time.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
time.c fork: no need to _exit() on the error case 2015-03-10 20:05:18 +01:00
TODO Add command(1) to TODO 2015-04-03 16:54:46 +01:00
touch.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
touch.c Audit touch(1) 2015-03-17 23:38:09 +01:00
tr.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
tr.c tail: allow tail -n 0 or tail -0 2015-03-30 21:24:46 +02:00
true.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
true.c Simplify true(1) and false(1) 2014-10-03 00:03:08 +01:00
tty.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
tty.c Audit tty(1) 2015-02-28 19:59:34 +01:00
uname.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uname.c Clean up #includes 2015-02-14 21:12:23 +01:00
unexpand.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
unexpand.c fix some signed/unsigned warnings and style fixes 2015-03-27 22:48:05 +01:00
uniq.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uniq.c whitespace fixes 2015-03-27 22:48:05 +01:00
unlink.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
unlink.c Audit unlink(1) 2015-02-28 20:05:22 +01:00
utf.h Scrap chartorunearr(), introducing utftorunestr() 2015-02-11 21:32:09 +01:00
util.h Remove apathmax() and implicitly agetcwd() 2015-03-18 15:20:35 +01:00
uudecode.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uudecode.c Check getline()-return-values properly 2015-03-27 14:49:48 +01:00
uuencode.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uuencode.c Audit uuencode(1) 2015-03-18 00:14:56 +01:00
wc.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
wc.c wc: Show line/char/word count even if it's zero 2015-04-01 11:06:47 +01:00
xargs.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
xargs.c xargs: minor optimizations 2015-03-27 22:48:05 +01:00
yes.1 Finish up yes(1) by adding multiple string support 2015-02-01 02:13:47 +01:00
yes.c Make already audited tools argv-centric instead of argc-centric 2015-03-02 14:19:26 +01:00

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:

'#'  -> UTF-8 support, '=' -> Implicit UTF-8 support, '*' -> Finished,
'|'  -> Audited,       'o' -> POSIX 2013 compliant,   'x' -> Non-POSIX,
'()' -> Petty flag

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

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/