tazlito view doc/tazlito.pt.html @ rev 316
Add: custom_rules function in receipt
| author | Eric Joseph-Alexandre <erjo@slitaz.org> |
|---|---|
| date | Sat Jun 08 19:25:48 2013 +0200 (2013-06-08) |
| parents | 6a319bec916a |
| children | b3041f9d49ab |
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="frugal-install">frugal-install</h3>
287 <p>Executa uma instalação frugal em <tt>/boot/frugal</tt> e adiciona uma entrada
288 ao GRUB, caso necessário. Este tipo de instalação irá rodar o SliTaz diretamente
289 na memória RAM (mesmo comportamento do LiveCD), o que permite testar a distro
290 ou ter um sistema de recuperação pronto para uso. Para instalar todos os
291 arquivos necessários a partir de uma estrutura de pastas ou de uma imagem
292 ISO:</p>
294 <pre>
295 # tazlito frugal-install
296 # tazlito -fi <em>slitaz.iso</em>
297 </pre>
300 <h3 id="check-list">check-list</h3>
302 <p>Verifica se o arquivo <tt>distro-packages.list</tt> está atualizado com as
303 mais recentes versões dos pacotes:</p>
305 <pre>
306 # tazlito check-list
307 </pre>
310 <h3 id="repack">repack</h3>
312 <p>Comprime novamente o rootfs com a melhor compressão possível:</p>
314 <pre>
315 # tazlito repack <em>slitaz.iso</em>
316 </pre>
319 <h3 id="merge">merge</h3>
321 <p>Combina diversas variantes. Cada rootfs é uma consequência de seu anterior.
322 O primeiro rootfs é extraido da imagem ISO indicada como terceiro argumento. As
323 variantes serão escolhidas no momento do boot, de acordo com a memória RAM
324 disponível:</p>
326 <pre>
327 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
328 </pre>
331 <h3 id="build-loram">build-loram</h3>
333 <p>Cria uma variante para sistemas com pouca memória RAM à partir de uma imagem
334 ISO do SliTaz. Pode-se gerar uma variante que seja carregada na diretamente
335 na memória ou lida a partir do CD-ROM:</p>
337 <pre>
338 # tazlito build-loram <em>slitaz.iso loram.iso</em>
339 # tazlito build-loram <em>slitaz.iso loram-cdrom.iso</em> cdrom
340 </pre>
343 <h3 id="emu-iso">emu-iso</h3>
345 <p>O comando <code>emu-iso</code> utiliza o emulador Qemu para iniciar e rodar
346 o SliTaz. É util para testar a ISO criada sem a necessidade de gravá-la em um
347 CD-ROM ou bootar em modo frugal.</p>
349 <pre>
350 # tazlito emu-iso
351 # tazlito emu-iso <em>path/to/image.iso</em>
352 </pre>
355 <h3 id="burn-iso">burn-iso</h3>
357 <p>O comando <code>burn-iso</code> obtém informações sobre o dispositivo de CD
358 e as velocidades permitidas para gravação, e o wodim (parte do cdrkit) inicia
359 para gravar a imagem ISO. A imagem ISO padrão é aquela especificada no arquivo
360 de configuração, mas é possível especificar uma imagem diferente por meio
361 da linha de comando:</p>
363 <pre>
364 # tazlito burn-iso
365 # tazlito burn-iso <em>slitaz-hacked.iso</em>
366 </pre>
369 <h2>FLAVORS</h2>
371 <p>Um arquivo <tt>.flavor</tt> contém somente alguns poucos Kb de informação
372 necessária para (re)construir um LiveCD customizado do SliTaz.</p>
375 <h3 id="rebuild-flavor">(Re)construa uma variante</h3>
377 <p>Você pode escolher uma variante para (re)construir a partir daquelas
378 disponíveis:</p>
380 <pre>
381 # tazlito list-flavors
383 List of flavors
384 ================================================================================
385 Name ISO Rootfs Description
386 ================================================================================
387 base 6.9M 13.1M Minimal set of packages to boot
388 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
389 core 31.5M 104.6M SliTaz core system
390 eeepc 31.2M 105.4M SliTaz eeepc system
391 justX 16.1M 51.2M SliTaz with a minimal X environment
392 </pre>
394 <p>Como exeplo, começaremos a reconstruir a variante <em>eeepc</em> que ocupa
395 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M:</p>
397 <pre>
398 # tazlito clean-distro
399 # tazlito get-flavor <em>eeepc</em>
400 # tazlito gen-distro
401 </pre>
404 <h3 id="create-flavor">Crie uma variante</h3>
406 <p>Para criar uma variante, você deve:</p>
408 <ul>
409 <li>Criar uma imagem ISO usando o comando
410 <a href="#gen-distro"><code>tazlito gen-distro</code></a> e então criar
411 um arquivo flavor usando
412 <a href="#gen-flavor"><code>tazlito gen-flavor</code></a>; ou</li>
413 <li>Criar diretamente uma estrutura de arquivos que define o flavor (veja
414 <a href="#extract-flavor"><code>tazlito extract-flavor</code></a>)
415 e então criar o flavor usando
416 <a href="#pack-flavor"><code>tazlito pack-flavor</code></a>.</li>
417 </ul>
420 <h3 id="publish-flavor">Publique uma variante</h3>
422 <p>Um arquivo <tt>.flavor</tt> possui alguns Kb de tamanho, então você pode
423 enviá-lo para <a href="http://www.slitaz.org/pt/mailing-list.php">a lista de
424 discussão</a> do SliTaz.</p>
426 <p>Os arquivos resultantes do comando <a href="#extract-flavor"><code>tazlito
427 extract-flavor</code></a> pode também ser colocado no repositório
428 <a href="http://hg.slitaz.org/flavors">mercurial</a>. Este método é preferido
429 porque a estrutura de pastas poderá ser acessada diretamente por uma
430 <a href="http://hg.slitaz.org/flavors/file/tip">interface web</a>.</p>
431 <p>Esta estrutura inclui:</p>
433 <ul>
434 <li>Uma <b>receita</b> (arquivo <em>receipt</em>) que descreve a variante
435 por intermédio das variáveis:
436 <ul>
437 <li>FLAVOR: O nome da variante.</li>
438 <li>SHORT_DESC: Uma curta descrição</li>
439 <li>VERSION: Versão.</li>
440 <li>MAINTAINER: Email do desenvolvedor/criador.</li>
441 <li>FRUGAL_RAM: Memória RAM mínima recomendável (variável
442 opcional).</li>
443 <li>ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM
444 (opcional).</li>
445 <li>INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CD-ROM
446 (opcional).</li>
447 <li>ISO_SIZE: Tamanho do CD-ROM (opcional).</li>
448 <li>ROOTFS_SELECTION: Opcional, veja <a href="#meta-flavor">Meta
449 flavor</a> abaixo.</li>
450 </ul>
451 </li>
452 <li>O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar
453 uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis).
454 Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja
455 definida.</li>
456 <li>O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais
457 (undigest) a serem incluidos para se obter pacotes personalizados.</li>
458 <li>O diretório opcional <b>rootfs</b> contem uma estrutura de pastas
459 e arquivos a serem adicionados ao sistema de arquivos rootfs.gz
460 (normalmente serão arquivos de configuração).</li>
461 <li>O diretório opcional <b>rootcd</b> contem uma estrutura de pastas
462 e arquivos a serem adicionados ao CD-ROM.</li>
463 </ul>
466 <h3 id="tune-flavor">Adapte uma variante</h3>
468 <p>Às vezes é mais fácil modificar uma variante existente do que criar uma nova.
469 Para adaptar a variante eeepc, por exemplo:</p>
471 <pre>
472 # tazpkg get-install mercurial
473 # cd /home/slitaz
474 # hg clone http://hg.slitaz.org/flavors
475 # cd flavors
476 # cp -a <em>eeepc myslitaz</em>
477 </pre>
479 <p>Arquivos em <tt>my-slitaz</tt> podem ser adaptados, então:</p>
481 <pre>
482 # tazlito pack-flavor <em>myslitaz</em>
483 </pre>
485 <p>Isto irá criar uma nova variante adaptada de uma outra existente.</p>
486 <p>Dica: Pode-se evitar a instalação do mercurial extraindo-se uma variante.
487 Usando o exemplo anterior:</p>
489 <pre>
490 # tazlito get-flavor eeepc
491 # tazlito extract-flavor eeepc.flavor
492 # cd /home/slitaz/flavors
493 # cp -a <em>eeepc myslitaz</em>
494 </pre>
497 <h3 id="meta-flavor">Meta flavor</h3>
499 <p>Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se
500 iniciar o sistema com uma meta variante, uma variante contida no LiveCD irá ser
501 chamada dependendo do tamanho da memória RAM disponível. A variável
502 ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os parametros das
503 variantes existentes.
504 <a href="http://hg.slitaz.org/flavors/file/tip/core-4in1/receipt">Exemplo</a>
505 usando a meta variante:</p>
507 <pre>
508 ROOTFS_SELECTION="160M core 96M justX 32M base"
509 </pre>
511 <p>Este tipo de variante não possui uma lista de pacotes
512 (<tt>packages.list</tt>) e só é suportada no SliTaz a partir do kernel
513 2.6.30.</p>
516 <h2>MANTENEDOR</h2>
518 <p>Christophe Lincoln <pankso at slitaz.org><br />
519 Pascal Bellard <pascal.bellard at slitaz.org></p>
521 <!-- End content -->
522 </div>
524 <footer>
525 Copyright © 2013 <a href="http://www.slitaz.org/">SliTaz GNU/Linux</a>
526 </footer>
528 </body>
529 </html>