Mirror of Suckless' sbase (git://git.suckless.org/sbase)
Go to file
FRIGN 9016d288f1 Do not use arg.h for tools which take no flags
We've already seen the issue with echo(1): Before we changed it to
ignore "--", the command

$ echo --

did not work as expected. Given POSIX mandated this and makes most
sense, in the interest of consistency the other tools need to be
streamlined for that as well.
Looking at yes(1) for instance, there's no reason to skip "--" in
the argument list.
We do not have long options like GNU does and there's no reason to
tinker with that here.

The majority of tools changed are ones taking lists of arguments
or only a single one. There's no reason why dirname should "fail"
on "--". In the end, this is a valid name.

The practice of hand-holding the user was established with the GNU
coreutils. "--help" and "--version" long-options are a disgrace to
what could've been done properly with manpages.
2015-04-25 11:43:14 +01:00
libutf Add mkrunetype.awk 2015-02-23 20:36:47 +01:00
libutil Actually print <space> to stream in putword() too 2015-04-21 18:00:47 +01:00
LICENSE Add join(1) 2015-04-20 11:24:12 +01:00
Makefile Move mkdirp() to libutil 2015-04-20 18:04:08 +01:00
README Add join(1) 2015-04-20 11:24:12 +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 Add join(1) 2015-04-20 11:24:12 +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 Add *fshut() functions to properly flush file streams 2015-04-05 09:13:56 +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(1): Show an error when classes and non-classes are mixed 2015-04-20 20:41:11 +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 Update putword() to accept a FILE * 2015-04-21 18:00:47 +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
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          .
=*|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/