suckless unix tools
Go to file
Jakob Kramer 7f7e7dcbb9 cols: simplify filling with spaces
Use printf("%*s", n, "") instead of allocating
a string filled with spaces.
2014-06-05 11:19:34 +01:00
util remove afgets 2014-06-01 18:03:20 +01:00
LICENSE Switching to real name 2014-05-11 11:04:26 +01:00
Makefile remove afgets 2014-06-01 18:03:20 +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 code style 2014-06-01 18:02:30 +01:00
cal.1 Make date(1) compatible to GNU date(1). 2013-06-19 22:10:26 +02:00
cal.c code style 2014-06-01 18:02:30 +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 code style 2014-06-01 18:02:30 +01:00
cksum.1 cksum: error check 2011-06-10 04:36:40 +01:00
cksum.c code style 2014-06-01 18:02:30 +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 cols: simplify filling with spaces 2014-06-05 11:19:34 +01:00
comm.1 Add comm 2013-06-19 20:00:10 +02:00
comm.c code style 2014-06-01 18:02:30 +01:00
config.mk Use -std=c99 by default 2014-05-31 17:56:34 +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 cut: improvements 2014-06-01 18:02:13 +01:00
date.1 Add -u option to date (POSIX and Plan 9, and useful) 2012-04-23 08:32:24 -07:00
date.c code style 2014-06-01 18:02:30 +01:00
dirname.1 add tail 2011-05-26 16:18:42 -01:00
dirname.c code style 2014-06-01 18:02:30 +01:00
du.1 Update usage line and manpage for du(1) 2013-10-17 11:27:42 +01:00
du.c check snprintf error aswell, handle as truncation error 2014-06-01 18:02:55 +01:00
echo.1 initial commit 2011-05-23 02:36:34 +01:00
echo.c code style 2014-06-01 18:02:30 +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 code style 2014-06-01 18:02:30 +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 use agetline instead of agets 2014-06-01 18:03:10 +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 grep: improvements 2014-06-01 18:02:01 +01:00
head.1 add tail 2011-05-26 16:18:42 -01:00
head.c use agetline instead of agets 2014-06-01 18:03:10 +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 code style 2014-06-01 18:02:30 +01:00
ln.1 ln -f 2011-06-04 02:56:18 +01:00
ln.c code style 2014-06-01 18:02:30 +01:00
ls.1 add the man entry for ls -F 2014-02-19 12:35:36 +00:00
ls.c code style 2014-06-01 18:02:30 +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 code style 2014-06-01 18:02:30 +01:00
mkfifo.1 Implement -m for mkfifo(1) 2013-11-30 20:58:15 +00:00
mkfifo.c code style 2014-06-01 18:02:30 +01:00
mktemp.1 Forgot to update manpage for mktemp(1) 2013-11-14 19:50:07 +00:00
mktemp.c check snprintf error aswell, handle as truncation error 2014-06-01 18:02:55 +01:00
mv.1 Support -f for mv 2013-10-05 13:51:45 +01:00
mv.c code style 2014-06-01 18:02:30 +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 code style 2014-06-01 18:02:30 +01:00
nl.1 nl: tweak manpage 2011-06-11 00:29:06 +01:00
nl.c use agetline instead of agets 2014-06-01 18:03:10 +01:00
nohup.1 nohup: tweak manpage 2011-06-18 14:42:06 +01:00
nohup.c code style 2014-06-01 18:02:30 +01: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 code style 2014-06-01 18:02:30 +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 code style 2014-06-01 18:02:30 +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 code style 2014-06-01 18:02:30 +01:00
rm.1 Add -R as a synonym to -r for rm(1) 2013-12-12 13:15:47 +00:00
rm.c code style 2014-06-01 18:02:30 +01: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 add agetline, separate estrtod to util 2014-06-01 18:01:45 +01: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 code style 2014-06-01 18:02:30 +01:00
sort.1 add -t flag to sort 2014-06-02 13:35:59 +01:00
sort.c add -t flag to sort 2014-06-02 13:35:59 +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 use agetline instead of agets 2014-06-01 18:03:10 +01: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 code style 2014-06-01 18:02:30 +01:00
tee.1 initial commit 2011-05-23 02:36:34 +01:00
tee.c remove unnecessary calls to realloc from tee 2014-06-03 23:46:17 +01:00
test.1 Update manpage for binary operations in test(1) 2013-11-11 12:01:47 +00:00
test.c code style 2014-06-01 18:02:30 +01:00
text.h remove afgets 2014-06-01 18:03:20 +01:00
touch.1 add mkdir 2011-05-26 05:47:58 +01:00
touch.c code style 2014-06-01 18:02:30 +01:00
tr.1 Update tr.1 man page 2014-04-27 11:42:10 +01:00
tr.c use agetline instead of agets 2014-06-01 18:03:10 +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 code style 2014-06-01 18:02:30 +01:00
uniq.1 uniq: WTFM 2012-05-21 23:46:22 +00:00
uniq.c use agetline instead of agets 2014-06-01 18:03:10 +01: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 add agetline, separate estrtod to util 2014-06-01 18:01:45 +01:00
uudecode.1 Initial commit of the uudecode tool and man page 2014-02-02 20:50:31 +00:00
uudecode.c use agetline instead of agets 2014-06-01 18:03:10 +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 code style 2014-06-01 18:02:30 +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/