suckless unix tools
Go to file
Michael Forney e1f87da43e tar: Handle archives with the prefix field
Also, handle names and prefixes that fill the entire field (and have no
NUL byte) by using a precision specifier.
2014-11-01 22:34:19 +00:00
util ls: add -h flag 2014-10-19 12:54:19 +01:00
LICENSE Introduce new test(1) implementation 2014-10-17 15:47:55 +01:00
Makefile separate humansize into a util function 2014-10-18 23:56:51 +01:00
README Remove misleading line in README 2014-10-19 13:20:51 +01:00
TODO Mention programs that were imported from OpenBSD 2014-10-21 17:50:43 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
cal.1 Make date(1) compatible to GNU date(1). 2013-06-19 22:10:26 +02:00
cal.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
cat.1
cat.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
chown.1 chown: update usage 2014-07-21 16:43:54 +01:00
chown.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
cksum.1 cksum: error check 2011-06-10 04:36:40 +01:00
cksum.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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
col.1 Import col(1) from OpenBSD with minor modifications 2014-09-29 19:52:31 +01:00
col.c Fix col(1) -f 2014-10-17 21:14:00 +01:00
cols.1 Rename mc(1) to cols(1) 2014-03-12 14:47:38 +00:00
cols.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
comm.1 Add comm 2013-06-19 20:00:10 +02:00
comm.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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
csplit.1 Import csplit(1) from OpenBSD 2014-10-16 12:22:36 +01:00
csplit.c Staticise symbols 2014-10-16 12:30:52 +01:00
cut.1 Add cut(1) 2013-10-08 20:41:32 +01:00
cut.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
dirname.1 add tail 2011-05-26 16:18:42 -01:00
dirname.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
du.1 du: add -d flag to specify the max depth to show files or directories 2014-10-18 23:57:00 +01:00
du.c du: add -d flag to specify the max depth to show files or directories 2014-10-18 23:57:00 +01:00
echo.1
echo.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
expand.1 Implement -i flag for expand 2014-06-09 17:00:33 +01:00
expand.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
expr.1 Add expr.1 2014-09-29 14:22:59 +01:00
expr.c Staticise symbols 2014-10-16 12:30:52 +01:00
false.1
false.c Simplify true(1) and false(1) 2014-10-03 00:03:08 +01:00
fold.1 fold: clarify utf8 behaviour in manpage 2012-05-25 21:51:24 +01:00
fold.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
hostname.1 Add hostname(1) 2013-10-05 14:58:55 +01:00
hostname.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
kill.1 touch: posix open 2011-06-18 06:43:10 +01:00
kill.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
link.1 Add link(1) 2014-10-17 15:36:16 +01:00
link.c Small style fix 2014-10-17 15:47:50 +01:00
ln.1 ln -f 2011-06-04 02:56:18 +01:00
ln.c Fix a completely broken ln(1) 2014-10-17 16:08:16 +01:00
logname.1 Add logname(1) 2014-10-17 15:36:27 +01:00
logname.c Small style fix 2014-10-17 15:47:50 +01:00
ls.1 ls: add -h flag 2014-10-19 12:54:19 +01:00
ls.c ls: add -h flag 2014-10-19 12:54:19 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
mkfifo.1 Implement -m for mkfifo(1) 2013-11-30 20:58:15 +00:00
mkfifo.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
mktemp.1 Forgot to update manpage for mktemp(1) 2013-11-14 19:50:07 +00:00
mktemp.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
mv.1 Support -f for mv 2013-10-05 13:51:45 +01:00
mv.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
printf.1 Add printf.1 2014-09-29 14:35:35 +01:00
printf.c Import printf(1) from OpenBSD 2014-09-28 15:12:15 +01:00
pwd.1 pwd -LP 2011-05-28 15:37:42 +01:00
pwd.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
readlink.1 Add readlink 2013-06-16 07:46:01 +02:00
readlink.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
renice.1 renice(1): renice is not PASTE 2014-05-06 16:21:56 +01:00
renice.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
rm.1 Add -R as a synonym to -r for rm(1) 2013-12-12 13:15:47 +00:00
rm.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
setsid.1 Add setsid(1) by arg 2013-10-05 14:58:55 +01:00
setsid.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01: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
sleep.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
sort.1 add -t flag to sort 2014-06-02 13:35:59 +01:00
sort.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46: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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
sponge.1 actually add the .c and .1 files 2013-07-02 13:26:24 -04:00
sponge.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
strings.1 Allow strings(1) to operate on more than one file 2013-10-10 16:05:05 +01:00
strings.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01: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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
tail.1 fix typo 2011-05-27 00:54:10 +01:00
tail.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 tar: Handle archives with the prefix field 2014-11-01 22:34:19 +00:00
tee.1
tee.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
test.1 Update manpage for binary operations in test(1) 2013-11-11 12:01:47 +00:00
test.c Introduce new test(1) implementation 2014-10-17 15:47:55 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
tr.1 Improved tr 2014-07-16 20:40:54 +01:00
tr.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
true.1
true.c Simplify true(1) and false(1) 2014-10-03 00:03:08 +01:00
tty.1 add tty 2011-06-02 21:15:35 +01:00
tty.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
uname.1 fix manpages 2011-06-02 20:38:48 +01:00
uname.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
unexpand.1 Add unexpand(1) 2014-06-09 17:00:13 +01:00
unexpand.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
uniq.1 uniq: WTFM 2012-05-21 23:46:22 +00:00
uniq.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
util.h separate humansize into a util function 2014-10-18 23:56:51 +01:00
uudecode.1 Initial commit of the uudecode tool and man page 2014-02-02 20:50:31 +00:00
uudecode.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
uuencode.1 Add uuencode(1) 2014-01-31 15:29:11 +00:00
uuencode.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01:00
wc.1
wc.c Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +01: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 Stop using EXIT_{SUCCESS,FAILURE} 2014-10-02 23:46:59 +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
col
cols
comm
cp
csplit
cut
date
dirname
du
echo
env
expand
expr
false
fold
grep
head
hostname
kill
link
ln
logname
ls
md5sum
mkdir
mkfifo
mktemp
mv
nice
nl
nohup
paste
printenv
printf
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

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/