tazlito view doc/tazlito.pt.html @ rev 430
variable lzma history for russian dolls: 24-26 bits
| author | Pascal Bellard <pascal.bellard@slitaz.org> |
|---|---|
| date | Sun Sep 04 10:27:19 2016 +0200 (2016-09-04) |
| parents | 07b0ae7de856 |
| children | d7d87b67adeb |
line source
1 <!DOCTYPE html>
2 <html xmlns="http://www.w3.org/1999/xhtml" lang="pt">
3 <head>
4 <meta charset="utf-8" />
5 <title>Manual Tazlito — Ferramenta Live do SliTaz</title>
6 <link rel="shortcut icon" href="favicon.ico" />
7 <link rel="stylesheet" type="text/css" href="../slitaz-doc.css" />
8 <script type="text/javascript" src="../slitaz-doc.js"></script>
9 </head>
10 <body>
12 <header>
13 <h1>Manual Tazlito</h1>
14 </header>
16 <!-- Start content -->
17 <div id="content">
19 <h2>NOME</h2>
21 <p>Tazlito — SliTaz Live Tool.</p>
24 <h2>SINTAXE</h2>
26 <pre>
27 tazlito [command] [list|iso|flavor] [dir]
28 </pre>
31 <h2>DESCRIÇÃO</h2>
33 <p>Tazlito é um pequeno utilitário que extrai um LiveCD, reconstrói a imagem ISO
34 e regenera o sistema de arquivos root do LiveCD, criando uma variante (flavor)
35 da distribuição. O Tazlito também pode gerar uma distribuição a partir de uma
36 lista de pacotes previamente baixados. Para rodar, o Tazlito usa o arquivo
37 de configuração <tt>/etc/slitaz-tools/tazlito.conf</tt> ou o
38 <tt>tazlito.conf</tt> gerado pelo Tazlito no diretório atual. Este arquivo
39 especifica o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem
40 incluidos e da ISO a ser gerada. Tazlito também pode ser usado para configurar
41 um diretório contendo arquivos adicionais que serão copiados para o LiveCD na
42 geração da distribuição.</p>
44 <p>Tazlito é distribuído sobre a licença livre GNU GPL v.3, istalada por padrão
45 no SliTaz e instalada/testada com sucesso no Debian GNU/Linux. Você irá
46 encontrar informações adicionais sobre a criação de um LiveCD no Manual
47 SliTaz.</p>
50 <h2>COMANDOS</h2>
53 <h3 id="usage">usage</h3>
55 <p>O comando <code>usage</code> mostra um resumo dos comandos disponíveis com
56 uma pequena descrição:</p>
58 <pre>
59 # tazlito usage
60 </pre>
63 <h3 id="stats">stats</h3>
65 <p><code>stats</code> mostra as variáveis da configuração, os caminhos para os
66 vários arquivos e diretórios e informações sobre a imagem ISO:</p>
68 <pre>
69 # tazlito stats
70 </pre>
73 <h3 id="gen-config">gen-config</h3>
75 <p>O comando <code>gen-config</code> permite a geração do arquivo
76 de configuração pronto para ser editado. Por padrão o arquivo é criado no
77 diretório atual, mas também pode ser em outro diretório informado na linha
78 de comando:</p>
80 <pre>
81 # tazlito gen-config
82 # tazlito gen-config <em>/path/to/distro</em>
83 </pre>
86 <h3 id="configure">configure</h3>
88 <p>Este comando pode configurar o arquivo de configuração do sistema
89 ou o encontrado no diretório atual:</p>
91 <pre>
92 # tazlito configure
93 </pre>
96 <h3 id="gen-iso">gen-iso</h3>
98 <p>O comando <code>gen-iso</code> pode gerar uma nova imagem do LiveCD a partir
99 de modificações e adições ao sistema de arquivos root do CD-ROM. Para funcionar,
100 este comando precisa de um diretório que contenha a “árvore” da distribuição
101 do sistema Live. Esta “árvore” pode ser facilmente gerada com o comando
102 <a href="#extract-distro"><code>extract-distro</code></a>, modificada ou
103 reconstruida via:</p>
105 <pre>
106 # tazlito gen-iso
107 </pre>
110 <h3 id="gen-initiso">gen-initiso</h3>
112 <p>O comando <code>gen-initiso</code> faz o mesmo que o <code>gen-iso</code>,
113 mas antes ele reconstrói o sistema comprimido initramfs. O initramfs contem
114 o sistema de arquivos root e deve ser reconstruído se modificado:</p>
116 <pre>
117 # tazlito gen-initiso
118 </pre>
121 <h3 id="list-flavors">list-flavors</h3>
123 <p>Este comando baixa (se necessário) e mostra a lista de diferentes variantes
124 disponíveis. Pode-se forçar o download com a opção <code>--recharge</code>:</p>
126 <pre>
127 # tazlito list-flavors
128 # tazlito list-flavors --recharge
129 </pre>
132 <h3 id="get-flavor">get-flavor</h3>
134 <p>O comando <code>get-flavor</code> baixa (se necessário) e prepara os arquivos
135 para que o comando <a href="#gen-distro"><code>gen-distro</code></a> gere uma
136 variante:</p>
138 <pre>
139 # tazlito get-flavor <em>particular-flavor</em>
140 </pre>
143 <h3 id="show-flavor">show-flavor</h3>
145 <p>Este comando mostra a descrição da variante e seu tamanho após a regeneração.
146 As opções <code>--brief</code> e <code>--hoheader</code> reduzem a saida do
147 comando:</p>
149 <pre>
150 # tazlito show-flavor <em>particular-flavor</em>
151 # tazlito show-flavor <em>particular-flavor</em> --brief
152 # tazlito show-flavor <em>particular-flavor</em> --brief --noheader
153 </pre>
156 <h3 id="gen-flavor">gen-flavor</h3>
158 <p>O comando <code>gen-flavor</code> cria um arquivo de descrição de uma nova
159 variante a partir dos resultados da regeneração da distro
160 (<a href="#gen-distro"><code>gen-distro</code></a>). O arquivo <tt>.flavor</tt>
161 pode ser enviado ao slitaz.org:</p>
163 <pre>
164 # tazlito gen-flavor <em>new-flavor</em>
165 </pre>
168 <h3 id="gen-liveflavor">gen-liveflavor</h3>
170 <p>Este comando cria um arquivo de descrição de uma nova variante a partir dos
171 resultados de geração da distro baseada no sistema atual. A opção
172 <code>--help</code> mostra mais informações</p>
174 <pre>
175 # tazlito gen-liveflavor
176 # tazlito gen-liveflavor --help
177 </pre>
180 <h3 id="upgrade-flavor">upgrade-flavor</h3>
182 <p>Este comando renova um arquivo flavor, atualizando a lista de pacotes com
183 a versão mais recente disponível no mirror:</p>
185 <pre>
186 # tazlito upgrade-flavor <em>this-flavor</em>
187 </pre>
190 <h3 id="extract-flavor">extract-flavor</h3>
192 <p>O comando <code>extract-flavor</code> converte um flavor em uma estrutura
193 de pastas facilmente modificável em <tt>/home/slitaz/VERSION/flavors</tt> que
194 pode ser ser gerenciada com o mercurial:
195 <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.</p>
197 <pre>
198 # tazlito extract-flavor <em>this-flavor</em>
199 </pre>
202 <h3 id="pack-flavor">pack-flavor</h3>
204 <p>Este comando converte uma estrutura de pastas encontrada em
205 <tt>/home/slitaz/VERSION/flavors</tt> em um arquivo de variante
206 (<tt>.flavor</tt>). É o inverso do que o comando
207 <a href="#extract-flavor"><code>extract-flavor</code></a> faz:</p>
209 <pre>
210 # tazlito pack-flavor <em>this-flavor</em>
211 </pre>
214 <h3 id="extract-distro">extract-distro</h3>
216 <p>Este comando é usado para extrair uma imagem ISO do LiveCD e reconstruir a
217 estrutura do CD-ROM e sistema root. Isto possibilita fazer as mudanças
218 desejadas, adições e reconstruções da imagem ISO por meio do comando
219 <a href="#gen-iso"><code>gen-iso</code></a> ou
220 <a href="#gen-initiso"><code>gen-initiso</code></a>. Exemplo de uso:</p>
222 <pre>
223 # tazlito extract-distro <em>slitaz-cooking.iso</em>
224 </pre>
227 <h3 id="gen-distro">gen-distro</h3>
229 <p>O comando para <em>Geração de Distribuição</em> pode gerar a árvore
230 da distribuição e a imagem ISO por meio de uma lista de pacotes. Para funcionar,
231 este comando precisa da lista de pacotes, um diretório contendo todos os pacotes
232 <tt>.tazpgk</tt> especificados na lista e um diretório para gerar
233 a distribuição. A lista de pacotes pode ser extraida de uma variante pelo
234 comando <a href="#get-flavor"><code>get-flavor</code></a>. Ao se utilizar
235 o LiveCD, as opções <tt>--cdrom</tt> e <tt>--iso=</tt> permitem a regeneração
236 dos pacotes que adicionam arquivos ao diretório <tt>/boot</tt> sem que seja
237 necessário o download dos mesmos e recuperam os arquivos adicionais do LiveCD.
238 O caminho para os vários diretórios é informado no arquivo de configuração e os
239 pacotes podem ser baixados dos mirrors do SliTaz ou gerados pelo Cookutils. Para
240 gerar uma distribuição:</p>
242 <pre>
243 # tazlito gen-distro
244 # tazlito gen-distro --cdrom
245 # tazlito gen-distro --iso=<em>slitaz.iso</em>
246 # tazlito gen-distro <em>package-list</em>
247 </pre>
250 <h3 id="clean-distro">clean-distro</h3>
252 <p>Remove todos os arquivos gerados ou extraidos da estrutura do LiveCD:</p>
254 <pre>
255 # tazlito clean-distro
256 </pre>
259 <h3 id="check-distro">check-distro</h3>
261 <p>Este comando simplesmente verifica se os arquivos instalados pelos pacotes
262 estão presentes no sistema:</p>
264 <pre>
265 # tazlito check-distro
266 </pre>
269 <h3 id="writeiso">writeiso</h3>
271 <p>Este comando irá converter o sistema de arquivos atual em um arquivo cpio
272 (<tt>rootfs.gz</tt>) e então gerar uma imagem ISO inicializável. Pode ser usado
273 tanto em instalações no HD quanto em modo LiveCD, e irá arquivar também
274 o conteúdo do diretório <tt>/home</tt>. Com ele, pode-se facilmente remasterizar
275 e construir sua própria imagem de LiveCD. Para tanto inicie o sistema, modifique
276 arquivos, instale pacotes e então:</p>
278 <pre>
279 # tazlito writeiso [gzip|lzma|none]
280 # tazlito writeiso gzip
281 # tazlito writeiso gzip <em>image-name</em>
282 </pre>
285 <h3 id="check-list">check-list</h3>
287 <p>Verifica se o arquivo <tt>distro-packages.list</tt> está atualizado com as
288 mais recentes versões dos pacotes:</p>
290 <pre>
291 # tazlito check-list
292 </pre>
295 <h3 id="repack">repack</h3>
297 <p>Comprime novamente o rootfs com a melhor compressão possível:</p>
299 <pre>
300 # tazlito repack <em>slitaz.iso</em>
301 </pre>
304 <h3 id="merge">merge</h3>
306 <p>Combina diversas variantes. Cada rootfs é uma consequência de seu anterior.
307 O primeiro rootfs é extraido da imagem ISO indicada como terceiro argumento. As
308 variantes serão escolhidas no momento do boot, de acordo com a memória RAM
309 disponível:</p>
311 <pre>
312 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
313 </pre>
316 <h3 id="build-loram">build-loram</h3>
318 <p>Cria uma variante para sistemas com pouca memória RAM à partir de uma imagem
319 ISO do SliTaz. Pode-se gerar uma variante que seja carregada na diretamente
320 na memória ou lida a partir do CD-ROM:</p>
322 <pre>
323 # tazlito build-loram <em>slitaz.iso loram.iso</em>
324 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
325 </pre>
328 <h3 id="emu-iso">emu-iso</h3>
330 <p>O comando <code>emu-iso</code> utiliza o emulador Qemu para iniciar e rodar
331 o SliTaz. É util para testar a ISO criada sem a necessidade de gravá-la em um
332 CD-ROM ou bootar em modo frugal.</p>
334 <pre>
335 # tazlito emu-iso
336 # tazlito emu-iso <em>path/to/image.iso</em>
337 </pre>
340 <h3 id="burn-iso">burn-iso</h3>
342 <p>O comando <code>burn-iso</code> obtém informações sobre o dispositivo de CD
343 e as velocidades permitidas para gravação, e o wodim (parte do cdrkit) inicia
344 para gravar a imagem ISO. A imagem ISO padrão é aquela especificada no arquivo
345 de configuração, mas é possível especificar uma imagem diferente por meio
346 da linha de comando:</p>
348 <pre>
349 # tazlito burn-iso
350 # tazlito burn-iso <em>slitaz-hacked.iso</em>
351 </pre>
354 <h2>FLAVORS</h2>
356 <p>Um arquivo <tt>.flavor</tt> contém somente alguns poucos Kb de informação
357 necessária para (re)construir um LiveCD customizado do SliTaz.</p>
360 <h3 id="rebuild-flavor">(Re)construa uma variante</h3>
362 <p>Você pode escolher uma variante para (re)construir a partir daquelas
363 disponíveis:</p>
365 <pre>
366 # tazlito list-flavors
368 List of flavors
369 ================================================================================
370 Name ISO Rootfs Description
371 ================================================================================
372 base 6.9M 13.1M Minimal set of packages to boot
373 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
374 core 31.5M 104.6M SliTaz core system
375 eeepc 31.2M 105.4M SliTaz eeepc system
376 justX 16.1M 51.2M SliTaz with a minimal X environment
377 </pre>
379 <p>Como exeplo, começaremos a reconstruir a variante <em>eeepc</em> que ocupa
380 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M:</p>
382 <pre>
383 # tazlito clean-distro
384 # tazlito get-flavor <em>eeepc</em>
385 # tazlito gen-distro
386 </pre>
389 <h3 id="create-flavor">Crie uma variante</h3>
391 <p>Para criar uma variante, você deve:</p>
393 <ul>
394 <li>Criar uma imagem ISO usando o comando
395 <a href="#gen-distro"><code>tazlito gen-distro</code></a> e então criar
396 um arquivo flavor usando
397 <a href="#gen-flavor"><code>tazlito gen-flavor</code></a>; ou</li>
398 <li>Criar diretamente uma estrutura de arquivos que define o flavor (veja
399 <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>)
400 e então criar o flavor usando
401 <a href="#pack-flavor"><code>tazlito pack-flavor</code></a>.</li>
402 </ul>
405 <h3 id="publish-flavor">Publique uma variante</h3>
407 <p>Um arquivo <tt>.flavor</tt> possui alguns Kb de tamanho, então você pode
408 enviá-lo para <a href="http://www.slitaz.org/pt/mailing-list.php">a lista de
409 discussão</a> do SliTaz.</p>
411 <p>Os arquivos resultantes do comando <a href="#extract-flavor"><code>tazlito
412 extract-flavor</code></a> pode também ser colocado no repositório
413 <a href="http://hg.slitaz.org/flavors">mercurial</a>. Este método é preferido
414 porque a estrutura de pastas poderá ser acessada diretamente por uma
415 <a href="http://hg.slitaz.org/flavors/file/tip">interface web</a>.</p>
416 <p>Esta estrutura inclui:</p>
418 <ul>
419 <li>Uma <b>receita</b> (arquivo <em>receipt</em>) que descreve a variante
420 por intermédio das variáveis:
421 <ul>
422 <li>FLAVOR: O nome da variante.</li>
423 <li>SHORT_DESC: Uma curta descrição</li>
424 <li>VERSION: Versão.</li>
425 <li>MAINTAINER: Email do desenvolvedor/criador.</li>
426 <li>FRUGAL_RAM: Memória RAM mínima recomendável (variável
427 opcional).</li>
428 <li>ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM
429 (opcional).</li>
430 <li>INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CD-ROM
431 (opcional).</li>
432 <li>ISO_SIZE: Tamanho do CD-ROM (opcional).</li>
433 <li>ROOTFS_SELECTION: Opcional, veja <a href="#meta-flavor">Meta
434 flavor</a> abaixo.</li>
435 </ul>
436 </li>
437 <li>O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar
438 uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis).
439 Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja
440 definida.</li>
441 <li>O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais
442 (undigest) a serem incluidos para se obter pacotes personalizados.</li>
443 <li>O diretório opcional <b>rootfs</b> contem uma estrutura de pastas
444 e arquivos a serem adicionados ao sistema de arquivos rootfs.gz
445 (normalmente serão arquivos de configuração).</li>
446 <li>O diretório opcional <b>rootcd</b> contem uma estrutura de pastas
447 e arquivos a serem adicionados ao CD-ROM.</li>
448 </ul>
451 <h3 id="tune-flavor">Adapte uma variante</h3>
453 <p>Às vezes é mais fácil modificar uma variante existente do que criar uma nova.
454 Para adaptar a variante eeepc, por exemplo:</p>
456 <pre>
457 # tazpkg get-install mercurial
458 # cd /home/slitaz
459 # hg clone http://hg.slitaz.org/flavors
460 # cd flavors
461 # cp -a <em>eeepc myslitaz</em>
462 </pre>
464 <p>Arquivos em <tt>my-slitaz</tt> podem ser adaptados, então:</p>
466 <pre>
467 # tazlito pack-flavor <em>myslitaz</em>
468 </pre>
470 <p>Isto irá criar uma nova variante adaptada de uma outra existente.</p>
471 <p>Dica: Pode-se evitar a instalação do mercurial extraindo-se uma variante.
472 Usando o exemplo anterior:</p>
474 <pre>
475 # tazlito get-flavor eeepc
476 # tazlito extract-flavor eeepc.flavor
477 # cd /home/slitaz/flavors
478 # cp -a <em>eeepc myslitaz</em>
479 </pre>
482 <h3 id="meta-flavor">Meta flavor</h3>
484 <p>Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se
485 iniciar o sistema com uma meta variante, uma variante contida no LiveCD irá ser
486 chamada dependendo do tamanho da memória RAM disponível. A variável
487 ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os parametros das
488 variantes existentes.
489 <a href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">Exemplo</a>
490 usando a meta variante:</p>
492 <pre>
493 ROOTFS_SELECTION="160M core 96M justX 32M base"
494 </pre>
496 <p>Este tipo de variante não possui uma lista de pacotes
497 (<tt>packages.list</tt>) e só é suportada no SliTaz a partir do kernel
498 2.6.30.</p>
501 <h2>MANTENEDOR</h2>
503 <p>Christophe Lincoln <pankso at slitaz.org><br />
504 Pascal Bellard <pascal.bellard at slitaz.org></p>
506 <!-- End content -->
507 </div>
509 <footer>
510 Copyright © 2014 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
511 </footer>
513 </body>
514 </html>