rev |
line source |
pankso@117
|
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
pankso@117
|
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
pankso@117
|
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
|
pankso@117
|
4 <head>
|
pankso@117
|
5 <title>Tazlito Manual - SliTaz Live Tool</title>
|
pankso@117
|
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
|
pankso@117
|
7 <meta name="description" content="" />
|
pankso@117
|
8 <meta name="expires" content="never" />
|
pankso@117
|
9 <meta name="modified" content="2008-07-18 14:00:00" />
|
pankso@117
|
10 <style type="text/css"><!--
|
pankso@117
|
11 body { font: 90% sans-serif, vernada, arial; margin: 0; }
|
pankso@117
|
12 #header { background: #f0ba08; color: black; height: 50px;
|
pankso@117
|
13 border-top: 1px solid black; border-bottom: 1px solid black; }
|
pankso@117
|
14 #content { margin: 0px 50px 26px 50px; }
|
pankso@117
|
15 h1 { margin: 14px 0px 0px 16px; }
|
pankso@117
|
16 li { line-height: 1.4em; }
|
pankso@117
|
17 pre { padding: 5px; color: black; background: #e1e0b0; }
|
pankso@117
|
18 pre.script { padding: 10px; color: black; background: #e8e8e8;
|
pankso@117
|
19 border: 1px inset #333333; }
|
pankso@117
|
20 code { font-size: 100%; color: #669900; background: transparent; }
|
pankso@117
|
21 hr { color: white; background: white; height: 1px; border: 0; }
|
pankso@117
|
22 --></style>
|
pankso@117
|
23 </head>
|
pankso@117
|
24 <body bgcolor="#ffffff">
|
pankso@117
|
25 <div id="header">
|
pankso@117
|
26 <h1><font color="#3e1220">Tazlito Manual</font></h1>
|
pankso@117
|
27 </div>
|
pankso@117
|
28 <hr />
|
pankso@117
|
29 <!-- Start content -->
|
pankso@117
|
30 <div id="content">
|
pankso@117
|
31
|
pankso@117
|
32 <h2>NAME</h2>
|
pankso@117
|
33 <p>
|
pankso@117
|
34 Tazlito - SliTaz Live Tool.
|
pankso@117
|
35 </p>
|
pankso@117
|
36
|
pankso@117
|
37 <h2>SYNTAX</h2>
|
pankso@117
|
38 <pre>
|
pankso@117
|
39 tazlito [command] [list|iso|flavor] [dir]
|
pankso@117
|
40 </pre>
|
pankso@117
|
41
|
pankso@117
|
42 <h2>DESCRIPTION</h2>
|
pankso@117
|
43 <p>
|
pankso@117
|
44 Tazlito is a small utility to extract a LiveCD, rebuild the
|
pankso@117
|
45 ISO image and regenerate the root filesystem of the LiveCD.
|
pankso@117
|
46 Tazlito can also generate a distribution from a list of packages
|
pankso@117
|
47 previously downloaded. To run, Tazlito uses the configuration file
|
pascal@158
|
48 /etc/tazlito/tazlito.conf or a tazlito.conf found in the
|
pankso@117
|
49 current directory that can be easily generated.
|
pankso@117
|
50 It specifies the name of the ISO, volume, maintainer and
|
pankso@117
|
51 the paths of the packages to distribute and the generated ISO.
|
paul@121
|
52 Tazlito can also set up a directory containing additional files
|
pankso@117
|
53 which will be copied to the LiveCD when generating the distribution.
|
pankso@117
|
54 </p>
|
pankso@117
|
55 <p>
|
pankso@117
|
56 Tazlito is distributed under the free GNU licence GPL V3,
|
pankso@117
|
57 installed by default on SliTaz and installed/sucessfully tested
|
pankso@117
|
58 on Debian GNU/Linux. You will find additional information
|
pankso@117
|
59 about creating a LiveCD in the Handbook.
|
pankso@117
|
60 </p>
|
pankso@117
|
61
|
pankso@117
|
62 <h2>COMMANDS</h2>
|
pankso@128
|
63
|
pankso@117
|
64 <a name="usage"></a>
|
pankso@117
|
65 <h3><font color="#6c0023">usage</font></h3>
|
pankso@117
|
66 <p>
|
pankso@117
|
67 The 'usage' command displays a summary of available commands
|
pankso@117
|
68 with a short description:
|
pankso@117
|
69 </p>
|
pankso@117
|
70 <pre>
|
pankso@117
|
71 # tazlito usage
|
pankso@117
|
72 </pre>
|
pankso@128
|
73
|
pankso@117
|
74 <a name="stats"></a>
|
pankso@117
|
75 <h3><font color="#6c0023">stats</font></h3>
|
pankso@117
|
76 <p>
|
pankso@117
|
77 Stats displays the configuration variables, the paths to the
|
pankso@117
|
78 various files and directories, and information on the ISO image:
|
pankso@117
|
79 </p>
|
pankso@117
|
80 <pre>
|
pankso@117
|
81 # tazlito stats
|
pankso@117
|
82 </pre>
|
pankso@128
|
83
|
pankso@117
|
84 <a name="gen-config"></a>
|
pankso@117
|
85 <h3><font color="#6c0023">gen-config</font></h3>
|
pankso@117
|
86 <p>
|
pankso@117
|
87 The 'gen-config' command allows you to generate a configuration
|
pankso@117
|
88 file ready to be edited. By default the file is created in
|
pankso@117
|
89 the current directory, but can be in another directory
|
pankso@117
|
90 if specified via the command line:
|
pankso@117
|
91 </p>
|
pankso@117
|
92 <pre>
|
pankso@117
|
93 # tazlito gen-config
|
pankso@117
|
94 # tazlito gen-config /path/to/distro
|
pankso@117
|
95 </pre>
|
pankso@128
|
96
|
pankso@117
|
97 <a name="configure"></a>
|
pankso@117
|
98 <h3><font color="#6c0023">configure</font></h3>
|
pankso@117
|
99 <p>
|
pankso@117
|
100 This command configures the system configuration
|
pankso@117
|
101 file or one found in the current directory:
|
pankso@117
|
102 </p>
|
pankso@117
|
103 <pre>
|
pankso@117
|
104 # tazlito configure
|
pankso@117
|
105 </pre>
|
pankso@128
|
106
|
pankso@117
|
107 <a name="gen-iso"></a>
|
pankso@117
|
108 <h3><font color="#6c0023">gen-iso</font></h3>
|
pankso@117
|
109 <p>
|
pankso@117
|
110 The 'gen-iso' command can generate a
|
pankso@117
|
111 new LiveCD image following modifications and additions to the
|
pankso@117
|
112 root filesystem of the cdrom. To function, this command needs
|
pankso@117
|
113 a directory containing the distro-tree of the Live system.
|
pankso@117
|
114 This tree can easily be built with the 'extract-distro' command,
|
pankso@117
|
115 modified and rebuilt via:
|
pankso@117
|
116 </p>
|
pankso@117
|
117 <pre>
|
pankso@117
|
118 # tazlito gen-iso
|
pankso@117
|
119 </pre>
|
pankso@128
|
120
|
pankso@117
|
121 <a name="gen-initiso"></a>
|
pankso@117
|
122 <h3><font color="#6c0023">gen-initiso</font></h3>
|
pankso@117
|
123 <p>
|
pankso@117
|
124 The 'gen'initso' command will do the same work as 'gen-iso',
|
pankso@117
|
125 but it rebuilds the initramfs compressed system prior.
|
pankso@117
|
126 The initramfs contains the root filesystem and
|
pankso@117
|
127 must be rebuilt if modified:
|
pankso@117
|
128 </p>
|
pankso@117
|
129 <pre>
|
pankso@117
|
130 # tazlito gen-initiso
|
pankso@117
|
131 </pre>
|
pankso@128
|
132
|
pankso@117
|
133 <a name="list-flavors"></a>
|
pankso@117
|
134 <h3><font color="#6c0023">list-flavors</font></h3>
|
pankso@117
|
135 <p>
|
pankso@117
|
136 The 'list-flavors' command downloads (if necessary) and displays
|
pankso@117
|
137 a list of the different flavors available. You can force the
|
pankso@117
|
138 download with the --recharge option:
|
pankso@117
|
139 </p>
|
pankso@117
|
140 <pre>
|
pankso@117
|
141 # tazlito list-flavors
|
pankso@117
|
142 # tazlito list-flavors --recharge
|
pankso@117
|
143 </pre>
|
pankso@128
|
144
|
pankso@117
|
145 <a name="get-flavors"></a>
|
pankso@117
|
146 <h3><font color="#6c0023">get-flavor</font></h3>
|
pankso@117
|
147 <p>
|
pankso@117
|
148 The 'get-flavor' command downloads (if necessary) and prepares the
|
pankso@117
|
149 files for 'gen-distro' to generate a flavor:
|
pankso@117
|
150 </p>
|
pankso@117
|
151 <pre>
|
pankso@117
|
152 # tazlito get-flavor particular-flavor
|
pankso@117
|
153 </pre>
|
pankso@128
|
154
|
pankso@117
|
155 <a name="show-flavors"></a>
|
pankso@117
|
156 <h3><font color="#6c0023">show-flavor</font></h3>
|
pankso@117
|
157 <p>
|
pankso@117
|
158 The 'show-flavor' command displays the description of the
|
pankso@117
|
159 flavor and its size after regeneration. The options
|
pankso@117
|
160 --brief and --noheader reduce the output displayed:
|
pankso@117
|
161 </p>
|
pankso@117
|
162 <pre>
|
pankso@117
|
163 # tazlito show-flavor particular-flavor
|
pankso@117
|
164 # tazlito show-flavor particular-flavor --brief
|
pankso@117
|
165 # tazlito show-flavor particular-flavor --brief --noheader
|
pankso@117
|
166 </pre>
|
pankso@128
|
167
|
pankso@117
|
168 <a name="gen-flavor"></a>
|
pankso@117
|
169 <h3><font color="#6c0023">gen-flavor</font></h3>
|
pankso@117
|
170 <p>
|
pankso@117
|
171 The 'gen-flavor' command creates a description file of a new
|
pankso@117
|
172 flavor from the results of generating a distro (gen-distro).
|
pankso@117
|
173 The .flavor file can then be sent to slitaz.org:
|
pankso@117
|
174 </p>
|
pankso@117
|
175 <pre>
|
pankso@117
|
176 # tazlito gen-flavor new-flavor
|
pankso@117
|
177 </pre>
|
pankso@128
|
178
|
pankso@117
|
179 <a name="gen-liveflavor"></a>
|
pankso@117
|
180 <h3><font color="#6c0023">gen-liveflavor</font></h3>
|
pankso@117
|
181 <p>
|
pankso@117
|
182 The 'gen-liveflavor' command creates a description file of a new
|
pankso@117
|
183 flavor from the results of generating a distro based on the
|
pankso@117
|
184 current system. The --help option provides more information:
|
pankso@117
|
185 </p>
|
pankso@117
|
186 <pre> # tazlito gen-liveflavor
|
pankso@117
|
187 # tazlito gen-liveflavor --help
|
pankso@117
|
188 </pre>
|
pankso@128
|
189
|
pascal@158
|
190 <a name="upgrade-flavor"></a>
|
pascal@158
|
191 <h3><font color="#6c0023">upgrade-flavor</font></h3>
|
pascal@158
|
192 <p>
|
pascal@158
|
193 The `upgrade-flavor' command refreshes a flavor file by updating the
|
pascal@158
|
194 list of packages with the latest versions available:
|
pascal@158
|
195 </p>
|
pascal@158
|
196 <pre>
|
pascal@158
|
197 # tazlito upgrade-flavor this-flavor
|
pascal@158
|
198 </pre>
|
pascal@158
|
199
|
pascal@158
|
200 <a name="extract-flavor"></a>
|
pascal@158
|
201 <h3><font color="#6c0023">extract-flavor</font></h3>
|
pascal@158
|
202 <p>
|
pascal@158
|
203 The 'extract-flavor' command converts a flavor into an easily modifiable
|
pascal@158
|
204 tree structure in /home/slitaz/flavors which can be managed with
|
pascal@158
|
205 mercurial:
|
pascal@158
|
206 <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
|
pascal@158
|
207 </p>
|
pascal@158
|
208 <pre>
|
pascal@158
|
209 # tazlito extract-flavor this-flavor
|
pascal@158
|
210 </pre>
|
pascal@158
|
211
|
pascal@158
|
212 <a name="pack-flavor"></a>
|
pascal@158
|
213 <h3><font color="#6c0023">pack-flavor</font></h3>
|
pascal@158
|
214 <p>
|
pascal@158
|
215 The 'pack-flavor' command converts a tree structure in /home/slitaz/flavors
|
pascal@158
|
216 into a flavor file (.flavor). It is inverse of 'tazlito extract-flavor':
|
pascal@158
|
217 </p>
|
pascal@158
|
218 <pre>
|
pascal@158
|
219 # tazlito pack-flavor this-flavor
|
pascal@158
|
220 </pre>
|
pascal@158
|
221
|
pankso@117
|
222 <a name="extract-distro"></a>
|
pankso@117
|
223 <h3><font color="#6c0023">extract-distro</font></h3>
|
pankso@117
|
224 <p>
|
pankso@117
|
225 The 'extract-distro' command is used to extract an ISO image
|
pankso@117
|
226 from the LiveCD to rebuild the structure of the root cdrom
|
pankso@117
|
227 and system. It is then possible to make the desired changes
|
pankso@117
|
228 or additions and rebuild the ISO image via 'gen-iso' or
|
pankso@117
|
229 'gen-initiso'. Example of use:
|
pankso@117
|
230 </p>
|
pankso@117
|
231 <pre>
|
pankso@117
|
232 # tazlito extract-distro slitaz-cooking.iso
|
pankso@117
|
233 </pre>
|
pankso@128
|
234
|
pankso@117
|
235 <a name="gen-distro"></a>
|
pankso@117
|
236 <h3><font color="#6c0023">gen-distro</font></h3>
|
pankso@117
|
237 <p>
|
pankso@117
|
238 The <em>Generate Distribution</em> command can generate the
|
pankso@117
|
239 distro-tree and an ISO image via a list of packages. To function,
|
pankso@117
|
240 this command needs a list of packages, a directory containing
|
pankso@117
|
241 all the (.tazpkg) packages on the list, and a directory to
|
pankso@117
|
242 generate the distribution. The list of packages can be extracted
|
pankso@117
|
243 from a flavor by the 'get-flavor' command. If one uses the
|
pankso@117
|
244 LiveCD, the options --cdrom and --iso= permit the regeneration
|
pankso@117
|
245 of packages that place files in /boot without being obliged
|
pankso@117
|
246 to download them and recovers the additional files of the
|
pankso@117
|
247 LiveCD. The path to the various directories are configured
|
pankso@117
|
248 in the configuration file and packages can be downloaded
|
pankso@117
|
249 from the SliTaz mirrors or generated by Tazwok. To generate
|
pankso@117
|
250 a distribution:
|
pankso@117
|
251 </p>
|
pankso@117
|
252 <pre>
|
pankso@117
|
253 # tazlito gen-distro
|
pankso@117
|
254 # tazlito gen-distro --cdrom
|
pankso@117
|
255 # tazlito gen-distro --iso=slitaz.iso
|
pankso@117
|
256 # tazlito gen-distro package-list
|
pankso@117
|
257 </pre>
|
pankso@128
|
258
|
pankso@117
|
259 <a name="clean-distro"></a>
|
pankso@117
|
260 <h3><font color="#6c0023">clean-distro</font></h3>
|
pankso@117
|
261 <p>
|
pankso@117
|
262 Removes all files generated or extracts of the structure
|
pankso@117
|
263 of the LiveCD:
|
pankso@117
|
264 </p>
|
pankso@117
|
265 <pre>
|
pankso@117
|
266 # tazlito clean-distro
|
pankso@117
|
267 </pre>
|
pankso@128
|
268
|
pankso@117
|
269 <a name="check-distro"></a>
|
pankso@117
|
270 <h3><font color="#6c0023">check-distro</font></h3>
|
pankso@117
|
271 <p>
|
pankso@117
|
272 This command simply verifies if files installed
|
pankso@117
|
273 by the packages are present on the system:
|
pankso@117
|
274 </p>
|
pankso@117
|
275 <pre>
|
pankso@117
|
276 # tazlito check-distro
|
pankso@117
|
277 </pre>
|
pankso@128
|
278
|
pankso@128
|
279 <a name="writeiso"></a>
|
pankso@128
|
280 <h3><font color="#6c0023">writeiso</font></h3>
|
pankso@128
|
281 <p>
|
paul@153
|
282 This command will write the current filesystem to a cpio archive
|
paul@153
|
283 (rootfs.gz) and then generate a bootable ISO image. Writeiso can
|
paul@153
|
284 be used in a HD install or in live mode and will also archive your
|
paul@153
|
285 current /home directory. This command lets you easily remaster and
|
paul@153
|
286 build your own LiveCD image, just boot, modify any files, and then:
|
paul@153
|
287
|
pankso@128
|
288 </p>
|
pankso@128
|
289 <pre>
|
pankso@128
|
290 # tazlito writeiso [gzip|lzma|none]
|
pankso@128
|
291 # tazlito writeiso gzip
|
pankso@128
|
292 # tazlito writeiso gzip image-name
|
pankso@128
|
293 </pre>
|
pankso@128
|
294
|
pankso@128
|
295 <a name="frugal-install"></a>
|
paul@153
|
296 <h3><font color="#6c0023">frugal-install</font></h3>
|
pankso@128
|
297 <p>
|
paul@153
|
298 Perfom a frugal installation into /boot/frugal and add a GRUB entry
|
paul@153
|
299 if needed. Frugal mode will make SliTaz work completely in memory
|
paul@153
|
300 (RAM) - useful to test a distro without burning an ISO or to have a
|
paul@153
|
301 rescue system ready to use when the computer powers on. To install
|
paul@153
|
302 all needed files from a distro tree or an ISO image:
|
pankso@128
|
303 </p>
|
pankso@128
|
304 <pre>
|
pankso@128
|
305 # tazlito frugal-install
|
pankso@128
|
306 # tazlito -fi slitaz.iso
|
pankso@128
|
307 </pre>
|
pankso@128
|
308
|
pascal@158
|
309 <a name="check-list"></a>
|
pascal@158
|
310 <h3><font color="#6c0023">check-list</font></h3>
|
pascal@158
|
311 <p>
|
pascal@158
|
312 Checks if the distro-packages.list is updated with the latest package
|
paul@159
|
313 versions:
|
pascal@158
|
314 </p>
|
pascal@158
|
315 <pre>
|
pascal@158
|
316 # tazlito check-list
|
pascal@158
|
317 </pre>
|
pascal@158
|
318
|
pascal@158
|
319 <a name="repack"></a>
|
pascal@158
|
320 <h3><font color="#6c0023">repack</font></h3>
|
pascal@158
|
321 <p>
|
pascal@158
|
322 Recompresses the rootfs with the best possible compression:
|
pascal@158
|
323 </p>
|
pascal@158
|
324 <pre>
|
pascal@158
|
325 # tazlito repack slitaz.iso
|
pascal@158
|
326 </pre>
|
pascal@158
|
327
|
pascal@158
|
328 <a name="merge"></a>
|
pascal@158
|
329 <h3><font color="#6c0023">merge</font></h3>
|
pascal@158
|
330 <p>
|
pascal@158
|
331 Combines several flavors like nested Russian dolls. Each rootfs is a
|
pascal@158
|
332 subset of the previous. The first rootfs is extracted from the ISO image
|
pascal@158
|
333 used in the third argument. The flavor will then be chosen to launch at
|
pascal@158
|
334 startup according to the amount of RAM available:
|
pascal@158
|
335 </p>
|
pascal@158
|
336 <pre>
|
pascal@158
|
337 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
|
pascal@158
|
338 </pre>
|
pascal@158
|
339
|
pascal@171
|
340 <a name="build-loram"></a>
|
pascal@171
|
341 <h3><font color="#6c0023">build-loram</font></h3>
|
pascal@171
|
342 <p>
|
pascal@171
|
343 Creates a ISO image flavor for low ram system from a SliTaz ISO image.
|
pascal@171
|
344 You can build a flavor with / always in ram or where / may stay on cdrom.
|
pascal@171
|
345 </p>
|
pascal@171
|
346 <pre>
|
pascal@171
|
347 # tazlito build-loram slitaz.iso loram.iso
|
pascal@171
|
348 # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom
|
pascal@171
|
349 </pre>
|
pascal@171
|
350
|
paul@121
|
351 <a name="emu-iso"></a>
|
paul@121
|
352 <h3><font color="#6c0023">emu-iso</font></h3>
|
paul@121
|
353 <p>
|
paul@121
|
354 The emu-iso command uses the Qemu emulator to start and run SliTaz.
|
paul@121
|
355 Qemu is used to test the newly built ISO image without burning to a
|
pascal@158
|
356 cdrom or booting into frugal mode:
|
paul@121
|
357 </p>
|
paul@121
|
358 <pre>
|
paul@121
|
359 # tazlito emu-iso
|
paul@121
|
360 # tazlito emu-iso path/to/image.iso
|
paul@121
|
361 </pre>
|
pankso@128
|
362
|
pankso@117
|
363 <a name="burn-iso"></a>
|
pankso@117
|
364 <h3><font color="#6c0023">burn-iso</font></h3>
|
pankso@117
|
365 <p>
|
pankso@117
|
366 Burn-iso will guess the cdrom device and its speed, and wodim
|
pankso@117
|
367 (part of cdrkit) will begin to burn an ISO image. The default
|
pankso@117
|
368 ISO image is the one in the current configuration file,
|
pankso@117
|
369 but it's possible to specify a different image via the
|
pankso@117
|
370 command line:
|
pankso@117
|
371 </p>
|
pankso@117
|
372 <pre>
|
pankso@117
|
373 # tazlito burn-iso
|
pankso@117
|
374 # tazlito burn-iso slitaz-hacked.iso
|
pankso@117
|
375 </pre>
|
pankso@117
|
376
|
pascal@158
|
377 <h2>FLAVORS</h2>
|
pascal@158
|
378 <p>
|
pascal@158
|
379 A <i>.flavor</i> file contains just a few KB of information needed to
|
pascal@158
|
380 (re)manufacture a custom LiveCD of SliTaz.
|
pascal@158
|
381 </p>
|
pascal@158
|
382
|
pascal@158
|
383 <a name="rebuild-flavor"></a>
|
pascal@158
|
384 <h3><font color="#6c0023">Manufacture a flavor</font></h3>
|
pascal@158
|
385 <p>
|
pascal@158
|
386 You can choose the flavor to (re)manufacture from among those available:
|
pascal@158
|
387 </p>
|
pascal@158
|
388 <pre>
|
pascal@158
|
389 # tazlito list-flavors
|
pascal@158
|
390
|
pascal@158
|
391 List of flavors
|
pascal@158
|
392 ================================================================================
|
pascal@158
|
393 Name ISO Rootfs Description
|
pascal@158
|
394 ================================================================================
|
pascal@158
|
395 base 6.9M 13.1M Minimal set of packages to boot
|
pascal@158
|
396 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
|
pascal@158
|
397 core 31.5M 104.6M SliTaz core system
|
pascal@158
|
398 eeepc 31.2M 105.4M SliTaz eeepc system
|
paul@159
|
399 justX 16.1M 51.2M SliTaz with a minimal X environment
|
pascal@158
|
400 </pre>
|
pascal@158
|
401 <p>
|
pascal@158
|
402 We will start by remanufacturing the <i>eeepc</i> flavor which uses 105.4M of RAM
|
paul@159
|
403 and has a CD-ROM size of 31.2M:
|
pascal@158
|
404 </p>
|
pascal@158
|
405 <pre>
|
pascal@158
|
406 # tazlito clean-distro
|
pascal@158
|
407 # tazlito get-flavor eeepc
|
pascal@158
|
408 # tazlito gen-distro
|
pascal@158
|
409 </pre>
|
pascal@158
|
410
|
pascal@158
|
411 <a name="create-flavor"></a>
|
pascal@158
|
412 <h3><font color="#6c0023">Create a flavor</font></h3>
|
pascal@158
|
413 <p>
|
pascal@158
|
414 To create a flavor, you must:
|
pascal@158
|
415 </p>
|
pascal@158
|
416 <ul>
|
pascal@158
|
417 <li>Either create an ISO image with <b>tazlito gen-distro</b> and then create
|
pascal@158
|
418 a flavor file with <b>tazlito gen-flavor</b></li>
|
pascal@158
|
419 <li>Either directly create the tree structure that defines the flavor
|
pascal@158
|
420 (see <b>tazlito extract-flavor</b>) and then create the flavor with
|
pascal@158
|
421 <b>tazlito pack-flavor</b></li>
|
pascal@158
|
422 </ul>
|
pascal@158
|
423
|
pascal@158
|
424 <a name="publish-flavor"></a>
|
pascal@158
|
425 <h3><font color="#6c0023">Post a flavor</font></h3>
|
pascal@158
|
426 <p>
|
pascal@158
|
427 Because a .flavor file contains just a few KB; it can be easily sent via the
|
pascal@158
|
428 mailing list.
|
pascal@158
|
429 </p>
|
pascal@158
|
430 <p>
|
pascal@158
|
431 The results of <b>tazlito extract flavor</b> can also be put in mercurial
|
pascal@158
|
432 (http://repos.slitaz.org/flavors). This method is preferred because the
|
pascal@167
|
433 tree will be directly visible with the
|
pascal@167
|
434 <a href="http://hg.slitaz.org/flavors/file/tip">mercurial web interface</a>.
|
pascal@158
|
435 </p>
|
pascal@158
|
436 <p>
|
pascal@158
|
437 This tree includes:
|
paul@159
|
438 </p>
|
pascal@158
|
439 <ul>
|
pascal@158
|
440 <li>
|
paul@159
|
441 A <b>receipt</b> file describing the flavor thanks to the variables:
|
pascal@158
|
442 <ul>
|
pascal@158
|
443 <li>
|
pascal@158
|
444 FLAVOR: The flavor name.
|
pascal@158
|
445 </li>
|
pascal@158
|
446 <li>
|
pascal@158
|
447 SHORT_DESC: Short description.
|
pascal@158
|
448 </li>
|
pascal@158
|
449 <li>
|
pascal@158
|
450 VERSION: Free format.
|
pascal@158
|
451 </li>
|
pascal@158
|
452 <li>
|
pascal@158
|
453 MAINTAINER: Email address of maintainer.
|
pascal@158
|
454 </li>
|
pascal@158
|
455 <li>
|
paul@159
|
456 FRUGAL_RAM: Minimum RAM required (optional).
|
pascal@158
|
457 </li>
|
pascal@158
|
458 <li>
|
paul@159
|
459 ROOTFS_SIZE: Size of rootfs.gz decompressed into RAM (optional).
|
pascal@158
|
460 </li>
|
pascal@158
|
461 <li>
|
paul@159
|
462 INITRAMFS_SIZE: Size of rootfs.gz on the CD-ROM (optional).
|
pascal@158
|
463 </li>
|
pascal@158
|
464 <li>
|
paul@159
|
465 ISO_SIZE: Size of CD-ROM (optional).
|
pascal@158
|
466 </li>
|
pascal@158
|
467 <li>
|
paul@159
|
468 ROOTFS_SELECTION: Optional, see <i>Meta flavor</i> below.
|
pascal@158
|
469 </li>
|
pascal@158
|
470 </ul>
|
pascal@158
|
471 </li>
|
pascal@158
|
472 <li>
|
paul@159
|
473 The file <b>packages.list</b> containing the list of packages without
|
paul@159
|
474 specifying the version (tazlito uses the latest available).
|
paul@159
|
475 This file is missing if ROOTFS_SELECTION exists in the receipt.
|
paul@159
|
476 </li>
|
pascal@158
|
477 <li>
|
pascal@158
|
478 The optional <b>mirrors</b> file containing the list of unofficial mirrors
|
paul@159
|
479 (undigest) to be added to include personal packages.
|
pascal@158
|
480 </li>
|
pascal@158
|
481 <li>
|
pascal@158
|
482 The optional directory <b>rootfs</b> containing the tree to add to the
|
pascal@158
|
483 root filesystem rootfs.gz (configuration files usually).
|
pascal@158
|
484 </li>
|
pascal@158
|
485 <li>
|
pascal@158
|
486 The optional directory <b>rootcd</b> containing the tree to add to the
|
pascal@158
|
487 root of the CD-ROM.
|
pascal@158
|
488 </li>
|
pascal@158
|
489 </ul>
|
pascal@158
|
490
|
pascal@158
|
491 <a name="tune-flavor"></a>
|
pascal@158
|
492 <h3><font color="#6c0023">Adapt a flavor</font></h3>
|
pascal@158
|
493 <p>
|
pascal@158
|
494 It is often easier to modify an existing flavor than to create one from
|
pascal@158
|
495 scratch. To adapt the eeepc flavor for example:
|
pascal@158
|
496 </p>
|
pascal@158
|
497 <pre>
|
pascal@158
|
498 # tazpkg get-install mercurial
|
pascal@158
|
499 # cd /home/slitaz
|
pascal@158
|
500 # hg clone http://hg.slitaz.org/flavors
|
pascal@158
|
501 # cd flavors
|
pascal@158
|
502 # cp -a eeepc myslitaz
|
pascal@158
|
503 </pre>
|
pascal@158
|
504 <p>
|
paul@159
|
505 Files in my-slitaz can then be adapted, and:
|
pascal@158
|
506 </p>
|
pascal@158
|
507 <pre>
|
pascal@158
|
508 # tazlito pack-flavor myslitaz
|
pascal@158
|
509 </pre>
|
pascal@158
|
510 <p>
|
pascal@158
|
511 Will simply create the new flavor.
|
pascal@158
|
512 </p>
|
pascal@165
|
513 <p>
|
pascal@165
|
514 Tip: you can skip mercurial installation by extracting a flavor.
|
paul@168
|
515 Using the previous example:
|
pascal@165
|
516 </p>
|
pascal@165
|
517 <pre>
|
pascal@165
|
518 # tazlito get-flavor eeepc
|
pascal@165
|
519 # tazlito extract-flavor eeepc.flavor
|
pascal@165
|
520 # cd /home/slitaz/flavors
|
pascal@165
|
521 # cp -a eeepc myslitaz
|
pascal@165
|
522 </pre>
|
pascal@158
|
523
|
pascal@158
|
524 <a name="meta-flavor"></a>
|
pascal@158
|
525 <h3><font color="#6c0023">Meta flavor</font></h3>
|
pascal@158
|
526 <p>
|
pascal@158
|
527 A meta flavor contains several flavors like nested Russian dolls. The flavor
|
pascal@158
|
528 will be launched at startup according to the amount of RAM available.
|
pascal@158
|
529 The ROOTFS_SELECTION variable defines the minimim RAM and corresponding
|
pascal@158
|
530 flavor parameters, <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt">
|
pascal@158
|
531 example</a>:
|
pascal@158
|
532 </p>
|
pascal@158
|
533 <pre>
|
pascal@158
|
534 ROOTFS_SELECTION="160M core 96M justX 32M base"
|
pascal@158
|
535 </pre>
|
pascal@158
|
536 <p>
|
pascal@158
|
537 A meta flavor doesn't contain a list of packages (packages.list). SliTaz
|
pascal@158
|
538 kernels prior to 2.6.30 do not support meta flavors.
|
pascal@158
|
539 </p>
|
pascal@158
|
540
|
pankso@117
|
541 <h2>MAINTAINER</h2>
|
pankso@117
|
542 <p>
|
pankso@117
|
543 Christophe Lincoln <pankso at slitaz.org>
|
pankso@117
|
544 </p>
|
pankso@117
|
545
|
pankso@117
|
546 <!-- End content -->
|
pankso@117
|
547 </div>
|
pankso@117
|
548 </body>
|
pankso@117
|
549 </html>
|
pankso@117
|
550
|