ubase/README

79 lines
1.3 KiB
Plaintext

ubase - suckless linux base utils
=================================
ubase is a collection of tools similar in spirit to util-linux but
much simpler.
The following programs are currently implemented:
chvt
clear
ctrlaltdel
dd
df
dmesg
eject
fallocate
free
freeramdisk
fsfreeze
getty
halt
hwclock
id
insmod
killall5
lastlog
login
lsmod
lsusb
mesg
mknod
mkswap
mount
mountpoint
pagesize
passwd
pidof
pivot_root
ps
readahead
respawn
rmmod
stat
su
swapoff
swapon
switch_root
sysctl
truncate
umount
unshare
uptime
watch
who
The complement of ubase is sbase[1] which mostly follows POSIX and
provides all the portable tools. Together they are intended to form a
base system similar to busybox but much smaller and suckless.
Building
--------
To build ubase, simply type make. You may have to fiddle with
config.mk and config.h depending on your system.
You can also build ubase-box, which generates a single binary
containing all the required tools. You can then symlink the
individual tools to ubase-box or run them directly as follows:
ubase-box cmd [args]
Ideally you will want to statically link ubase. We highly recommend
using musl-libc[2].
ubase is known to compile with gcc, clang and tcc.
[1] http://git.suckless.org/sbase/
[2] http://www.musl-libc.org/