BSDBox
(a basic freebsd box which can run on small flash rom and small memory)

by Wang Yubo <wyb@greatbit.com>

2001/03/28          4.4
2002/09/11          4.6
2004/02/18          4.9
2004/06/13          4.10
2004/12/06          5.3
2005/11/02          6.0

----------------------------------------

1. Files

    README          (this)
    build           build the bsdbox disk image
    bsdbox.conf     configure parameters for build script
    kernel.conf     for build a kernel
    crunch.conf     for build a crunch
    mfs.conf        tree structure of MFS
    root/           root tree structure of the disk image
                    with /boot, /etc and /root files

2. Requirement

  for runtime environment :

    an i386 computer, upto Pentium 4
    at lease 32M memory
    at lease 8M disk space (or a DiskOnChip 8M)

  for development :

    FreeBSD 6-RELEASE (with gcc, all sources)
    at lease 40M free disk space

3. Build & Install

    tar xzf bsdbox.x.x.tar.gz
    cd bsdbox-dist
    ./build
    cp bsdbox {to_where_you_need_it}

4. Configurations

  1) bsdbox.conf
     MFS_SIZE   : kilobytes, mfs-root filesystem size
     MFS_INODES : default is 4096, but 16384 is enough :)
     BOX_NAME   : the final block file name, size is BOX_SIZE
                  if this line is commented, the block file
                  will not created, and the bsdbox will be 
                  installed to BOX_DEVICE directly
     BOX_SIZE   : kilobytes, size of bsdbox
     BOX_DEVICE : the device name used to mount on bsdbox
     BOX_INSTALL_DEVICE : the device to install directly
     BOX_INODES : default is 4096, but 16384 is enough :)
     NO_SPLASH  : if set, do not show splash bmp

  2) kernel.conf
     configure file to compile the kernel, check freebsd 
     handbook for details.

  3) crunch.conf
     configure file to compile the crunch binary, almost 
     all the base commands can be include in it.

  4) rc.conf
     if this file exist, it will be copied into /etc directory
     of the bsdbox, the ip address, netmask, default gateway
     and much more configurations can be find here.

5. Add more programs into bsdbox

  1) boot into bsdbox
  2) copy libc.so* and all other required .so files to /root/more/lib
  3) copy /libexec/ld-elf.so* to /root/more/libexec
  4) copy runnable binaries to /root/more/bin
  5) copy and modify configuration files
  6) run /etc/update
  7) reboot and enjoy it!