suckless unix tools
Go to file
sin b712ef44ad Fix warning 'array subscript of type char' 2014-09-02 13:32:32 +01:00
util cp: print error to stderr and continue 2014-08-02 13:46:00 +01:00
LICENSE Add unexpand(1) 2014-06-09 17:00:13 +01:00
Makefile Add unexpand(1) 2014-06-09 17:00:13 +01:00
README Fixup README 2014-07-26 15:46:33 +01:00
TODO Add at(1) to TODO 2014-07-07 07:37:19 +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 fixed incorrect fday handling in dayofweek() function 2014-07-04 21:47:36 +01:00
cat.1 add sleep & date, thanks kamil 2011-05-23 19:00:31 +01:00
cat.c Use /dev/fd/0 as opposed to /dev/stdin 2014-07-04 23:14:26 +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 chown: update usage 2014-07-21 16:43:54 +01:00
chown.c chown: update usage 2014-07-21 16:43: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 cp: add -v, fix manpage info 2014-07-21 16:43:31 +01:00
cp.c cp: improvements 2014-07-21 16:44:26 +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 No need to include unistd.h in echo(1) 2014-06-25 21:27:53 +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 Implement -i flag for expand 2014-06-09 17:00:33 +01:00
expand.c Implement -i flag for expand 2014-06-09 17:00:33 +01: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 Fix warning 'array subscript of type char' 2014-09-02 13:32:32 +01:00
fs.h cp: improvements 2014-07-21 16:44:26 +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 ln: allow with one argument 2014-07-21 16:44:06 +01:00
ls.1 add the man entry for ls -F 2014-02-19 12:35:36 +00:00
ls.c ls: improve default format 2014-07-21 16:44:15 +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 Only use /tmp if template is a file and not a path 2014-07-04 16:02:15 +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 A plain rm -f is valid and should not be considered an error 2014-07-04 14:55:45 +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 Refactor rmdir 2014-06-10 11:14:32 +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 Fix warning 'array subscript of type char' 2014-09-02 13:32:32 +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 Fix warning 'array subscript of type char' 2014-09-02 13:32:32 +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 Improved tr 2014-07-16 20:40:54 +01:00
tr.c Fix comment style and nuke stray whitespace 2014-07-16 20:43:29 +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
unexpand.1 Add unexpand(1) 2014-06-09 17:00:13 +01:00
unexpand.c Add unexpand(1) 2014-06-09 17:00:13 +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 util.h, mode_t: sys/types.h defines mode_t 2014-06-16 23:04:43 +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
cols
comm
cp
cut
date
dirname
du
echo
env
expand
false
fold
grep
head
hostname
kill
ln
ls
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
unexpand
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/