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>

gentcos man page                                  Feb 03, 2007                                        gentcos(1)