website diff en/doc/manuals/tazlito.en.html @ rev 73
en: Add Tazlito Manual & link Tazpkg Manual
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Wed Jun 25 18:45:59 2008 +0000 (2008-06-25) |
| parents | |
| children | 90abd5608652 |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/en/doc/manuals/tazlito.en.html Wed Jun 25 18:45:59 2008 +0000 1.3 @@ -0,0 +1,239 @@ 1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 1.5 + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> 1.7 +<head> 1.8 + <title>Tazlito Manual - SliTaz Live Tool</title> 1.9 + <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /> 1.10 + <meta name="description" content="" /> 1.11 + <meta name="expires" content="never" /> 1.12 + <meta name="modified" content="2007-08-03 13:26:42" /> 1.13 + <style type="text/css"><!-- 1.14 + body { font: 90% sans-serif, vernada, arial; margin: 0; } 1.15 + #header { background: #f0ba08; color: black; height: 50px; 1.16 + border-top: 1px solid black; border-bottom: 1px solid black; } 1.17 + #content { margin: 0px 50px 26px 50px; } 1.18 + h1 { margin: 14px 0px 0px 16px; } 1.19 + li { line-height: 1.4em; } 1.20 + pre { padding: 5px; color: black; background: #e1e0b0; } 1.21 + pre.script { padding: 10px; color: black; background: #e8e8e8; 1.22 + border: 1px inset #333333; } 1.23 + code { font-size: 100%; color: #669900; background: transparent; } 1.24 + hr { color: white; background: white; height: 1px; border: 0; } 1.25 + --></style> 1.26 +</head> 1.27 +<body bgcolor="#ffffff"> 1.28 +<div id="header"> 1.29 +<h1><font color="#3e1220">Tazlito Manual</font></h1> 1.30 +</div> 1.31 +<hr /> 1.32 +<!-- Start content --> 1.33 +<div id="content"> 1.34 + 1.35 +<h2>NAME</h2> 1.36 +<p> 1.37 +Tazlito - SliTaz Live Tool. 1.38 +</p> 1.39 + 1.40 +<h2>SYNTAX</h2> 1.41 +<pre> 1.42 +tazlito [command] [list|iso|flavor] [dir] 1.43 +</pre> 1.44 + 1.45 +<h2>DESCRIPTION</h2> 1.46 +<p> 1.47 +Tazlito is a small utility to extract a LiveCD, rebuild the 1.48 +ISO image and regenerate the root filesystem of the LiveCD. 1.49 +Tazlito can also generate a distribution from a list of packages 1.50 +previously downloaded. To run Tazlito uses a configuration file 1.51 +/etc/slitaz-tools/tazlito.conf or a tazlito.conf found in the 1.52 +current directory, this can be easily generated 1.53 +by Tazlito, it specifies the name of the ISO, volume, maintainer and 1.54 +the paths of the packages to distribute and the generated ISO. 1.55 +Tazlito can also set up a directory containing additional files, 1.56 +which will be copied into the LiveCD when generating the distribution. 1.57 +</p> 1.58 +<p> 1.59 +Tazlito is distributed under the free GNU licence GPL V3, 1.60 +Installed by default of SliTaz and installed/sucessfully tested 1.61 +on Debian GNU/Linux. You will find additional information 1.62 +about creating a LiveCD in the Handbook. 1.63 +</p> 1.64 + 1.65 +<h2>COMMANDS</h2> 1.66 +<h3><font color="#6c0023">usage</font></h3> 1.67 +<p> 1.68 +The 'usage' command displays a list of available commands 1.69 +with a short description: 1.70 +</p> 1.71 +<pre> 1.72 + # tazlito usage 1.73 +</pre> 1.74 +<h3><font color="#6c0023">stats</font></h3> 1.75 +<p> 1.76 +Stats displays the configuration variables, the paths to the 1.77 +various files and directories and information on the ISO image: 1.78 +</p> 1.79 +<pre> 1.80 + # tazlito stats 1.81 +</pre> 1.82 +<h3><font color="#6c0023">gen-config</font></h3> 1.83 +<p> 1.84 +The 'gen-config' command allows you to generate a configuration 1.85 +file ready to be edited. By default the file is created in 1.86 +the current directory and can also be in another directory 1.87 +if specified: 1.88 +</p> 1.89 +<pre> 1.90 + # tazlito gen-config 1.91 + # tazlito gen-config /path/to/distro 1.92 +</pre> 1.93 +<h3><font color="#6c0023">configure</font></h3> 1.94 +<p> 1.95 +This command can configure the system configuration 1.96 +file or one found in the current directory: 1.97 +</p> 1.98 +<pre> 1.99 + # tazlito configure 1.100 +</pre> 1.101 +<h3><font color="#6c0023">gen-iso</font></h3> 1.102 +<p> 1.103 +The 'gen-iso' command can generate a 1.104 +new LiveCD image following modifications and additions to the 1.105 +root filesystem of the cdrom. To function this command needs 1.106 +a directory containing the distro-tree of the Live system, 1.107 +this tree can easily be built with the 'extract-distro' command, 1.108 +modified and rebuilt via: 1.109 +</p> 1.110 +<pre> 1.111 + # tazlito gen-iso 1.112 +</pre> 1.113 +<h3><font color="#6c0023">gen-initiso</font></h3> 1.114 +<p> 1.115 +The 'gen'initso' command will do the same work as 'gen-iso', 1.116 +but rebuilds the initramfs compressed system prior. 1.117 +The initramfs contains the root filesystem and 1.118 +must be rebuilt if modified: 1.119 +</p> 1.120 +<pre> 1.121 + # tazlito gen-initiso 1.122 +</pre> 1.123 +<h3><font color="#6c0023">list-flavors</font></h3> 1.124 +<p> 1.125 +The 'list-flavors' command downloads (if necessary) and displays 1.126 +the list of the different flavors available. You can force the 1.127 +download with the -recharge option: 1.128 +</p> 1.129 +<pre> 1.130 + # tazlito list-flavors 1.131 + # tazlito list-flavors --recharge 1.132 +</pre> 1.133 +<h3><font color="#6c0023">get-flavor</font></h3> 1.134 +<p> 1.135 +The 'get-flavor' command downloads (if necessary) and prepares the necesssary 1.136 +files for 'gen-distro' to generate a flavor: 1.137 +</p> 1.138 +<pre> 1.139 + # tazlito get-flavor particular-flavor 1.140 +</pre> 1.141 +<h3><font color="#6c0023">show-flavor</font></h3> 1.142 +<p> 1.143 +The 'show-flavor' command displays the description of the 1.144 +flavor and it's size after regenerating. The options 1.145 +--brief and --noheader reduce the output displayed: 1.146 +</p> 1.147 +<pre> 1.148 + # tazlito show-flavor particular-flavor 1.149 + # tazlito show-flavor particular-flavor --brief 1.150 + # tazlito show-flavor particular-flavor --brief --noheader 1.151 +</pre> 1.152 +<h3><font color="#6c0023">gen-flavor</font></h3> 1.153 +<p> 1.154 +The 'gen-flavor' command creates a description file of a new 1.155 +flavor from the results of generating a distro (gen-distro) 1.156 +The .flavor file can then be sent to slitaz.org: 1.157 +</p> 1.158 +<pre> 1.159 + # tazlito gen-flavor new-flavor 1.160 +</pre> 1.161 +<h3><font color="#6c0023">extract-distro</font></h3> 1.162 +<p> 1.163 +The 'extract-distro' command is used to extract an ISO image 1.164 +from the LiveCD to rebuild the structure (of the root cdrom 1.165 +and system). It is then possible to make the desired changes 1.166 +or additions and rebuild the ISO image via 'gen-iso' and 1.167 +'gen-initiso'. Example of use: 1.168 +</p> 1.169 +<pre> 1.170 + # tazlito extract-distro slitaz-cooking.iso 1.171 +</pre> 1.172 +<h3><font color="#6c0023">gen-distro</font></h3> 1.173 +<p> 1.174 +The <em>Generate Distribution</em> command can generate the 1.175 +distro-tree and an ISO image via a list of packages. To function, 1.176 +this command needs a list of packages, a directory containing 1.177 +all the (.tazpkg) packages on the list and a directory to 1.178 +generate the distribution. The list of packages can be extracted 1.179 +from a flavor by the 'get-flavor' command. If one uses the 1.180 +LiveCD, the options --cdrom and --iso= permit the regeneration 1.181 +of packages that place files in /boot without being obliged 1.182 +to download them and recovers the additional files of the 1.183 +LiveCD. The path to the various directories are configured 1.184 +in the configuration file and packages can be downloaded 1.185 +from the SliTaz mirrors or generated by Tazwok. To generate 1.186 +a distribution: 1.187 +</p> 1.188 +<pre> 1.189 + # tazlito gen-distro 1.190 + # tazlito gen-distro --cdrom 1.191 + # tazlito gen-distro --iso=slitaz.iso 1.192 + # tazlito gen-distro package-list 1.193 +</pre> 1.194 +<h3><font color="#6c0023">clean-distro</font></h3> 1.195 +<p> 1.196 +Remove all files generated or extracts of the structure 1.197 +of the LiveCD: 1.198 +</p> 1.199 +<pre> 1.200 + # tazlito clean-distro 1.201 +</pre> 1.202 +<h3><font color="#6c0023">addhacker</font></h3> 1.203 +<p> 1.204 +The 'addhacker' command allows the addition of the user 1.205 +hacker to the distribution - it helps to have a user account 1.206 +without a password. Note that this command changes permissions 1.207 +on all files in <code>/home/hacker</code>: 1.208 +</p> 1.209 +<pre> 1.210 + # tazlito addhacker 1.211 +</pre> 1.212 +<h3><font color="#6c0023">check-distro</font></h3> 1.213 +<p> 1.214 +This command simply verifies if files installed 1.215 +by the packages are present on the system: 1.216 +</p> 1.217 +<pre> 1.218 + # tazlito check-distro 1.219 +</pre> 1.220 +<h3><font color="#6c0023">burn-iso</font></h3> 1.221 +<p> 1.222 +Burn-iso will estimate the cdrom device, it's speed and wodim 1.223 +(part of cdrkit) will begin to burn an ISO image. The default 1.224 +ISO image is the one in the current configuration file, 1.225 +but it's possible to specify a different image via the 1.226 +command line: 1.227 +</p> 1.228 +<pre> 1.229 + # tazlito burn-iso 1.230 + # tazlito burn-iso slitaz-hacked.iso 1.231 +</pre> 1.232 + 1.233 +<h2>MAINTAINER</h2> 1.234 +<p> 1.235 +Christophe Lincoln <pankso at slitaz.org> 1.236 +</p> 1.237 + 1.238 +<!-- End content --> 1.239 +</div> 1.240 +</body> 1.241 +</html> 1.242 +