morpheus-base

morpheus base system
git clone git://git.2f30.org/morpheus-base
Log | Files | Refs

README (5800B)


      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 ('*' == finished, '#' == UTF-8 support,
      8 '=' == implicit UTF-8 support):
      9 
     10    UTILITY         POSIX 2008 COMPLIANT            MISSING OPTIONS
     11    -------         --------------------            ---------------
     12 =* basename        yes                             none
     13 =* cal             yes                             none
     14 =* cat             yes                             none
     15 =  chgrp           no                              -h, -H, -L, -P
     16 =* chmod           yes                             none
     17 =  chown           no                              -h, -H, -L, -P
     18 =  chroot          non-posix                       none
     19 =* cksum           yes                             none
     20  * cmp             yes                             none
     21  * cols            non-posix                       none
     22 =* comm            yes                             none
     23 =  cp              no                              -H, -i, -L
     24 =* cron            non-posix                       none
     25  * cut             yes                             none
     26 =  date            yes                             none
     27 =  dirname         yes                             none
     28 =  du              no                              -H, -L, -x
     29 =  echo            yes                             none
     30 =  env             yes                             none
     31 #  expand          yes                             none
     32    expr            yes                             none
     33 =* false           yes                             none
     34    fold            yes                             none
     35  * grep            yes                             none
     36    head            yes                             none
     37 =  hostname        non-posix                       none
     38 =* kill            yes                             none
     39 =  link            yes                             none
     40 =  ln              yes                             none
     41 =* logger          yes                             none
     42 =  logname         yes                             none
     43 =  ls              no                              -C, -R, -q, -u
     44    md5sum          non-posix                       none
     45 =  mkdir           yes                             none
     46 =  mkfifo          yes                             none
     47 =  mktemp          non-posix                       none
     48 =  mv              no                              -i
     49 =  nice            yes                             none
     50 =  nl              no                              -d, -f, -h, -l, -n, -p, -v, -w
     51 =  nohup           yes                             none
     52    paste           yes                             none
     53 =  printenv        non-posix                       none
     54    printf          stolen                          stolen
     55 =* pwd             yes                             none
     56 =  readlink        non-posix                       none
     57 =  renice          yes                             none
     58 =  rm              no                              -i
     59 =  rmdir           no                              -p
     60 =  sleep           yes                             none
     61 =  setsid          non-posix                       none
     62    sort            no                              -m, -o, -d, -f, -i
     63    split           yes                             none
     64 =  sponge          non-posix                       none
     65    strings         no                              -a, -n, -t
     66 =  sync            non-posix                       none
     67 =  tail            no                              -c, -f
     68 =  tar             non-posix                       none
     69 =  tee             no                              -i
     70    test            yes                             none
     71 =  touch           no                              -r
     72 #* tr              yes                             none
     73 =* true            yes                             none
     74 =  tty             yes                             none
     75 =  uudecode        no                              -o
     76 =  uuencode        no                              -m
     77 =  uname           yes                             none
     78 #  unexpand        yes                             none
     79 =  uniq            no                              -f, -s
     80 =  unlink          yes                             none
     81    seq             non-posix                       none
     82 =  sha1sum         non-posix                       none
     83 =  sha256sum       non-posix                       none
     84 =  sha512sum       non-posix                       none
     85    wc              yes                             none
     86 =  xargs           no                              -I, -L, -p, -s, -t, -x
     87 =  yes             yes                             none
     88 
     89 The  complement of  sbase  is  ubase[1] which  is  Linux-specific  and
     90 provides all  the non-portable tools.   Together they are  intended to
     91 form a base system similar to busybox but much smaller and suckless.
     92 
     93 Building
     94 --------
     95 
     96 You need GNU make to build sbase on OpenBSD.
     97 
     98 To  build sbase,  simply  type  make.  You  may  have  to fiddle  with
     99 config.mk depending on your system.
    100 
    101 You  can  also  build  sbase-box,  which  generates  a  single  binary
    102 containing  all  the  required  tools.    You  can  then  symlink  the
    103 individual tools to sbase-box.
    104 
    105 Ideally you will  want to statically link sbase.  If  you are on Linux
    106 we recommend using musl-libc[2].
    107 
    108 Portability
    109 -----------
    110 
    111 sbase has been  compiled on a variety of  different operating systems,
    112 including Linux, *BSD, OSX, Haiku, Solaris, SCO OpenServer and others.
    113 
    114 Various combinations of operating  systems and architectures have also
    115 been built.
    116 
    117 You can build sbase with gcc, clang, tcc, nwcc and pcc.
    118 
    119 [1] http://git.suckless.org/ubase/
    120 [2] http://www.musl-libc.org/