FRIGN b83916ca27 Add symbol to mark NUL handling in each tool (and where it is missing)
The assumption of NUL-terminated strings is actually quite a good one in
most cases. You don't have to worry about paths, because they may not
contain NUL.
Same applies to arguments passed to you. Unless you have to unescape,
there is no way for you to receive a NUL.

There are two important exceptions though, and it's important that we
address them, or else we get unexpected behaviour:

	1) All tools using unescape() have to be strict about delimlen.
	   Else they end up for instance unescaping
	   	'\\0abc'
	   to
	   	'\0abc',
	   which in C's string-vision is an empty string.

	2) All tools doing line wrenching and putting them out
	   again as lines again.
	   puts() will cut each line containing NULs off at the first
	   occurence.
2016-02-26 09:54:46 +00:00
2015-02-23 20:36:47 +01:00
2016-02-20 08:23:57 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-21 10:20:07 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-10-08 17:15:08 +02:00
2015-04-20 11:12:40 +01:00
2015-12-21 19:07:51 +00:00
2015-12-21 19:07:51 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2014-11-17 15:46:28 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-06 11:01:00 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-26 10:35:46 +00:00
2015-10-08 17:15:08 +02:00
2015-12-14 12:14:52 +00:00
2015-10-08 17:15:08 +02:00
2015-11-06 10:52:49 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-05-26 16:41:43 +01:00
2015-10-08 17:15:08 +02:00
2014-10-03 00:03:08 +01:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-12-21 14:13:36 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-04-20 11:12:40 +01:00
2015-10-10 01:18:24 +02:00
2015-12-15 08:45:39 +00:00
2015-10-08 17:15:08 +02:00
2016-01-20 17:27:35 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2016-02-15 09:42:59 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-10-08 17:15:08 +02:00
2015-11-06 10:18:56 +00:00
2015-11-06 10:18:56 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-06-22 20:03:55 +01:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2014-11-16 12:39:15 +00:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2016-02-24 10:15:16 +00:00
2016-02-24 10:15:16 +00:00
2016-02-24 10:15:16 +00:00
2013-07-20 13:20:16 -04:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2016-02-24 10:15:16 +00:00
2016-02-24 10:15:16 +00:00
2016-02-24 10:15:16 +00:00
2013-08-04 11:00:34 -04:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2016-02-17 08:43:15 +00:00
2016-02-16 09:56:48 +00:00
2015-10-08 17:15:08 +02:00
2015-11-26 10:35:46 +00:00
2015-10-08 17:15:08 +02:00
2015-05-26 16:41:43 +01:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2016-02-15 10:20:12 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-03-17 23:35:11 +01:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-26 10:35:46 +00:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2014-10-03 00:03:08 +01:00
2016-02-24 15:57:33 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-10-08 17:15:08 +02:00
2015-11-01 10:18:55 +00:00
2015-10-08 17:15:08 +02:00
2016-02-24 14:45:20 +00:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2015-12-14 10:14:07 +00:00
2015-10-08 17:15:08 +02:00
2015-12-21 18:07:25 +00:00
2016-02-18 10:56:42 +00:00
2015-10-08 17:15:08 +02: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,
'0'  -> NUL handling,  '()' -> Petty flag

     UTILITY         MISSING
     -------         -------
0=*|o basename        .
0=*|o cal             .
0=*|o cat             .
0=*|o chgrp           .
0=*|o chmod           .
0=*|o chown           .
0=*|x chroot          .
0=*|o cksum           .
0=*|o cmp             .
 #*|x cols            .
 =*|o comm            .
0=*|o cp              (-i)
0=*|x cron            .
 #*|o cut             .
0=*|o date            .
0=*|o dirname         .
0=*|o du              .
0=*|o echo            .
    o ed              .
0=*|o env             .
0#*|o expand          .
0#*|o expr            .
0=*|o false           .
0=    find            .
0=* x flock           .
 #*|o fold            .
0=*|o getconf         (-v)
 =*|o grep            .
 =*|o head            .
0=*|x hostname        .
0=*|x install         .
 =* o join            .
0=*|o kill            .
0=*|o link            .
0=*|o ln              .
 =*|o logger          .
0=*|o logname         .
0#* o ls              (-C, -k, -m, -p, -s, -x)
0=*|x md5sum          .
0=*|o mkdir           .
0=*|o mkfifo          .
0=*|x mktemp          .
0=*|o mv              (-i)
0=*|o nice            .
 #*|o nl              .
0=*|o nohup           .
0=*|o od              .
0#* o pathchk         .
 #*|o paste           .
0=*|x printenv        .
0#*|o printf          .
0=*|o pwd             .
0=*|x readlink        .
0=*|o renice          .
0=*|o rm              (-i)
0=*|o rmdir           .
 #    sed             .
0=*|x seq             .
0=*|x setsid          .
0=*|x sha1sum         .
0=* x sha224sum       .
0=*|x sha256sum       .
0=* x sha238sum       .
0=*|x sha512sum       .
0=* x sha512-224sum   .
0=* x sha512-256sum   .
0=*|o sleep           .
 #*|o sort            .
0=*|o split           .
0=*|x sponge          .
0#*|o strings         .
0=*|x sync            .
 =*|o tail            .
0=*|x tar             .
0=*|o tee             .
0=*|o test            .
0=*|x tftp            .
0=*|o time            .
0=*|o touch           .
0#*|o tr              .
0=*|o true            .
0=* o tsort           .
0=*|o tty             .
0=*|o uname           .
0#*|o unexpand        .
 =*|o uniq            .
0=*|o unlink          .
0=*|o uudecode        .
0=*|o uuencode        .
0#*|o wc              .
0=*|x which           .
0=*|x whoami          .
 =*|o xargs           (-p)
0=*|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/
Description
Languages
C 79.5%
Roff 16%
Shell 1.9%
Awk 1.3%
Makefile 1.3%