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