tazlito view doc/tazlito.es.html @ rev 509
Take care of installed /boot/isolinux/efi.img
| author | Pascal Bellard <pascal.bellard@slitaz.org> |
|---|---|
| date | Sun Jun 03 14:17:50 2018 +0200 (2018-06-03) |
| parents | 89970ab334f1 |
| children |
line source
1 <!DOCTYPE html>
2 <html lang="es">
3 <head>
4 <meta charset="UTF-8">
5 <meta name="author" content="Patryk Augustyn">
6 <title>Manual de Tazlito - Herramienta de SliTaz Live</title>
7 <link rel="shortcut icon" href="favicon.ico">
8 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css">
9 <script type="text/javascript" src="../slitaz-doc.js"></script>
10 </head>
11 <body>
13 <header>
14 <h1>Manual de Tazlito</h1>
15 </header>
17 <!-- Start content -->
18 <div id="content">
20 <h2>NOMBRE</h2>
22 <p>Tazlito - Herramienta de SliTaz Live.</p>
25 <h2>SINTAXIS</h2>
27 <pre>
28 tazlito [comando] [lista|iso|flavor] [directorio]
29 </pre>
32 <h2>DESCRIPCIÓN</h2>
34 <p>Tazlito es una pequeña utilidad para extraer un LiveCD, reconstruir la imagen
35 ISO y regenerar el sistema de archivos raíz del LiveCD. Tazlito también puede generar una
36 distribución a partir de una lista de paquetes previamente descargados. Para
37 ejecutarse, Tazlito usa el archivo de configuración <tt>/etc/tazlito/tazlito.conf</tt> o
38 un fichero <tt>tazlito.conf</tt> fácil de generar, que buscará en el directorio
39 actual. Especifica el nombre de la ISO, volumen, mantenedor y las rutas de
40 los paquetes a distribuir y de la ISO generada.
41 A Tazlito también se le puede indicar un directorio que contenga archivos adicionales
42 que serán copiados al LiveCD cuando se genere la distribución.</p>
43 <p>Tazlito se distribuye bajo la licencia libre GNU GPL V3, instalado por defecto
44 en SliTaz e instalado/probado con éxito en Debian GNU/Linux.Encontrarás
45 información adicional de como crear un LiveCD en el manual.</p>
48 <h2>COMANDOS</h2>
51 <h3 id="usage">usage</h3>
53 <p>El comando <code>usage</code> muestra un sumario de los comandos disponibles con una
54 breve descripción.</p>
56 <pre>
57 # tazlito usage
58 </pre>
61 <h3 id="stats">stats</h3>
63 <p>El comando <code>stats</code> muestra las variables de configuración, las rutas a los
64 distintos archivos y directorios, e información de la imagen ISO:</p>
66 <pre>
67 # tazlito stats
68 </pre>
71 <h3 id="gen-config">gen-config</h3>
73 <p>El comando <code>gen-config</code> permite generar un archivo de configuración preparado
74 para ser editado. Por defecto el archivo es creado en el directorio actual, pero
75 puede ser creado en otro directorio si se especifica mediante la línea de
76 comandos:</p>
78 <pre>
79 # tazlito gen-config
80 # tazlito gen-config <em>/ruta/a/distro</em>
81 </pre>
84 <h3 id="configure">configure</h3>
86 <p>Este comando configura el archivo de configuración del sistema o uno que
87 encuentre en el directorio actual:</p>
89 <pre>
90 # tazlito configure
91 </pre>
94 <h3 id="gen-iso">gen-iso</h3>
96 <p>El comando <code>gen-iso</code> puede generar una imagen nueva del LiveCD siguiendo
97 las modificaciones realizadas a la raíz del sistema de archivos del cdrom. Para
98 funcionar, este comando necesita un directorio que contenga el árbol de la
99 distribución del sistema Live. Este árbol puede ser construido
100 fácilmente con el comando <a href="#extract-distro"><code>extract-distro</code></a>, y modificado y
101 reconstruido mediante:</p>
103 <pre>
104 # tazlito gen-iso
105 </pre>
108 <h3 id="gen-initiso">gen-initiso</h3>
110 <p>El comando <code>gen-initiso</code> funciona igual que el comando <code>gen-iso</code>,
111 pero reconstruye el sistema de archivos comprimido initramfs primero. El sistema de archivos initramfs
112 contiene el sistema de archivos raíz y tiene que ser reconstruido si es modificado:</p>
114 <pre>
115 # tazlito gen-initiso
116 </pre>
119 <h3 id="list-flavors">list-flavors</h3>
121 <p>El comando <code>list-flavors</code> descarga (si es necesario) y muestra una lista de las
122 diferentes versiones personalizadas (flavors) de SliTaz disponibles. Puedes forzar
123 la descarga con la opción <code>--recharge</code>:</p>
125 <pre>
126 # tazlito list-flavors
127 # tazlito list-flavors --recharge
128 </pre>
131 <h3 id="get-flavor">get-flavor</h3>
133 <p>El comando <code>get-flavor</code> descarga (si es necesario) y prepara
134 los archivos para <a href="#gen-distro"><code>gen-distro</code></a> para generar
135 una distribución personalizada (flavor):</p>
137 <pre>
138 # tazlito get-flavor <em>nombre-version-flavor</em>
139 </pre>
142 <h3 id="show-flavors">show-flavor</h3>
144 <p>El comando <code>show-flavor</code> muestra la descripción de la versión personalizada (flavor)
145 y su tamaño después de la regeneración. Las opciones <code>--brief</code> y
146 <code>--noheader</code> reducen la información mostrada en pantalla:</p>
148 <pre>
149 # tazlito show-flavor <em>nombre-version-flavor</em>
150 # tazlito show-flavor <em>nombre-version-flavor</em> --brief
151 # tazlito show-flavor <em>nombre-version-flavor</em> --brief --noheader
152 </pre>
155 <h3 id="gen-flavor">gen-flavor</h3>
157 <p>El comando <code>gen-flavor</code> crea un archivo de descripción de una nueva
158 versión personalizada (flavor) a partir del resultado de generar una distribución
159 (<a href="#gen-distro"><code>gen-distro</code></a>). El archivo <tt>.flavor</tt>
160 se puede enviar a slitaz.org:</p>
162 <pre>
163 # tazlito gen-flavor <em>nueva-version-flavor</em>
164 </pre>
167 <h3 id="gen-liveflavor">gen-liveflavor</h3>
169 <p>El comando <code>gen-liveflavor</code> crea un archivo de descripción de una nueva versión
170 personalizada (flavor) a partir de los resultados de generar una distribución basada en el sistema
171 actual. La opción <code>--help</code> proporciona más información:</p>
173 <pre>
174 # tazlito gen-liveflavor
175 # tazlito gen-liveflavor --help
176 </pre>
179 <h3 id="upgrade-flavor">upgrade-flavor</h3>
181 <p>El comando <code>upgrade-flavor</code> refresca un archivo flavor actualizando
182 la lista de paquetes con la última versión disponible:</p>
184 <pre>
185 # tazlito upgrade-flavor <em>nombre-archivo-flavor</em>
186 </pre>
189 <h3 id="extract-flavor">extract-flavor</h3>
191 <p>El comando <code>extract-flavor</code> convierte una versión personalizada (flavor) en una estructura
192 de árbol fácilmente modificable en <tt>/home/slitaz/VERSION/flavors</tt> la cual puede ser
193 administrada con mercurial: <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
194 Por ejemplo, para 'cooking' tendrás el directorio de trabajo en <tt>/home/slitaz/cooking</tt>.</p>
196 <pre>
197 # tazlito extract-flavor <em>nombre-archivo-flavor</em>
198 </pre>
201 <h3 id="pack-flavor">pack-flavor</h3>
203 <p>El comando <code>pack-flavor</code> convierte una estructura de árbol en
204 <tt>/home/slitaz/VERSION/flavors</tt> en un archivo (<tt>.flavor</tt>).
205 Es inverso a <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>:</p>
207 <pre>
208 # tazlito pack-flavor <em>nombre-archivo-flavor</em>
209 </pre>
212 <h3 id="extract-distro">extract-distro</h3>
214 <p>El comando <code>extract-distro</code> se usa para extraer una imagen ISO
215 del LiveCD con el fin de reconstruir la estructura raíz del CD-ROM y del sistema.
216 Entonces es posible realizar los cambios o añadidos que se desee y reconstruir
217 la imagen ISO mediante <a href="#gen-iso"><code>gen-iso</code></a> or
218 <a href="#gen-initiso"><code>gen-initiso</code></a>. Ejemplo:</p>
220 <pre>
221 # tazlito extract-distro <em>slitaz-cooking.iso</em>
222 </pre>
225 <h3 id="gen-distro">gen-distro</h3>
227 <p>El comando <em>Generar distribución</em> puede generar el árbol de la distribución y
228 una imagen ISO mediante la lista de paquetes. Para funcionar, este comando
229 necesita una lista de paquetes, un directorio que contenga todos los paquetes
230 (<tt>.tazpkg</tt>) de la lista, y un directorio para generar la distribución. La lista de
231 paquetes puede ser extraída de una versión personalizada (flavor) con el comando
232 <a href="#get-flavor"><code>get-flavor</code></a>. Si se usa el LiveCD,
233 las opciones <code>--cdrom</code> y <code>--iso=</code> permiten la regeneración de los paquetes
234 que tienen archivos en <tt>/boot</tt> sin que sea necesario descargarlos y recuperar los
235 archivos adicionales del LiveCD. La ruta para los distintos directorios esta
236 configurada en el archivo de configuración y los paquetes pueden ser descargados
237 desde los espejos de SliTaz o generados con Cookutils. Para generar una
238 distribución:</p>
240 <pre>
241 # tazlito gen-distro
242 # tazlito gen-distro --cdrom
243 # tazlito gen-distro --iso=<em>slitaz.iso</em>
244 # tazlito gen-distro <em>package-list</em>
245 </pre>
248 <h3 id="clean-distro">clean-distro</h3>
250 <p>Borra todos los archivos generados o añadidos a la estructura del LiveCD:</p>
252 <pre>
253 # tazlito clean-distro
254 </pre>
257 <h3 id="check-distro">check-distro</h3>
259 <p>Este comando simplemente verifica si los archivos instalados por los paquetes
260 están presentes en el sistema:</p>
262 <pre>
263 # tazlito check-distro
264 </pre>
267 <h3 id="writeiso">writeiso</h3>
269 <p>Este comando escribirá el actual sistema de archivos en un archivo cpio
270 (<tt>rootfs.gz</tt>) y entonces generará una imagen ISO arrancable. Writeiso puede ser
271 usado en una instalación en disco duro o en modo live y también archivara tu directorio
272 <tt>/home</tt> actual. Este comando te permite remasterizar y construir tu propia
273 imagen LiveCD, solo ejecuta, modifica cualquier archivo, y entonces:</p>
275 <pre>
276 # tazlito writeiso [gzip|lzma|none]
277 # tazlito writeiso gzip
278 # tazlito writeiso gzip <em>nombre-imagen</em>
279 </pre>
281 <h3 id="check-list">check-list</h3>
283 <p>Comprueba si el archivo <tt>distro-packages.list</tt> (lista de distribución de paquetes)
284 está actualizado con las ultimas versiones de paquetes:</p>
286 <pre>
287 # tazlito check-list
288 </pre>
291 <h3 id="repack">repack</h3>
293 <p>Vuelve a comprimir el sistema de archivos raíz con la mejor compresión posible:</p>
295 <pre>
296 # tazlito repack <em>slitaz.iso</em>
297 </pre>
300 <h3 id="merge">merge</h3>
302 <p>Combina varios versiones personalizadas (flavors) como si fueran matrioskas
303 (muñecas rusas). Cada sistema de ficheros raíz es un subconjunto del anterior.
304 El primer sistema de ficheros raíz es extraído desde la imagen ISO utilizada
305 en el tercer argumento. El flavor será entonces elegido para ser ejecutado al
306 inicio conforme a la cantidad de RAM disponible:</p>
308 <pre>
309 # tazlito merge <em>160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz</em>
310 </pre>
313 <h3 id="build-loram">build-loram</h3>
315 <p>Crea una imagen ISO personalizada (flavor) para sistemas con poca RAM desde
316 una imagen ISO de SliTaz. Puedes construir un flavor con <tt>/</tt> siempre en RAM
317 o donde <tt>/</tt> esté en el CD-ROM:</p>
319 <pre>
320 # tazlito build-loram <em>slitaz.iso loram.iso</em>
321 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
322 </pre>
325 <h3 id="emu-iso">emu-iso</h3>
327 <p>El comando <code>emu-iso</code> usa el emulador Qemu para iniciar y ejecutar
328 SliTaz. Qemu se usa para probar la recién construida imagen ISO sin ser quemada
329 en un CD-ROM o ejecutada en modo frugal:</p>
331 <pre>
332 # tazlito emu-iso
333 # tazlito emu-iso ruta/a/imagen.iso
334 </pre>
337 <h3 id="burn-iso">burn-iso</h3>
339 <p>El comando <code>burn-iso</code> detectará el dispositivo CD-ROM y su velocidad,
340 y wodim (parte de cdrkit) comenzara a grabar una imagen ISO. La imagen ISO por defecto
341 es la indicada en el archivo de configuración actual, pero es posible
342 especificar otra imagen ISO mediante la linea de comandos:</p>
344 <pre>
345 # tazlito burn-iso
346 # tazlito burn-iso <em>slitaz-hacked.iso</em>
347 </pre>
350 <h2>FLAVORS</h2>
352 <p>Un archivo <tt>.flavor</tt> contiene solo unos cuantos KB de información para
353 (re)construir un LiveCD personalizado de SliTaz.</p>
356 <h3 id="rebuild-flavor">Reconstruir una versión flavor</h3>
358 <p>Puedes elegir el flavor para (re)construir entre las disponibles::</p>
360 <pre>
361 # tazlito list-flavors
363 List of flavors
364 ================================================================================
365 Nombre ISO Rootfs Descripción
366 ================================================================================
367 base 6.9M 13.1M Conjunto mínimo de paquetes para ejecutar
368 core-3in1 31.5M 105.6M Sistema central de SliTaz con justX y alternativas de base
369 core 31.5M 104.6M Sistema central de SliTaz
370 eeepc 31.2M 105.4M Sistema eeepc de SliTaz
371 justX 16.1M 51.2M SliTaz con un entorno X mínimo
372 </pre>
374 <p>Empezaremos fabricando el flavor <i>eeepc</i> que usa 105.4M de RAM y tiene
375 un tamaño en CD-ROM de 31.2M:</p>
377 <pre>
378 # tazlito clean-distro
379 # tazlito get-flavor <em>eeepc</em>
380 # tazlito gen-distro
381 </pre>
384 <h3 id="create-flavor">Crear un flavor</h3>
386 <p>Para crear un flavor, tienes que:</p>
388 <ul>
389 <li>O bien crear una imagen ISO con <a href="#gen-distro"><code>tazlito
390 gen-distro</code></a> y después crear un archivo flavor con
391 <a href="#gen-flavor"><code>tazlito gen-flavor</code></a></li>
392 <li>O bien directamente crear una estructura de árbol que defina el flavor
393 (ver <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>)
394 y entonces crear un flavor con <a href="#pack-flavor"><code>tazlito
395 pack-flavor</code></a></li>
396 <li>O bien usar el <a href="http://pizza.slitaz.org/">constructor en línea</a></li>
397 </ul>
400 <h3 id="publish-flavor">Enviar un flavor</h3>
402 <p>Como un archivo <tt>.flavor</tt> ocupa solamente unos cuantos KB, es fácil enviarlo a
403 través de la <a href="http://www.slitaz.org/en/mailing-list.php">lista de correo</a>
404 de SliTaz.</p>
406 <p>El resultado de <a href="#extract-flavor"><code>tazlito
407 extract-flavor</code></a> se puede subir a
408 <a href="http://hg.slitaz.org/flavors">mercurial</a>. Este método es
409 preferible, porque el árbol sera visible directamente con la
410 <a href="http://hg.slitaz.org/flavors/file/tip">interfaz web de mercurial</a>.</p>
411 <p>Este árbol incluye:</p>
413 <ul>
414 <li>Un archivo de <b>recibo</b> que describe el flavor gracias a las variables:
415 <ul>
416 <li>FLAVOR: El nombre del flavor.</li>
417 <li>SHORT_DESC: Descripción breve.</li>
418 <li>VERSION: Formato libre.</li>
419 <li>MAINTAINER: Correo electrónico del encargado de mantenimiento.</li>
420 <li>FRUGAL_RAM: RAM mínima requerida (opcional).</li>
421 <li>ROOTFS_SIZE: Tamaño de rootfs.gz descomprimido en la RAM (opcional).</li>
422 <li>INITRAMFS_SIZE: Tamaño del archivo rootfs.gz en el CD-ROM (opcional).</li>
423 <li>ISO_SIZE: Tamaño del CD-ROM (opcional).</li>
424 <li>ROOTFS_SELECTION: Opcional, ver <a href="#meta-flavor">Meta
425 flavor</a> debajo.</li>
426 </ul>
427 </li>
428 <li>El archivo <b>packages.list</b>, que contiene la lista de los paquetes en la que no
429 se especifica la versión (tazlito usa la ultima versión disponible). Este
430 archivo no aparecerá si ROOTFS_SELECTION existe en este fichero de recibo.</li>
431 <li>EL archivo opcional <b>mirrors</b>, que contiene la lista de espejos no
432 oficiales (undigest) para que puedas incluir paquetes personales.</li>
433 <li>El directorio opcional <b>rootfs</b> que contiene el árbol para añadirlo
434 al sistema de archivos raíz rootfs.gz (archivos de configuración normalmente).</li>
435 </li>El directorio opcional <b>rootcd</b>, que contiene el árbol para añadirlo a
436 la raíz del CD-ROM.</ul>
437 </ul>
440 <h3 id="tune-flavor">Adaptar un flavor</h3>
442 <p>A menudo es mas fácil modificar un flavor existente que crear uno desde
443 cero. Para adaptar el flavor eeepc por ejemplo:</p>
445 <pre>
446 # tazpkg get-install mercurial
447 # cd /home/slitaz
448 # hg clone http://hg.slitaz.org/flavors
449 # cd flavors
450 # cp -a <em>eeepc myslitaz</em>
451 </pre>
453 <p>Los archivos en <tt>myslitaz</tt> pueden cambiarse, y:</p>
455 <pre>
456 # tazlito pack-flavor <em>mislitaz</em>
457 </pre>
459 <p>Simplemente creará un nuevo flavor.</p>
461 <p>Sugerencia: Puedes saltarte la instalación de mercurial extrayendo un flavor
462 usando el ejemplo siguiente:</p>
464 <pre>
465 # tazlito get-flavor <em>eeepc</em>
466 # tazlito extract-flavor <em>eeepc.flavor</em>
467 # cd /home/slitaz/flavors
468 # cp -a <em>eeepc mislitaz</em>
469 </pre>
472 <h3 id="meta-flavor">Meta flavor</h3>
474 <p>Un meta flavor contiene varios flavors como una matrioska (muñecas rusas).
475 El flavor se ejecutará al inicio dependiendo de la RAM disponible. La variable
476 ROOTFS_SELECTION define el mínimo de RAM y los parámetros de flavor
477 correspondientes, <a
478 href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">ejemplo</a>:</p>
480 <pre>
481 ROOTFS_SELECTION="160M core 96M justX 32M base"
482 </pre>
484 <p>Un meta flavor no contiene una lista de paquetes (<tt>packages.list</tt>).
485 El kernel de SliTaz anterior a 2.6.30 no soporta meta flavors.</p>
488 <h2>MAINTAINER</h2>
490 <p>Christophe Lincoln <pankso en slitaz.org><br />
491 Pascal Bellard <pascal.bellard en slitaz.org></p>
493 <!-- End content -->
494 </div>
496 <footer>
497 Copyright © <span class="year"></span> <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
498 </footer>
500 </body>
501 </html>