sbase

suckless unix tools
git clone git://git.2f30.org/sbase.git
Log | Files | Refs | README | LICENSE

README (3789B)


      1 sbase - suckless unix tools
      2 ===========================
      3 
      4 sbase  is a  collection of  unix  tools that  are inherently  portable
      5 across UNIX and UNIX-like systems.
      6 
      7 The following tools are implemented:
      8 
      9 '#'  -> UTF-8 support, '=' -> Implicit UTF-8 support, '*' -> Finished,
     10 '|'  -> Audited,       'o' -> POSIX 2013 compliant,   'x' -> Non-POSIX,
     11 '0'  -> NUL handling,  '()' -> Petty flag
     12 
     13       UTILITY         MISSING
     14       -------         -------
     15 0=*|o basename        .
     16 0=*|o cal             .
     17 0=*|o cat             .
     18 0=*|o chgrp           .
     19 0=*|o chmod           .
     20 0=*|o chown           .
     21 0=*|x chroot          .
     22 0=*|o cksum           .
     23 0=*|o cmp             .
     24 0#*|x cols            .
     25 0=*|o comm            .
     26 0=*|o cp              (-i)
     27 0=*|x cron            .
     28 0#*|o cut             .
     29 0=*|o date            .
     30 0=*|o dirname         .
     31 0=*|o du              .
     32 0=*|o echo            .
     33     o ed              .
     34 0=*|o env             .
     35 0#*|o expand          .
     36 0#*|o expr            .
     37 0=*|o false           .
     38 0=    find            .
     39 0=* x flock           .
     40 0#*|o fold            .
     41 0=*|o getconf         (-v)
     42  =*|o grep            .
     43 0=*|o head            .
     44 0=*|x hostname        .
     45 0=*|x install         .
     46 0=* o join            .
     47 0=*|o kill            .
     48 0=*|o link            .
     49 0=*|o ln              .
     50 0=*|o logger          .
     51 0=*|o logname         .
     52 0#* o ls              (-C, -k, -m, -p, -s, -x)
     53 0=*|x md5sum          .
     54 0=*|o mkdir           .
     55 0=*|o mkfifo          .
     56 0=*|x mktemp          .
     57 0=*|o mv              (-i)
     58 0=*|o nice            .
     59 0#*|o nl              .
     60 0=*|o nohup           .
     61 0=*|o od              .
     62 0#* o pathchk         .
     63  #*|o paste           .
     64 0=*|x printenv        .
     65 0#*|o printf          .
     66 0=*|o pwd             .
     67 0=*|x readlink        .
     68 0=*|o renice          .
     69 0#* x rev             .
     70 0=*|o rm              (-i)
     71 0=*|o rmdir           .
     72  #    sed             .
     73 0=*|x seq             .
     74 0=*|x setsid          .
     75 0=*|x sha1sum         .
     76 0=* x sha224sum       .
     77 0=*|x sha256sum       .
     78 0=* x sha238sum       .
     79 0=*|x sha512sum       .
     80 0=* x sha512-224sum   .
     81 0=* x sha512-256sum   .
     82 0=*|o sleep           .
     83 0#*|o sort            .
     84 0=*|o split           .
     85 0=*|x sponge          .
     86 0#*|o strings         .
     87 0=*|x sync            .
     88 0=*|o tail            .
     89 0=*|x tar             .
     90 0=*|o tee             .
     91 0=*|o test            .
     92 0=*|x tftp            .
     93 0=*|o time            .
     94 0=*|o touch           .
     95 0#*|o tr              .
     96 0=*|o true            .
     97 0=* o tsort           .
     98 0=*|o tty             .
     99 0=*|o uname           .
    100 0#*|o unexpand        .
    101 0=*|o uniq            .
    102 0=*|o unlink          .
    103 0=*|o uudecode        .
    104 0=*|o uuencode        .
    105 0#*|o wc              .
    106 0=*|x which           .
    107 0=*|x whoami          .
    108 0=*|o xargs           (-p)
    109 0=*|x yes             .
    110 
    111 The  complement of  sbase  is  ubase[1] which  is  Linux-specific  and
    112 provides all  the non-portable tools.   Together they are  intended to
    113 form a base system similar to busybox but much smaller and suckless.
    114 
    115 Building
    116 --------
    117 
    118 To  build sbase,  simply  type  make.  You  may  have  to fiddle  with
    119 config.mk depending on your system.
    120 
    121 You  can  also  build  sbase-box,  which  generates  a  single  binary
    122 containing  all  the  required  tools.    You  can  then  symlink  the
    123 individual tools to sbase-box or run: make sbase-box-install
    124 
    125 Ideally you will  want to statically link sbase.  If  you are on Linux
    126 we recommend using musl-libc[2].
    127 
    128 Portability
    129 -----------
    130 
    131 sbase has been  compiled on a variety of  different operating systems,
    132 including Linux, *BSD, OSX, Haiku, Solaris, SCO OpenServer and others.
    133 
    134 Various combinations of operating  systems and architectures have also
    135 been built.
    136 
    137 You can build sbase with gcc, clang, tcc, nwcc and pcc.
    138 
    139 [1] http://git.suckless.org/ubase/
    140 [2] http://www.musl-libc.org/