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