NAME

Tazlito - SliTaz Live Tool.

SYNTAX

tazlito [command] [list|iso|flavor] [dir]

DESCRIPTION

Tazlito is a small utility to extract a LiveCD, rebuild the ISO image and regenerate the root filesystem of the LiveCD. Tazlito can also generate a distribution from a list of packages previously downloaded. To run, Tazlito uses the configuration file /etc/slitaz-tools/tazlito.conf or a tazlito.conf found in the current directory that can be easily generated. It specifies the name of the ISO, volume, maintainer and the paths of the packages to distribute and the generated ISO. Tazlito can also set up a directory containing additional files, which will be copied to the LiveCD when generating the distribution.

Tazlito is distributed under the free GNU licence GPL V3, installed by default on SliTaz and installed/sucessfully tested on Debian GNU/Linux. You will find additional information about creating a LiveCD in the Handbook.

COMMANDS

usage

The 'usage' command displays a summary of available commands with a short description:

 # tazlito usage

stats

Stats displays the configuration variables, the paths to the various files and directories, and information on the ISO image:

 # tazlito stats

gen-config

The 'gen-config' command allows you to generate a configuration file ready to be edited. By default the file is created in the current directory, but can be in another directory if specified via the command line:

 # tazlito gen-config
 # tazlito gen-config /path/to/distro

configure

This command configures the system configuration file or one found in the current directory:

 # tazlito configure

gen-iso

The 'gen-iso' command can generate a new LiveCD image following modifications and additions to the root filesystem of the cdrom. To function, this command needs a directory containing the distro-tree of the Live system. This tree can easily be built with the 'extract-distro' command, modified and rebuilt via:

 # tazlito gen-iso

gen-initiso

The 'gen'initso' command will do the same work as 'gen-iso', but it rebuilds the initramfs compressed system prior. The initramfs contains the root filesystem and must be rebuilt if modified:

 # tazlito gen-initiso

list-flavors

The 'list-flavors' command downloads (if necessary) and displays a list of the different flavors available. You can force the download with the --recharge option:

 # tazlito list-flavors
 # tazlito list-flavors --recharge

get-flavor

The 'get-flavor' command downloads (if necessary) and prepares the files for 'gen-distro' to generate a flavor:

 # tazlito get-flavor particular-flavor

show-flavor

The 'show-flavor' command displays the description of the flavor and its size after regeneration. The options --brief and --noheader reduce the output displayed:

 # tazlito show-flavor particular-flavor 
 # tazlito show-flavor particular-flavor --brief
 # tazlito show-flavor particular-flavor --brief --noheader

gen-flavor

The 'gen-flavor' command creates a description file of a new flavor from the results of generating a distro (gen-distro). The .flavor file can then be sent to slitaz.org:

 # tazlito gen-flavor new-flavor

gen-liveflavor

The 'gen-liveflavor' command creates a description file of a new flavor from the results of generating a distro based on the current system. The --help option provides more information:

 # tazlito gen-liveflavor
 # tazlito gen-liveflavor --help

extract-distro

The 'extract-distro' command is used to extract an ISO image from the LiveCD to rebuild the structure of the root cdrom and system. It is then possible to make the desired changes or additions and rebuild the ISO image via 'gen-iso' or 'gen-initiso'. Example of use:

 # tazlito extract-distro slitaz-cooking.iso

gen-distro

The Generate Distribution command can generate the distro-tree and an ISO image via a list of packages. To function, this command needs a list of packages, a directory containing all the (.tazpkg) packages on the list, and a directory to generate the distribution. The list of packages can be extracted from a flavor by the 'get-flavor' command. If one uses the LiveCD, the options --cdrom and --iso= permit the regeneration of packages that place files in /boot without being obliged to download them and recovers the additional files of the LiveCD. The path to the various directories are configured in the configuration file and packages can be downloaded from the SliTaz mirrors or generated by Tazwok. To generate a distribution:

 # tazlito gen-distro
 # tazlito gen-distro --cdrom
 # tazlito gen-distro --iso=slitaz.iso
 # tazlito gen-distro package-list

clean-distro

Removes all files generated or extracts of the structure of the LiveCD:

 # tazlito clean-distro

addhacker

The 'addhacker' command allows the addition of the user hacker to the distribution - it helps to have a user account without a password. Note that this command changes permissions on all files in /home/hacker:

 # tazlito addhacker

check-distro

This command simply verifies if files installed by the packages are present on the system:

 # tazlito check-distro

burn-iso

Burn-iso will guess the cdrom device and its speed, and wodim (part of cdrkit) will begin to burn an ISO image. The default ISO image is the one in the current configuration file, but it's possible to specify a different image via the command line:

 # tazlito burn-iso
 # tazlito burn-iso slitaz-hacked.iso

MAINTAINER

Christophe Lincoln <pankso at slitaz.org>