ubase/README

80 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
last
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/