tazlito annotate doc/tazlito.en.html @ rev 222

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