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" />
|
paul@73
|
9 <meta name="modified" content="2007-08-03 13:26:42" />
|
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
|
paul@73
|
47 previously downloaded. To run Tazlito uses a configuration file
|
paul@73
|
48 /etc/slitaz-tools/tazlito.conf or a tazlito.conf found in the
|
paul@73
|
49 current directory, this can be easily generated
|
paul@73
|
50 by Tazlito, 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,
|
paul@73
|
53 which will be copied into 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,
|
paul@73
|
57 Installed by default of 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@73
|
65 The 'usage' command displays a list of available commands
|
paul@73
|
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@73
|
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@73
|
83 the current directory and can also be in another directory
|
paul@73
|
84 if specified:
|
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@73
|
92 This command can configure 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
|
paul@73
|
102 root filesystem of the cdrom. To function this command needs
|
paul@73
|
103 a directory containing the distro-tree of the Live system,
|
paul@73
|
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',
|
paul@73
|
113 but 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
|
paul@73
|
123 the list of the different flavors available. You can force the
|
paul@73
|
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@73
|
132 The 'get-flavor' command downloads (if necessary) and prepares the necesssary
|
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@73
|
141 flavor and it's size after regenerating. 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
|
paul@73
|
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@73
|
158 <h3><font color="#6c0023">extract-distro</font></h3>
|
paul@73
|
159 <p>
|
paul@73
|
160 The 'extract-distro' command is used to extract an ISO image
|
paul@73
|
161 from the LiveCD to rebuild the structure (of the root cdrom
|
paul@73
|
162 and system). It is then possible to make the desired changes
|
paul@73
|
163 or additions and rebuild the ISO image via 'gen-iso' and
|
paul@73
|
164 'gen-initiso'. Example of use:
|
paul@73
|
165 </p>
|
paul@73
|
166 <pre>
|
paul@73
|
167 # tazlito extract-distro slitaz-cooking.iso
|
paul@73
|
168 </pre>
|
paul@73
|
169 <h3><font color="#6c0023">gen-distro</font></h3>
|
paul@73
|
170 <p>
|
paul@73
|
171 The <em>Generate Distribution</em> command can generate the
|
paul@73
|
172 distro-tree and an ISO image via a list of packages. To function,
|
paul@73
|
173 this command needs a list of packages, a directory containing
|
paul@73
|
174 all the (.tazpkg) packages on the list and a directory to
|
paul@73
|
175 generate the distribution. The list of packages can be extracted
|
paul@73
|
176 from a flavor by the 'get-flavor' command. If one uses the
|
paul@73
|
177 LiveCD, the options --cdrom and --iso= permit the regeneration
|
paul@73
|
178 of packages that place files in /boot without being obliged
|
paul@73
|
179 to download them and recovers the additional files of the
|
paul@73
|
180 LiveCD. The path to the various directories are configured
|
paul@73
|
181 in the configuration file and packages can be downloaded
|
paul@73
|
182 from the SliTaz mirrors or generated by Tazwok. To generate
|
paul@73
|
183 a distribution:
|
paul@73
|
184 </p>
|
paul@73
|
185 <pre>
|
paul@73
|
186 # tazlito gen-distro
|
paul@73
|
187 # tazlito gen-distro --cdrom
|
paul@73
|
188 # tazlito gen-distro --iso=slitaz.iso
|
paul@73
|
189 # tazlito gen-distro package-list
|
paul@73
|
190 </pre>
|
paul@73
|
191 <h3><font color="#6c0023">clean-distro</font></h3>
|
paul@73
|
192 <p>
|
paul@73
|
193 Remove all files generated or extracts of the structure
|
paul@73
|
194 of the LiveCD:
|
paul@73
|
195 </p>
|
paul@73
|
196 <pre>
|
paul@73
|
197 # tazlito clean-distro
|
paul@73
|
198 </pre>
|
paul@73
|
199 <h3><font color="#6c0023">addhacker</font></h3>
|
paul@73
|
200 <p>
|
paul@73
|
201 The 'addhacker' command allows the addition of the user
|
paul@73
|
202 hacker to the distribution - it helps to have a user account
|
paul@73
|
203 without a password. Note that this command changes permissions
|
paul@73
|
204 on all files in <code>/home/hacker</code>:
|
paul@73
|
205 </p>
|
paul@73
|
206 <pre>
|
paul@73
|
207 # tazlito addhacker
|
paul@73
|
208 </pre>
|
paul@73
|
209 <h3><font color="#6c0023">check-distro</font></h3>
|
paul@73
|
210 <p>
|
paul@73
|
211 This command simply verifies if files installed
|
paul@73
|
212 by the packages are present on the system:
|
paul@73
|
213 </p>
|
paul@73
|
214 <pre>
|
paul@73
|
215 # tazlito check-distro
|
paul@73
|
216 </pre>
|
paul@73
|
217 <h3><font color="#6c0023">burn-iso</font></h3>
|
paul@73
|
218 <p>
|
paul@73
|
219 Burn-iso will estimate the cdrom device, it's speed and wodim
|
paul@73
|
220 (part of cdrkit) will begin to burn an ISO image. The default
|
paul@73
|
221 ISO image is the one in the current configuration file,
|
paul@73
|
222 but it's possible to specify a different image via the
|
paul@73
|
223 command line:
|
paul@73
|
224 </p>
|
paul@73
|
225 <pre>
|
paul@73
|
226 # tazlito burn-iso
|
paul@73
|
227 # tazlito burn-iso slitaz-hacked.iso
|
paul@73
|
228 </pre>
|
paul@73
|
229
|
paul@73
|
230 <h2>MAINTAINER</h2>
|
paul@73
|
231 <p>
|
paul@73
|
232 Christophe Lincoln <pankso at slitaz.org>
|
paul@73
|
233 </p>
|
paul@73
|
234
|
paul@73
|
235 <!-- End content -->
|
paul@73
|
236 </div>
|
paul@73
|
237 </body>
|
paul@73
|
238 </html>
|
paul@73
|
239
|