suckless unix tools
Go to file
Hiltjo Posthuma 5b3a0a9382 build warnings: initialise values...
... to make fix gcc warnings with -Wall.

Signed-off-by: Hiltjo Posthuma <hiltjo@codemadness.org>
2014-05-12 12:06:14 +01:00
util Chop one level of indentation 2014-05-05 15:12:20 +01:00
LICENSE Switching to real name 2014-05-11 11:04:26 +01:00
Makefile make parsemode() generic 2014-04-09 15:40:32 +01:00
README Update README 2014-02-27 16:56:59 +00:00
TODO update TODO file 2014-04-12 20:33:50 +01:00
arg.h Rename __ARG_H__ to ARG_H__ 2013-11-25 21:29:20 +00:00
basename.1 Moving back to the stone age. 2012-04-23 16:32:41 +02:00
basename.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
cal.1 Make date(1) compatible to GNU date(1). 2013-06-19 22:10:26 +02:00
cal.c style: whitespace fixes 2014-04-01 16:20:43 +01:00
cat.1 add sleep & date, thanks kamil 2011-05-23 19:00:31 +01:00
cat.c minor style changes 2014-04-22 13:46:19 +01:00
chgrp.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
chgrp.c Fix char **argv to char *argv[] 2014-04-18 11:54:44 +01:00
chmod.1 Add sticky bit to documentation. 2013-10-20 10:41:32 +01:00
chmod.c chmod: process file series behaviour 2014-04-24 11:51:43 +01:00
chown.1 chmod, chown: remove redundant flag 2012-05-25 21:52:01 +01:00
chown.c chown: return EXIT_FAILURE if one file failed. 2014-04-24 11:51:54 +01:00
chroot.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
chroot.c keep usage definition above main 2014-04-22 13:46:33 +01:00
cksum.1 cksum: error check 2011-06-10 04:36:40 +01:00
cksum.c use always static for usage and keep usage definition above main 2014-04-22 14:49:23 +01:00
cmp.1 update some man pages 2014-04-12 20:33:33 +01:00
cmp.c cmp: suppress file open error with sflag 2014-04-09 15:40:44 +01:00
cols.1 Rename mc(1) to cols(1) 2014-03-12 14:47:38 +00:00
cols.c Rename mc(1) to cols(1) 2014-03-12 14:47:38 +00:00
comm.1 Add comm 2013-06-19 20:00:10 +02:00
comm.c Rename variable `dif' to `diff' in comm(1) 2014-04-04 11:06:30 +01:00
config.mk Add -D_GNU_SOURCE to config.mk for tcc 2014-04-29 22:31:16 +01:00
cp.1 Implement cp -f 2014-05-05 15:02:03 +01:00
cp.c Implement cp -f 2014-05-05 15:02:03 +01:00
crypt.h checksum tools: implement -c 2014-03-23 18:02:39 +00:00
cut.1 Add cut(1) 2013-10-08 20:41:32 +01:00
cut.c Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00:00
date.1 Add -u option to date (POSIX and Plan 9, and useful) 2012-04-23 08:32:24 -07:00
date.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
dirname.1 add tail 2011-05-26 16:18:42 -01:00
dirname.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
du.1 Update usage line and manpage for du(1) 2013-10-17 11:27:42 +01:00
du.c use always static for usage and keep usage definition above main 2014-04-22 14:49:23 +01:00
echo.1 initial commit 2011-05-23 02:36:34 +01:00
echo.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
env.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
env.c use always static for usage and keep usage definition above main 2014-04-22 14:49:23 +01:00
expand.1 Add expand(1) 2013-06-19 20:01:10 +02:00
expand.c Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00:00
false.1 initial commit 2011-05-23 02:36:34 +01:00
false.c initial commit 2011-05-23 02:36:34 +01:00
fold.1 fold: clarify utf8 behaviour in manpage 2012-05-25 21:51:24 +01:00
fold.c minor style changes 2014-04-22 13:46:19 +01:00
fs.h Implement cp -f 2014-05-05 15:02:03 +01:00
grep.1 Implement -e support for grep 2013-10-05 13:51:45 +01:00
grep.c Declare error buffer at start of block 2014-05-12 00:40:29 +01:00
head.1 add tail 2011-05-26 16:18:42 -01:00
head.c minor style changes 2014-04-22 13:46:19 +01:00
hostname.1 Add hostname(1) 2013-10-05 14:58:55 +01:00
hostname.c Fix wrong length for sethostname() 2014-02-14 15:13:20 +00:00
kill.1 touch: posix open 2011-06-18 06:43:10 +01:00
kill.c kill: argc < 2 should be argc < 1 2014-03-07 18:56:32 +00:00
ln.1 ln -f 2011-06-04 02:56:18 +01:00
ln.c Simplify ln(1) 2014-02-17 11:44:18 +00:00
ls.1 add the man entry for ls -F 2014-02-19 12:35:36 +00:00
ls.c Don't bail out if the username/group name does not exist in ls(1) 2014-04-05 20:23:40 +01:00
md5.h Add crypt.[ch] and update md5sum and sha1sum 2013-07-18 09:51:17 -04:00
md5sum.1 update some man pages 2014-04-12 20:33:33 +01:00
md5sum.c Support reading checksums from stdin 2014-05-05 10:05:48 +01:00
mkdir.1 Implement -m option for mkdir 2013-10-05 13:51:45 +01:00
mkdir.c Make mkdir read mode argument as octal. 2013-10-20 10:41:31 +01:00
mkfifo.1 Implement -m for mkfifo(1) 2013-11-30 20:58:15 +00:00
mkfifo.c Implement -m for mkfifo(1) 2013-11-30 20:58:15 +00:00
mktemp.1 Forgot to update manpage for mktemp(1) 2013-11-14 19:50:07 +00:00
mktemp.c Break long line in mktemp(1) 2014-05-02 21:38:40 +01:00
mv.1 Support -f for mv 2013-10-05 13:51:45 +01:00
mv.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
nice.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
nice.c keep usage definition above main 2014-04-22 13:46:33 +01:00
nl.1 nl: tweak manpage 2011-06-11 00:29:06 +01:00
nl.c Fix indentation 2013-11-14 19:00:52 +00:00
nohup.1 nohup: tweak manpage 2011-06-18 14:42:06 +01:00
nohup.c Remove unnecessary exit(1) in usage() 2013-06-19 19:58:19 +02:00
paste.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
paste.c style: whitespace fixes 2014-04-01 16:20:43 +01:00
printenv.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
printenv.c Fix char **argv to char *argv[] 2014-04-18 11:54:44 +01:00
pwd.1 pwd -LP 2011-05-28 15:37:42 +01:00
pwd.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
readlink.1 Add readlink 2013-06-16 07:46:01 +02:00
readlink.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
renice.1 renice(1): renice is not PASTE 2014-05-06 16:21:56 +01:00
renice.c keep usage definition above main 2014-04-22 13:46:33 +01:00
rm.1 Add -R as a synonym to -r for rm(1) 2013-12-12 13:15:47 +00:00
rm.c Add -R as a synonym to -r for rm(1) 2013-12-12 13:15:47 +00:00
rmdir.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
rmdir.c Fix char **argv to char *argv[] 2014-04-18 11:54:44 +01:00
seq.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
seq.c Use estrtol() instead of atoi() 2013-10-27 09:49:08 +00:00
setsid.1 Add setsid(1) by arg 2013-10-05 14:58:55 +01:00
setsid.c Ensure we return a proper error value in setsid(1) 2014-01-27 15:18:30 +00:00
sha1.h Add crypt.[ch] and update md5sum and sha1sum 2013-07-18 09:51:17 -04:00
sha1sum.1 update some man pages 2014-04-12 20:33:33 +01:00
sha1sum.c Support reading checksums from stdin 2014-05-05 10:05:48 +01:00
sha256.h Add sha256sum(1) 2013-07-20 13:20:16 -04:00
sha256sum.1 update some man pages 2014-04-12 20:33:33 +01:00
sha256sum.c Support reading checksums from stdin 2014-05-05 10:05:48 +01:00
sha512.h Add sha512sum(1) 2013-08-04 11:00:34 -04:00
sha512sum.1 update some man pages 2014-04-12 20:33:33 +01:00
sha512sum.c Support reading checksums from stdin 2014-05-05 10:05:48 +01:00
sleep.1 update manpages 2011-05-25 18:29:46 +01:00
sleep.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
sort.1 sort: add support for "per-keydef" flags 2014-05-06 16:21:50 +01:00
sort.c sort: simplify linecmp, rename curr => tail 2014-05-06 18:01:44 +01:00
split.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
split.c build warnings: initialise values... 2014-05-12 12:06:14 +01:00
sponge.1 actually add the .c and .1 files 2013-07-02 13:26:24 -04:00
sponge.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
strings.1 Allow strings(1) to operate on more than one file 2013-10-10 16:05:05 +01:00
strings.c Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00:00
sync.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
sync.c Fix char **argv to char *argv[] 2014-04-18 11:54:44 +01:00
tail.1 fix typo 2011-05-27 00:54:10 +01:00
tail.c Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00:00
tar.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
tar.c Only use major()/minor() if they are available in tar(1) 2014-01-30 16:17:25 +00:00
tee.1 initial commit 2011-05-23 02:36:34 +01:00
tee.c Free allocated memory 2013-10-11 17:02:58 +01:00
test.1 Update manpage for binary operations in test(1) 2013-11-11 12:01:47 +00:00
test.c use always static for usage and keep usage definition above main 2014-04-22 14:49:23 +01:00
text.h sort: Librarify getlines() 2012-05-21 21:09:38 +00:00
touch.1 add mkdir 2011-05-26 05:47:58 +01:00
touch.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
tr.1 Update tr.1 man page 2014-04-27 11:42:10 +01:00
tr.c Wrap mbtowc to check for errors 2014-04-12 21:29:16 +01:00
true.1 initial commit 2011-05-23 02:36:34 +01:00
true.c initial commit 2011-05-23 02:36:34 +01:00
tty.1 add tty 2011-06-02 21:15:35 +01:00
tty.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
uname.1 fix manpages 2011-06-02 20:38:48 +01:00
uname.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
uniq.1 uniq: WTFM 2012-05-21 23:46:22 +00:00
uniq.c Fix naming covention for uniq(1) 2014-01-20 10:49:28 +00:00
unlink.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
unlink.c Fix char **argv to char *argv[] 2014-04-18 11:54:44 +01:00
util.h parsemode: rework 2014-04-24 11:51:33 +01:00
uudecode.1 Initial commit of the uudecode tool and man page 2014-02-02 20:50:31 +00:00
uudecode.c parsemode: rework 2014-04-24 11:51:33 +01:00
uuencode.1 Add uuencode(1) 2014-01-31 15:29:11 +00:00
uuencode.c Use printf() instead of fprintf() in uuencode(1) 2014-01-31 15:55:38 +00:00
wc.1 getopt 2011-05-24 01:13:34 +01:00
wc.c If there's no newline we don't count the last word - fix it 2014-01-10 22:52:00 +00:00
xargs.1 update some man pages 2014-04-12 20:33:33 +01:00
xargs.c build warnings: initialise values... 2014-05-12 12:06:14 +01:00
yes.1 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
yes.c use always static for usage and keep usage definition above main 2014-04-22 14:49:23 +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 programs are currently implemented:

    basename cal  cat chgrp chmod chown  chroot cksum cmp comm  cp cut
    date dirname du  echo env expand false fold grep  head hostname id
    kill ln  ls mc md5sum mkdir  mkfifo mktemp mv nice  nl nohup paste
    printenv  pwd readlink  renice rm  rmdir sleep  setsid sort  split
    sponge strings sync  tail tar tee test touch tr  true tty uudecode
    uuencode  uname uniq  unlink  seq sha1sum  sha256sum sha512sum  wc
    xargs yes

sbase is mostly following POSIX but we deviate wherever we think it is
appropriate.

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.

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.

sbase  also compiles  and runs  on minix3  with slight  modifications.
They do  not provide mmap()/munmap()  so you need to  use minix_mmap()
and minix_munmap() respectively.

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/