gentcos(1)

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>