NAME

       gentcos - TCOS image boot generator

SYNOPSIS

       gentcos [options]

DESCRIPTION

       This  manpage  show  options  for  gentcos  boot image generator. See gentcos -h to better
       descriptions.

       You must exec this app as root user.

       gentcos is a shell script that create a TCOS initramfs and optionally a iso image to  boot
       from it.

OPTIONS

       -h

       -help  Show extended usage about gentcos

       -suffix=foo
              Suffix used to filenames (default empy)

       -vmlinuz=2.6.16-1-486
              Kernel version used to create initramfs

       -size  Print size of uncompressed initramfs ram disk

       -allmodules
              Generate allmodules.squashfs and copy to /var/lib/tcos/tftp

              Then thin client must start with allmodules cmdline to download it

BOOT METHODS

       PXE like method

       -tftp  Create initramfs-x.x.x (and usr-x.x.x.squashfs) and copy to /var/lib/tcos/tftp

              -o=initramfs-pc1    output filename (in /var/lib/tcos/tftp)

       NFS (LTSP like) method

       -nfs   Create initramfs-x.x.x-nfs  and copy to /var/lib/tcos/tftp

       -rootfs
              Creates an complete TCOS and uncompress in /var/lib/tcos/fs-x.x.x

              NOTE:   Need  a  NFS  server  (apt-get  install nfs-kernel-server) and this line in
              /etc/exports:

              /var/lib/tcos 192.168.0.0/255.255.255.0 (ro,no_root_squash,sync,no_subtree_check)
                   (change network data with yours)

       Floppy boot method

       -nbi   Create initramfs (and usr.squashfs) an join with kernel in a nbi file then copy  to
              /var/lib/tcos/tftp

       -nbi-output=linux-pc1.nbi
              output filename (in /var/lib/tcos/tftp)

       CDROM method

       -cdrom Create  initramfs and create a bootable iso based on isolunux Iso image is saved in
              /var/lib/tcos/isos/

EXAMPLES

       PXE like boot (>=64 MB)
            # gentcos -tftp -suffix=-pc1

       NFS (LTSP like) boot (28-64 MB)
            # gentcos -nfs -rootfs

       CDROM boot
            # gentcos -cdrom

       Floppy boot
            # gentcos -nbi -extra-append="vga=791 uselocal"

Package cache

       Sometimes TCOS need some software that conflicts with installed packages.  To solve  this,
       gentcos  can  download  and  extract package files in /var/cache/tcos/packages/pkg_name to
       copy files to initramfs.

       Howto install a cached package

       -instpkg foo
              Exec apt-get install --print-uris -y -f foo
               get the package URI and uncompress it
               into /var/cache/tcos/packages/foo

       Remove one or more packages

       -rmpkg foo
              Remove foo package.

       List installed packages

       -listpkg
              Show all packages installed.

BUGS

       Contact Mario Izquierdo <mariodebian@gmail.com>

       Info about TCOS project: http://www.tcosproject.org

SEE ALSO

       tcos.conf(5)

AUTHOR

       Mario Izquierdo (mariodebian) <mariodebian@gmail.com>