website view en/doc/manuals/tazlito.en.html @ rev 544
tazlito*: add hooks
| author | Pascal Bellard <pascal.bellard@slitaz.org> |
|---|---|
| date | Thu Sep 17 13:04:50 2009 +0200 (2009-09-17) |
| parents | 1e40be5befcd |
| children | 2d8ddaec53ff |
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 <a name="usage"></a>
64 <h3><font color="#6c0023">usage</font></h3>
65 <p>
66 The 'usage' command displays a summary of available commands
67 with a short description:
68 </p>
69 <pre>
70 # tazlito usage
71 </pre>
72 <a name="stats"></a>
73 <h3><font color="#6c0023">stats</font></h3>
74 <p>
75 Stats displays the configuration variables, the paths to the
76 various files and directories, and information on the ISO image:
77 </p>
78 <pre>
79 # tazlito stats
80 </pre>
81 <a name="gen-config"></a>
82 <h3><font color="#6c0023">gen-config</font></h3>
83 <p>
84 The 'gen-config' command allows you to generate a configuration
85 file ready to be edited. By default the file is created in
86 the current directory, but can be in another directory
87 if specified via the command line:
88 </p>
89 <pre>
90 # tazlito gen-config
91 # tazlito gen-config /path/to/distro
92 </pre>
93 <a name="configure"></a>
94 <h3><font color="#6c0023">configure</font></h3>
95 <p>
96 This command configures the system configuration
97 file or one found in the current directory:
98 </p>
99 <pre>
100 # tazlito configure
101 </pre>
102 <a name="gen-iso"></a>
103 <h3><font color="#6c0023">gen-iso</font></h3>
104 <p>
105 The 'gen-iso' command can generate a
106 new LiveCD image following modifications and additions to the
107 root filesystem of the cdrom. To function, this command needs
108 a directory containing the distro-tree of the Live system.
109 This tree can easily be built with the 'extract-distro' command,
110 modified and rebuilt via:
111 </p>
112 <pre>
113 # tazlito gen-iso
114 </pre>
115 <a name="gen-initiso"></a>
116 <h3><font color="#6c0023">gen-initiso</font></h3>
117 <p>
118 The 'gen'initso' command will do the same work as 'gen-iso',
119 but it rebuilds the initramfs compressed system prior.
120 The initramfs contains the root filesystem and
121 must be rebuilt if modified:
122 </p>
123 <pre>
124 # tazlito gen-initiso
125 </pre>
126 <a name="list-flavors"></a>
127 <h3><font color="#6c0023">list-flavors</font></h3>
128 <p>
129 The 'list-flavors' command downloads (if necessary) and displays
130 a list of the different flavors available. You can force the
131 download with the --recharge option:
132 </p>
133 <pre>
134 # tazlito list-flavors
135 # tazlito list-flavors --recharge
136 </pre>
137 <a name="get-flavors"></a>
138 <h3><font color="#6c0023">get-flavor</font></h3>
139 <p>
140 The 'get-flavor' command downloads (if necessary) and prepares the
141 files for 'gen-distro' to generate a flavor:
142 </p>
143 <pre>
144 # tazlito get-flavor particular-flavor
145 </pre>
146 <a name="show-flavors"></a>
147 <h3><font color="#6c0023">show-flavor</font></h3>
148 <p>
149 The 'show-flavor' command displays the description of the
150 flavor and its size after regeneration. The options
151 --brief and --noheader reduce the output displayed:
152 </p>
153 <pre>
154 # tazlito show-flavor particular-flavor
155 # tazlito show-flavor particular-flavor --brief
156 # tazlito show-flavor particular-flavor --brief --noheader
157 </pre>
158 <a name="gen-flavor"></a>
159 <h3><font color="#6c0023">gen-flavor</font></h3>
160 <p>
161 The 'gen-flavor' command creates a description file of a new
162 flavor from the results of generating a distro (gen-distro).
163 The .flavor file can then be sent to slitaz.org:
164 </p>
165 <pre>
166 # tazlito gen-flavor new-flavor
167 </pre>
168 <a name="gen-liveflavor"></a>
169 <h3><font color="#6c0023">gen-liveflavor</font></h3>
170 <p>
171 The 'gen-liveflavor' command creates a description file of a new
172 flavor from the results of generating a distro based on the
173 current system. The --help option provides more information:
174 </p>
175 <pre> # tazlito gen-liveflavor
176 # tazlito gen-liveflavor --help
177 </pre>
178 <a name="extract-distro"></a>
179 <h3><font color="#6c0023">extract-distro</font></h3>
180 <p>
181 The 'extract-distro' command is used to extract an ISO image
182 from the LiveCD to rebuild the structure of the root cdrom
183 and system. It is then possible to make the desired changes
184 or additions and rebuild the ISO image via 'gen-iso' or
185 'gen-initiso'. Example of use:
186 </p>
187 <pre>
188 # tazlito extract-distro slitaz-cooking.iso
189 </pre>
190 <a name="gen-distro"></a>
191 <h3><font color="#6c0023">gen-distro</font></h3>
192 <p>
193 The <em>Generate Distribution</em> command can generate the
194 distro-tree and an ISO image via a list of packages. To function,
195 this command needs a list of packages, a directory containing
196 all the (.tazpkg) packages on the list, and a directory to
197 generate the distribution. The list of packages can be extracted
198 from a flavor by the 'get-flavor' command. If one uses the
199 LiveCD, the options --cdrom and --iso= permit the regeneration
200 of packages that place files in /boot without being obliged
201 to download them and recovers the additional files of the
202 LiveCD. The path to the various directories are configured
203 in the configuration file and packages can be downloaded
204 from the SliTaz mirrors or generated by Tazwok. To generate
205 a distribution:
206 </p>
207 <pre>
208 # tazlito gen-distro
209 # tazlito gen-distro --cdrom
210 # tazlito gen-distro --iso=slitaz.iso
211 # tazlito gen-distro package-list
212 </pre>
213 <a name="clean-distro"></a>
214 <h3><font color="#6c0023">clean-distro</font></h3>
215 <p>
216 Removes all files generated or extracts of the structure
217 of the LiveCD:
218 </p>
219 <pre>
220 # tazlito clean-distro
221 </pre>
222 <a name="addhacker"></a>
223 <h3><font color="#6c0023">addhacker</font></h3>
224 <p>
225 The 'addhacker' command allows the addition of the user
226 hacker to the distribution - it helps to have a user account
227 without a password. Note that this command changes permissions
228 on all files in <code>/home/hacker</code>:
229 </p>
230 <pre>
231 # tazlito addhacker
232 </pre>
233 <a name="check-distro"></a>
234 <h3><font color="#6c0023">check-distro</font></h3>
235 <p>
236 This command simply verifies if files installed
237 by the packages are present on the system:
238 </p>
239 <pre>
240 # tazlito check-distro
241 </pre>
242 <a name="burn-iso"></a>
243 <h3><font color="#6c0023">burn-iso</font></h3>
244 <p>
245 Burn-iso will guess the cdrom device and its speed, and wodim
246 (part of cdrkit) will begin to burn an ISO image. The default
247 ISO image is the one in the current configuration file,
248 but it's possible to specify a different image via the
249 command line:
250 </p>
251 <pre>
252 # tazlito burn-iso
253 # tazlito burn-iso slitaz-hacked.iso
254 </pre>
256 <h2>MAINTAINER</h2>
257 <p>
258 Christophe Lincoln <pankso at slitaz.org>
259 </p>
261 <!-- End content -->
262 </div>
263 </body>
264 </html>