mirror of git://git.suckless.org/sbase
3111908b03
Okay, why yet another recurse()-refactor? The last one added the recursor-struct, which simplified things on the user-end, but there was still one thing that bugged me a lot: Previously, all fn()'s were forced to (l)stat the paths themselves. This does not work well when you try to keep up with H-, L- and P- flags at the same time, as each utility-function would have to set the right function-pointer for (l)stat every single time. This is not desirable. Furthermore, recurse should be easy to use and not involve trouble finding the right (l)stat-function to do it right. So, what we needed was a stat-argument for each fn(), so it is directly accessible. This was impossible to do though when the fn()'s are still directly called by the programs to "start" the recurse. Thus, the fundamental change is to make recurse() the function to go, while designing the fn()'s in a way they can "live" with st being NULL (we don't want a null-pointer-deref). What you can see in this commit is the result of this work. Why all this trouble instead of using nftw? The special thing about recurse() is that you tell the function when to recurse() in your fn(). You don't need special flags to tell nftw() to skip the subtree, just to give an example. The only single downside to this is that now, you are not allowed to unconditionally call recurse() from your fn(). It has to be a directory. However, that is a cost I think is easily weighed up by the advantages. Another thing is the history: I added a procedure at the end of the outmost recurse to free the history. This way we don't leak memory. A simple optimization on the side: - if (h->dev == st.st_dev && h->ino == st.st_ino) + if (h->ino == st.st_ino && h->dev == st.st_dev) First compare the likely difference in inode-numbers instead of checking the unlikely condition that the device-numbers are different. |
||
|---|---|---|
| libutf | ||
| libutil | ||
| LICENSE | ||
| Makefile | ||
| README | ||
| TODO | ||
| arg.h | ||
| basename.1 | ||
| basename.c | ||
| cal.1 | ||
| cal.c | ||
| cat.1 | ||
| cat.c | ||
| chgrp.1 | ||
| chgrp.c | ||
| chmod.1 | ||
| chmod.c | ||
| chown.1 | ||
| chown.c | ||
| chroot.1 | ||
| chroot.c | ||
| cksum.1 | ||
| cksum.c | ||
| cmp.1 | ||
| cmp.c | ||
| col.1 | ||
| col.c | ||
| cols.1 | ||
| cols.c | ||
| comm.1 | ||
| comm.c | ||
| compat.h | ||
| config.mk | ||
| cp.1 | ||
| cp.c | ||
| cron.1 | ||
| cron.c | ||
| crypt.h | ||
| cut.1 | ||
| cut.c | ||
| date.1 | ||
| date.c | ||
| dirname.1 | ||
| dirname.c | ||
| du.1 | ||
| du.c | ||
| echo.1 | ||
| echo.c | ||
| env.1 | ||
| env.c | ||
| expand.1 | ||
| expand.c | ||
| expr.1 | ||
| expr.c | ||
| false.1 | ||
| false.c | ||
| find.1 | ||
| find.c | ||
| fold.1 | ||
| fold.c | ||
| fs.h | ||
| grep.1 | ||
| grep.c | ||
| head.1 | ||
| head.c | ||
| hostname.1 | ||
| hostname.c | ||
| kill.1 | ||
| kill.c | ||
| link.1 | ||
| link.c | ||
| ln.1 | ||
| ln.c | ||
| logger.1 | ||
| logger.c | ||
| logname.1 | ||
| logname.c | ||
| ls.1 | ||
| ls.c | ||
| md5.h | ||
| md5sum.1 | ||
| md5sum.c | ||
| mkdir.1 | ||
| mkdir.c | ||
| mkfifo.1 | ||
| mkfifo.c | ||
| mktemp.1 | ||
| mktemp.c | ||
| mv.1 | ||
| mv.c | ||
| nice.1 | ||
| nice.c | ||
| nl.1 | ||
| nl.c | ||
| nohup.1 | ||
| nohup.c | ||
| paste.1 | ||
| paste.c | ||
| printenv.1 | ||
| printenv.c | ||
| printf.1 | ||
| printf.c | ||
| pwd.1 | ||
| pwd.c | ||
| queue.h | ||
| readlink.1 | ||
| readlink.c | ||
| renice.1 | ||
| renice.c | ||
| rm.1 | ||
| rm.c | ||
| rmdir.1 | ||
| rmdir.c | ||
| sed.1 | ||
| sed.c | ||
| seq.1 | ||
| seq.c | ||
| setsid.1 | ||
| setsid.c | ||
| sha1.h | ||
| sha1sum.1 | ||
| sha1sum.c | ||
| sha256.h | ||
| sha256sum.1 | ||
| sha256sum.c | ||
| sha512.h | ||
| sha512sum.1 | ||
| sha512sum.c | ||
| sleep.1 | ||
| sleep.c | ||
| sort.1 | ||
| sort.c | ||
| split.1 | ||
| split.c | ||
| sponge.1 | ||
| sponge.c | ||
| strings.1 | ||
| strings.c | ||
| sync.1 | ||
| sync.c | ||
| tail.1 | ||
| tail.c | ||
| tar.1 | ||
| tar.c | ||
| tee.1 | ||
| tee.c | ||
| test.1 | ||
| test.c | ||
| text.h | ||
| time.1 | ||
| time.c | ||
| touch.1 | ||
| touch.c | ||
| tr.1 | ||
| tr.c | ||
| true.1 | ||
| true.c | ||
| tty.1 | ||
| tty.c | ||
| uname.1 | ||
| uname.c | ||
| unexpand.1 | ||
| unexpand.c | ||
| uniq.1 | ||
| uniq.c | ||
| unlink.1 | ||
| unlink.c | ||
| utf.h | ||
| util.h | ||
| uudecode.1 | ||
| uudecode.c | ||
| uuencode.1 | ||
| uuencode.c | ||
| wc.1 | ||
| wc.c | ||
| xargs.1 | ||
| xargs.c | ||
| yes.1 | ||
| yes.c | ||
README
sbase - suckless unix tools
===========================
sbase is a collection of unix tools that are inherently portable
across UNIX and UNIX-like systems.
The following tools are implemented ('*' == finished, '#' == UTF-8 support,
'=' == implicit UTF-8 support, '|' == audited, () == petty flag):
UTILITY POSIX 2008 COMPLIANT MISSING OPTIONS
------- -------------------- ---------------
=*| basename yes none
=*| cal yes none
=*| cat yes none
=*| chgrp yes none
=*| chmod yes none
=*| chown yes none
=*| chroot non-posix none
=*| cksum yes none
=*| cmp yes none
#*| cols non-posix none
col yes none
=*| comm yes none
=*| cp yes none (-i)
=*| cron non-posix none
#*| cut yes none
=*| date yes none
=*| dirname yes none
=*| du yes none
=*| echo yes none
=*| env yes none
#*| expand yes none
#* expr yes none
=*| false yes none
= find yes none
#*| fold yes none
=* grep yes none
=*| head yes none
=*| hostname non-posix none
=*| kill yes none
=*| link yes none
=*| ln yes none
=*| logger yes none
=*| logname yes none
# ls no (-C), -S, -f, (-m), (-s), (-x)
=*| md5sum non-posix none
=*| mkdir yes none
=*| mkfifo yes none
=*| mktemp non-posix none
=*| mv yes none (-i)
=*| nice yes none
= nl no -d, -f, -h, -p
=*| nohup yes none
#*| paste yes none
=*| printenv non-posix none
#*| printf yes none
=*| pwd yes none
= readlink non-posix none
=*| renice yes none
=*| rm yes none (-i)
=*| rmdir yes none
# sed
seq non-posix none
=*| setsid non-posix none
=*| sha1sum non-posix none
=*| sha256sum non-posix none
=*| sha512sum non-posix none
=*| sleep yes none
sort no -m, -o, -d, -f, -i
=*| split yes none
=*| sponge non-posix none
#*| strings yes none
=*| sync non-posix none
=*| tail yes none
=* tar non-posix none
=*| tee yes none
=*| test yes none
=*| time yes none
=*| touch yes none
#*| tr yes none
=*| true yes none
=*| tty yes none
=*| uname yes none
#*| unexpand yes none
=*| uniq yes none
=*| unlink yes none
=*| uudecode yes none
=*| uuencode yes none
#*| wc yes none
= xargs no -I, -L, -p, -s, -t, -x
=*| yes non-posix none
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 or run: make sbase-box-install
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.
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/