Mirror of Suckless' sbase (git://git.suckless.org/sbase)
Go to file
FRIGN b333176b8c Refactor and audit which(1)
Use the *at functions instead of building paths manually. We do
still have path-building in recurse() and other areas, but the
long-term goal is to rid most interfaces of that for practical
and security reasons.
In this case, it's more or less trivial.

Also, refactor the manpage to be more consistent with the others.

BUGFIX: Return exit status 3 on error.
2015-04-27 19:33:57 +01:00
libutf Add mkrunetype.awk 2015-02-23 20:36:47 +01:00
libutil Convert humansize() to accept a size_t instead of a double 2015-04-25 11:43:14 +01:00
LICENSE Add join(1) 2015-04-20 11:24:12 +01:00
Makefile add which 2015-04-27 16:58:42 +01:00
README Refactor and audit which(1) 2015-04-27 19:33:57 +01:00
TODO Add join(1) 2015-04-20 11:24:12 +01: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 Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
cal.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cal.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
cat.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cat.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
chgrp.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
chgrp.c Add maxdepth to recurse() 2015-04-20 11:12:40 +01:00
chmod.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
chmod.c Add maxdepth to recurse() 2015-04-20 11:12:40 +01:00
chown.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
chown.c Add maxdepth to recurse() 2015-04-20 11:12:40 +01:00
chroot.1 Finish up chroot(1) and md5sum(1) 2015-01-31 23:54:51 +01:00
chroot.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
cksum.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cksum.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
cmp.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cmp.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
col.1 col: buffer 128 lines by default 2015-03-30 21:48:26 +02:00
col.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
cols.1 Audit cols(1) 2015-03-08 19:49:59 +01:00
cols.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
comm.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
comm.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
compat.h Add compat.h 2014-11-17 15:46:28 +00:00
config.mk Fix mkdir -p with a leading / 2015-04-20 17:47:14 +01:00
cp.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
cp.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
date.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
date.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
dirname.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
dirname.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
du.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
du.c du: staticize du 2015-04-25 11:43:14 +01:00
echo.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
echo.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
env.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
env.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
expand.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
expand.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
expr.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
expr.c expr: Don't interpret any arguments 2015-04-21 17:09:20 +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 intptr_t is an optional type, use intmax_t 2015-04-14 16:42:43 +01:00
fold.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
fold.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
fs.h Add SILENT flag to recurse() 2015-04-20 11:12:40 +01:00
grep.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
grep.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
head.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
head.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
hostname.1 Audit hostname(1) 2015-02-28 21:22:55 +01:00
hostname.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
join.1 Add join(1) 2015-04-20 11:24:12 +01:00
join.c join: remove argv0, it is in arg.h 2015-04-27 16:58:42 +01:00
kill.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
kill.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
link.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
link.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
logname.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
logname.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
ls.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
ls.c Convert humansize() to accept a size_t instead of a double 2015-04-25 11:43:14 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
mkdir.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
mkdir.c Move mkdirp() to libutil 2015-04-20 18:04:08 +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 *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
mv.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
mv.c Add maxdepth to recurse() 2015-04-20 11:12:40 +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 small issue in nl(1) 2015-04-05 09:13:56 +01:00
nohup.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
nohup.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
paste.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
paste.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
printenv.1 Finish up printenv(1) 2015-02-01 00:23:38 +01:00
printenv.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
printf.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
printf.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
pwd.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
pwd.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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 Add SILENT flag to recurse() 2015-04-20 11:12:40 +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: use reallocarray (non-issue) 2015-04-17 19:01:02 +01:00
seq.1 Audit seq(1) 2015-03-20 16:05:31 +01:00
seq.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
setsid.1 Finish up setsid(1) 2015-02-01 00:47:32 +01:00
setsid.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
sleep.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
sleep.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
sort.1 Add -m and -o flags to sort(1) 2015-03-22 23:39:48 +01:00
sort.c sort: allow keys where start_col > end_col 2015-04-06 17:15:54 +01:00
split.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
split.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
sponge.1 Refactor sponge(1) code and manpage 2015-02-08 22:17:21 +01:00
sponge.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
strings.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
strings.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
sync.1 Refactor sync(1) code and manpage 2015-02-08 22:08:14 +01:00
sync.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
tail.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
tail.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
tar.1 tar: Briefly update manpage and usage for the latest changes 2015-04-21 15:43:52 +01:00
tar.c tar: Fix remove(3)-error-message 2015-04-24 10:09:26 +01:00
tee.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
tee.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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
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 tr: Fix -c option when translating 2015-04-27 17:16:37 +01: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 Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
uname.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uname.c Update putword() to accept a FILE * 2015-04-21 18:00:47 +01:00
unexpand.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
unexpand.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
uniq.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uniq.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
unlink.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
unlink.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
utf.h Scrap chartorunearr(), introducing utftorunestr() 2015-02-11 21:32:09 +01:00
util.h Convert humansize() to accept a size_t instead of a double 2015-04-25 11:43:14 +01:00
uudecode.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uudecode.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
uuencode.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uuencode.c Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +01:00
wc.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
wc.c Simplify condition in wc(1) 2015-04-20 11:26:38 +01:00
which.1 Refactor and audit which(1) 2015-04-27 19:33:57 +01:00
which.c Refactor and audit which(1) 2015-04-27 19:33:57 +01:00
xargs.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
xargs.c xargs: Don't print trailing spaces when -t is set 2015-04-21 18:00:48 +01:00
yes.1 Finish up yes(1) by adding multiple string support 2015-02-01 02:13:47 +01:00
yes.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +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:

'#'  -> 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 join        .
=*|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          .
=*|x which       .
=*|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/