Mirror of Suckless' sbase (git://git.suckless.org/sbase)
Go to file
FRIGN 0545d32ce9 Handle '-' consistently
In general, POSIX does not define /dev/std{in, out, err} because it
does not want to depend on the dev-filesystem.
For utilities, it thus introduced the '-'-keyword to denote standard
input (and output in some cases) and the programs have to deal with
it accordingly.

Sadly, the design of many tools doesn't allow strict shell-redirections
and many scripts don't even use this feature when possible.

Thus, we made the decision to implement it consistently across all
tools where it makes sense (namely those which read files).

Along the way, I spotted some behavioural bugs in libutil/crypt.c and
others where it was forgotten to fshut the files after use.
2015-05-16 13:34:00 +01:00
libutf Add mkrunetype.awk 2015-02-23 20:36:47 +01:00
libutil Handle '-' consistently 2015-05-16 13:34:00 +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
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 Handle '-' consistently 2015-05-16 13:34:00 +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
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 Handle '-' consistently 2015-05-16 13:34:00 +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 Handle '-' consistently 2015-05-16 13:34:00 +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 Handle '-' consistently 2015-05-16 13:34:00 +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 include stdint.h for SIZE_MAX 2015-04-29 22:25:03 +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 Handle '-' consistently 2015-05-16 13:34:00 +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
find.1 add find.1, sed.1, time.1 stubs 2015-02-28 13:46:20 +01:00
find.c find: Allow using multiple paths 2015-05-15 12:07:43 +01:00
fold.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
fold.c Handle '-' consistently 2015-05-16 13:34:00 +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 Handle '-' consistently 2015-05-16 13:34:00 +01:00
head.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
head.c Handle '-' consistently 2015-05-16 13:34:00 +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 join manpage: Fix spelling 2015-05-05 10:53:42 +01:00
join.c Handle '-' consistently 2015-05-16 13:34:00 +01:00
kill.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
kill.c kill: Include strings.h for strcasecmp() 2015-04-29 16:42:49 +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 ln: exit non-zero when errors accured 2015-05-08 10:06:58 +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 ls: fix option -S for it to work without -lnpFi 2015-05-15 12:07:43 +01:00
md5.h
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 mktemp improvements 2015-05-10 12:58:38 +01:00
mktemp.c mktemp improvements 2015-05-10 12:58:38 +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 Handle '-' consistently 2015-05-16 13:34:00 +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 Handle '-' consistently 2015-05-16 13:34:00 +01:00
printenv.1
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 flag support to printf(1) 2015-04-27 19:33:57 +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
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 Handle '-' consistently 2015-05-16 13:34:00 +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
setsid.c Do not use arg.h for tools which take no flags 2015-04-25 11:43:14 +01:00
sha1.h
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
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
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 Handle '-' consistently 2015-05-16 13:34:00 +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 Handle '-' consistently 2015-05-16 13:34:00 +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 Handle '-' consistently 2015-05-16 13:34:00 +01:00
tar.1 Clarify that compression is now supported in tar.1 2015-05-08 15:56:21 +01:00
tar.c tar: compatibility, treat reserved type as regular file 2015-05-10 12:58:38 +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
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
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 Handle '-' consistently 2015-05-16 13:34:00 +01:00
uniq.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uniq.c Handle '-' consistently 2015-05-16 13:34:00 +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 Use off_t in humansize() as it is more descriptive and applicable 2015-04-29 16:42:49 +01:00
uudecode.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uudecode.c Handle '-' consistently 2015-05-16 13:34:00 +01:00
uuencode.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
uuencode.c Handle '-' consistently 2015-05-16 13:34:00 +01:00
wc.1 POSIX 2013 audit 2015-03-27 17:25:22 +01:00
wc.c Handle '-' consistently 2015-05-16 13:34:00 +01:00
which.1 Refactor and audit which(1) 2015-04-27 19:33:57 +01:00
which.c which: Add LICENSE header 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
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/