suckless unix tools
Go to file
Hiltjo Posthuma 18b6e40161 crypt: error status code if an error occured in a file series
Signed-off-by: Hiltjo Posthuma <hiltjo@codemadness.org>
2014-03-23 12:27:24 +00:00
util crypt: error status code if an error occured in a file series 2014-03-23 12:27:24 +00:00
LICENSE Add Daniel Bainton to LICENSE 2014-02-18 12:54:25 +00:00
Makefile Rename mc(1) to cols(1) 2014-03-12 14:47:38 +00:00
README Update README 2014-02-27 16:56:59 +00:00
TODO Update TODO 2014-01-30 11:44:29 +00: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 Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
cat.1 add sleep & date, thanks kamil 2011-05-23 19:00:31 +01:00
cat.c Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00: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 Simplify code and don't use ftw() for chgrp(1) 2013-10-08 00:47:04 +01:00
chmod.1 Add sticky bit to documentation. 2013-10-20 10:41:32 +01:00
chmod.c We do symbolic options for chmod(1) 2014-03-04 11:05:01 +00:00
chown.1 chmod, chown: remove redundant flag 2012-05-25 21:52:01 +01:00
chown.c Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +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 Return proper error values in case execvp() fails 2014-02-13 13:09:00 +00:00
cksum.1 cksum: error check 2011-06-10 04:36:40 +01:00
cksum.c Use PRIu32 and avoid cast 2014-02-01 20:16:14 +00:00
cmp.1 add cmp, thanks stateless 2011-06-10 01:55:12 +01:00
cmp.c Make code a bit more clear 2014-03-04 10:43:51 +00: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 Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +01:00
config.mk Revert "Fix relocation error on OpenBSD (amd64) when compiling with pcc" 2013-12-21 13:39:29 +00:00
cp.1 Add -R as a synonym to -r for cp(1) 2013-12-12 13:30:17 +00:00
cp.c Show usage instead of exiting silently on an invalid option 2013-12-12 13:30:25 +00:00
crypt.h Forgot to remove argc from function decl 2013-11-30 21:12:40 +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 No need to use enprintf() with EXIT_FAILURE 2014-01-30 14:55:26 +00: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 Add license file details at top of files 2013-10-07 17:03:34 +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 Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00:00
fs.h implement cp and mv and improve rm 2012-01-30 22:41:33 +00:00
grep.1 Implement -e support for grep 2013-10-05 13:51:45 +01:00
grep.c Implement -e support for grep 2013-10-05 13:51:45 +01:00
head.1 add tail 2011-05-26 16:18:42 -01:00
head.c Add weprintf() and replace fprintf(stderr, ...) calls 2013-11-13 11:41:43 +00: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 Add the -F flag to ls 2014-02-18 12:54:16 +00:00
md5.h Add crypt.[ch] and update md5sum and sha1sum 2013-07-18 09:51:17 -04:00
md5sum.1 Add md5sum 2013-07-05 17:29:43 -04:00
md5sum.c Add cryptmain() and factor out the code from the crypt tools 2013-10-05 13:51:45 +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 No need to use enprintf() with EXIT_FAILURE 2014-01-30 14:55:26 +00: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 Use the more portable NZERO instead of PRIO_* 2014-02-27 14:24:21 +00: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 Exit with EXIT_SUCCESS/EXIT_FAILURE instead of 0 and 1 2013-10-07 16:44:22 +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 Use arg.h as much as possible and add usage() where missing 2013-10-07 17:13:01 +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 Tar compiles on BSD, thanks Roberto E. Vargas Caballero. Also remove tons of trailing whitespace. 2013-07-20 01:27:42 -04:00
renice.c Use the more portable NZERO instead of PRIO_* 2014-02-27 14:24:21 +00: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 Add license file details at top of files 2013-10-07 17:03:34 +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 Add sha1sum 2013-07-05 17:31:43 -04:00
sha1sum.c Add cryptmain() and factor out the code from the crypt tools 2013-10-05 13:51:45 +01:00
sha256.h Add sha256sum(1) 2013-07-20 13:20:16 -04:00
sha256sum.1 Add sha256sum(1) 2013-07-20 13:20:16 -04:00
sha256sum.c Add cryptmain() and factor out the code from the crypt tools 2013-10-05 13:51:45 +01:00
sha512.h Add sha512sum(1) 2013-08-04 11:00:34 -04:00
sha512sum.1 Add sha512sum(1) 2013-08-04 11:00:34 -04:00
sha512sum.c Add cryptmain() and factor out the code from the crypt tools 2013-10-05 13:51:45 +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 Add -n support to sort(1) 2013-12-12 13:10:59 +00:00
sort.c Add -n support to sort(1) 2013-12-12 13:10:59 +00: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 No need to print the name of the program 2014-01-30 14:55:18 +00: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 Add license file details at top of files 2013-10-07 17:03:34 +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 Return false in case we invoke `test s1' and s1 is the null string 2013-11-11 12:00:22 +00: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 Add the tr program including man page 2014-01-20 11:22:28 +00:00
tr.c Staticise functions in tr(1) 2014-01-25 22:07:40 +00: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 Add license file details at top of files 2013-10-07 17:03:34 +01:00
util.h Ensure we #undef strlcat and strlcpy 2014-01-30 21:04:01 +00:00
uudecode.1 Initial commit of the uudecode tool and man page 2014-02-02 20:50:31 +00:00
uudecode.c No need to use do { } while (0) construct 2014-02-04 16:51:34 +00: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 Implement -E eofstr for xargs(1) 2014-01-07 12:03:50 +00:00
xargs.c No need to use enprintf() with EXIT_FAILURE 2014-01-30 14:55:26 +00: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 Simplify yes(1) 2013-10-05 15:11:16 +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/