website annotate en/doc/manuals/tazlito.en.html @ rev 278

fr: prepa for new handbook-stable
author Christophe Lincoln <pankso@slitaz.org>
date Fri Feb 06 23:09:33 2009 +0100 (2009-02-06)
parents cb3923c60b05
children a573622733cd
rev   line source
paul@73 1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
paul@73 2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
paul@73 3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
paul@73 4 <head>
paul@73 5 <title>Tazlito Manual - SliTaz Live Tool</title>
paul@73 6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
paul@73 7 <meta name="description" content="" />
paul@73 8 <meta name="expires" content="never" />
MikeDSmith25@117 9 <meta name="modified" content="2008-07-18 14:00:00" />
paul@73 10 <style type="text/css"><!--
paul@73 11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
paul@73 12 #header { background: #f0ba08; color: black; height: 50px;
paul@73 13 border-top: 1px solid black; border-bottom: 1px solid black; }
paul@73 14 #content { margin: 0px 50px 26px 50px; }
paul@73 15 h1 { margin: 14px 0px 0px 16px; }
paul@73 16 li { line-height: 1.4em; }
paul@73 17 pre { padding: 5px; color: black; background: #e1e0b0; }
paul@73 18 pre.script { padding: 10px; color: black; background: #e8e8e8;
paul@73 19 border: 1px inset #333333; }
paul@73 20 code { font-size: 100%; color: #669900; background: transparent; }
paul@73 21 hr { color: white; background: white; height: 1px; border: 0; }
paul@73 22 --></style>
paul@73 23 </head>
paul@73 24 <body bgcolor="#ffffff">
paul@73 25 <div id="header">
paul@73 26 <h1><font color="#3e1220">Tazlito Manual</font></h1>
paul@73 27 </div>
paul@73 28 <hr />
paul@73 29 <!-- Start content -->
paul@73 30 <div id="content">
paul@73 31
paul@73 32 <h2>NAME</h2>
paul@73 33 <p>
paul@73 34 Tazlito - SliTaz Live Tool.
paul@73 35 </p>
paul@73 36
paul@73 37 <h2>SYNTAX</h2>
paul@73 38 <pre>
paul@73 39 tazlito [command] [list|iso|flavor] [dir]
paul@73 40 </pre>
paul@73 41
paul@73 42 <h2>DESCRIPTION</h2>
paul@73 43 <p>
paul@73 44 Tazlito is a small utility to extract a LiveCD, rebuild the
paul@73 45 ISO image and regenerate the root filesystem of the LiveCD.
paul@73 46 Tazlito can also generate a distribution from a list of packages
MikeDSmith25@117 47 previously downloaded. To run, Tazlito uses the configuration file
paul@73 48 /etc/slitaz-tools/tazlito.conf or a tazlito.conf found in the
paul@215 49 current directory that can be easily generated.
paul@215 50 It specifies the name of the ISO, volume, maintainer and
paul@73 51 the paths of the packages to distribute and the generated ISO.
paul@73 52 Tazlito can also set up a directory containing additional files,
MikeDSmith25@117 53 which will be copied to the LiveCD when generating the distribution.
paul@73 54 </p>
paul@73 55 <p>
paul@73 56 Tazlito is distributed under the free GNU licence GPL V3,
MikeDSmith25@117 57 installed by default on SliTaz and installed/sucessfully tested
paul@73 58 on Debian GNU/Linux. You will find additional information
paul@73 59 about creating a LiveCD in the Handbook.
paul@73 60 </p>
paul@73 61
paul@73 62 <h2>COMMANDS</h2>
paul@73 63 <h3><font color="#6c0023">usage</font></h3>
paul@73 64 <p>
paul@125 65 The 'usage' command displays a summary of available commands
paul@138 66 with a short description:
paul@73 67 </p>
paul@73 68 <pre>
paul@73 69 # tazlito usage
paul@73 70 </pre>
paul@73 71 <h3><font color="#6c0023">stats</font></h3>
paul@73 72 <p>
paul@73 73 Stats displays the configuration variables, the paths to the
paul@215 74 various files and directories, and information on the ISO image:
paul@73 75 </p>
paul@73 76 <pre>
paul@73 77 # tazlito stats
paul@73 78 </pre>
paul@73 79 <h3><font color="#6c0023">gen-config</font></h3>
paul@73 80 <p>
paul@73 81 The 'gen-config' command allows you to generate a configuration
paul@73 82 file ready to be edited. By default the file is created in
paul@164 83 the current directory, but can be in another directory
paul@215 84 if specified via the command line:
paul@73 85 </p>
paul@73 86 <pre>
paul@73 87 # tazlito gen-config
paul@73 88 # tazlito gen-config /path/to/distro
paul@73 89 </pre>
paul@73 90 <h3><font color="#6c0023">configure</font></h3>
paul@73 91 <p>
paul@215 92 This command configures the system configuration
paul@73 93 file or one found in the current directory:
paul@73 94 </p>
paul@73 95 <pre>
paul@73 96 # tazlito configure
paul@73 97 </pre>
paul@73 98 <h3><font color="#6c0023">gen-iso</font></h3>
paul@73 99 <p>
paul@73 100 The 'gen-iso' command can generate a
paul@73 101 new LiveCD image following modifications and additions to the
MikeDSmith25@117 102 root filesystem of the cdrom. To function, this command needs
MikeDSmith25@117 103 a directory containing the distro-tree of the Live system.
MikeDSmith25@117 104 This tree can easily be built with the 'extract-distro' command,
paul@73 105 modified and rebuilt via:
paul@73 106 </p>
paul@73 107 <pre>
paul@73 108 # tazlito gen-iso
paul@73 109 </pre>
paul@73 110 <h3><font color="#6c0023">gen-initiso</font></h3>
paul@73 111 <p>
paul@73 112 The 'gen'initso' command will do the same work as 'gen-iso',
MikeDSmith25@117 113 but it rebuilds the initramfs compressed system prior.
paul@73 114 The initramfs contains the root filesystem and
paul@73 115 must be rebuilt if modified:
paul@73 116 </p>
paul@73 117 <pre>
paul@73 118 # tazlito gen-initiso
paul@73 119 </pre>
paul@73 120 <h3><font color="#6c0023">list-flavors</font></h3>
paul@73 121 <p>
paul@73 122 The 'list-flavors' command downloads (if necessary) and displays
MikeDSmith25@117 123 a list of the different flavors available. You can force the
paul@125 124 download with the --recharge option:
paul@73 125 </p>
paul@73 126 <pre>
paul@73 127 # tazlito list-flavors
paul@73 128 # tazlito list-flavors --recharge
paul@73 129 </pre>
paul@73 130 <h3><font color="#6c0023">get-flavor</font></h3>
paul@73 131 <p>
paul@125 132 The 'get-flavor' command downloads (if necessary) and prepares the
paul@73 133 files for 'gen-distro' to generate a flavor:
paul@73 134 </p>
paul@73 135 <pre>
paul@73 136 # tazlito get-flavor particular-flavor
paul@73 137 </pre>
paul@73 138 <h3><font color="#6c0023">show-flavor</font></h3>
paul@73 139 <p>
paul@73 140 The 'show-flavor' command displays the description of the
paul@125 141 flavor and its size after regeneration. The options
paul@73 142 --brief and --noheader reduce the output displayed:
paul@73 143 </p>
paul@73 144 <pre>
paul@73 145 # tazlito show-flavor particular-flavor
paul@73 146 # tazlito show-flavor particular-flavor --brief
paul@73 147 # tazlito show-flavor particular-flavor --brief --noheader
paul@73 148 </pre>
paul@73 149 <h3><font color="#6c0023">gen-flavor</font></h3>
paul@73 150 <p>
paul@73 151 The 'gen-flavor' command creates a description file of a new
MikeDSmith25@117 152 flavor from the results of generating a distro (gen-distro).
paul@73 153 The .flavor file can then be sent to slitaz.org:
paul@73 154 </p>
paul@73 155 <pre>
paul@73 156 # tazlito gen-flavor new-flavor
paul@73 157 </pre>
paul@182 158 <h3><font color="#6c0023">gen-liveflavor</font></h3>
paul@182 159 <p>
paul@182 160 The 'gen-liveflavor' command creates a description file of a new
paul@182 161 flavor from the results of generating a distro based on the
paul@235 162 current system. The --help option provides more information:
paul@182 163 </p>
paul@182 164 <pre> # tazlito gen-liveflavor
paul@232 165 # tazlito gen-liveflavor --help
paul@182 166 </pre>
paul@73 167 <h3><font color="#6c0023">extract-distro</font></h3>
paul@73 168 <p>
paul@73 169 The 'extract-distro' command is used to extract an ISO image
MikeDSmith25@117 170 from the LiveCD to rebuild the structure of the root cdrom
MikeDSmith25@117 171 and system. It is then possible to make the desired changes
paul@138 172 or additions and rebuild the ISO image via 'gen-iso' or
paul@73 173 'gen-initiso'. Example of use:
paul@73 174 </p>
paul@73 175 <pre>
paul@73 176 # tazlito extract-distro slitaz-cooking.iso
paul@73 177 </pre>
paul@73 178 <h3><font color="#6c0023">gen-distro</font></h3>
paul@73 179 <p>
paul@73 180 The <em>Generate Distribution</em> command can generate the
paul@73 181 distro-tree and an ISO image via a list of packages. To function,
paul@73 182 this command needs a list of packages, a directory containing
MikeDSmith25@117 183 all the (.tazpkg) packages on the list, and a directory to
paul@73 184 generate the distribution. The list of packages can be extracted
paul@73 185 from a flavor by the 'get-flavor' command. If one uses the
paul@73 186 LiveCD, the options --cdrom and --iso= permit the regeneration
paul@73 187 of packages that place files in /boot without being obliged
paul@73 188 to download them and recovers the additional files of the
paul@73 189 LiveCD. The path to the various directories are configured
paul@73 190 in the configuration file and packages can be downloaded
paul@73 191 from the SliTaz mirrors or generated by Tazwok. To generate
paul@73 192 a distribution:
paul@73 193 </p>
paul@73 194 <pre>
paul@73 195 # tazlito gen-distro
paul@73 196 # tazlito gen-distro --cdrom
paul@73 197 # tazlito gen-distro --iso=slitaz.iso
paul@73 198 # tazlito gen-distro package-list
paul@73 199 </pre>
paul@73 200 <h3><font color="#6c0023">clean-distro</font></h3>
paul@73 201 <p>
MikeDSmith25@117 202 Removes all files generated or extracts of the structure
paul@73 203 of the LiveCD:
paul@73 204 </p>
paul@73 205 <pre>
paul@73 206 # tazlito clean-distro
paul@73 207 </pre>
paul@73 208 <h3><font color="#6c0023">addhacker</font></h3>
paul@73 209 <p>
paul@73 210 The 'addhacker' command allows the addition of the user
paul@73 211 hacker to the distribution - it helps to have a user account
paul@73 212 without a password. Note that this command changes permissions
paul@73 213 on all files in <code>/home/hacker</code>:
paul@73 214 </p>
paul@73 215 <pre>
paul@73 216 # tazlito addhacker
paul@73 217 </pre>
paul@73 218 <h3><font color="#6c0023">check-distro</font></h3>
paul@73 219 <p>
paul@73 220 This command simply verifies if files installed
paul@73 221 by the packages are present on the system:
paul@73 222 </p>
paul@73 223 <pre>
paul@73 224 # tazlito check-distro
paul@73 225 </pre>
paul@73 226 <h3><font color="#6c0023">burn-iso</font></h3>
paul@73 227 <p>
MikeDSmith25@117 228 Burn-iso will guess the cdrom device and its speed, and wodim
paul@73 229 (part of cdrkit) will begin to burn an ISO image. The default
paul@73 230 ISO image is the one in the current configuration file,
paul@73 231 but it's possible to specify a different image via the
paul@73 232 command line:
paul@73 233 </p>
paul@73 234 <pre>
paul@73 235 # tazlito burn-iso
paul@73 236 # tazlito burn-iso slitaz-hacked.iso
paul@73 237 </pre>
paul@73 238
paul@73 239 <h2>MAINTAINER</h2>
paul@73 240 <p>
paul@73 241 Christophe Lincoln &lt;pankso at slitaz.org&gt;
paul@73 242 </p>
paul@73 243
paul@73 244 <!-- End content -->
paul@73 245 </div>
paul@73 246 </body>
paul@73 247 </html>
paul@73 248