tazlito view doc/tazlito.pt.html @ rev 212
Use /home/slitaz/VERSION as work directory
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Thu Feb 24 14:08:19 2011 +0100 (2011-02-24) |
| parents | deb4940afbdd |
| children |
line source
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt">
4 <head>
5 <title>Manual Tazlito - Ferramenta Live do SliTaz</title>
6 <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
7 <meta name="description" content="" />
8 <meta name="expires" content="never" />
9 <meta name="modified" content="2011-02-24 13:30:00" />
10 <style type="text/css"><!--
11 body { font: 90% sans-serif, vernada, arial; margin: 0;
12 border-top: 34px solid #f1f1f1; }
13 #header { background: #351a0a; color: black; height: 50px;
14 border-top: 1px solid black; border-bottom: 1px solid black; }
15 #content { margin: 0px 50px 26px 50px; }
16 h1 { margin: 14px 0px 0px 16px; color: #fff; margin: 10px; }
17 h3 { font-weight: bold; color: #666666; }
18 li { line-height: 1.4em; }
19 pre { padding: 5px; color: black; background: #e1e0b0;
20 border-radius: 4px; -moz-border-radius: 4px; -webkit-border-radius: 4px; }
21 code { font-size: 100%; color: #669900; background: transparent; }
22 hr { color: white; background: white; height: 1px; border: 0; }
23 --></style>
24 </head>
25 <body bgcolor="#ffffff">
26 <div id="header">
27 <h1>Manual Tazlito</h1>
28 </div>
29 <hr />
30 <!-- Start content -->
31 <div id="content">
33 <h2>NOME</h2>
34 <p>
35 Tazlito - SliTaz Live Tool.
36 </p>
38 <h2>SINTAXE</h2>
39 <pre>
40 tazlito [command] [list|iso|flavor] [dir]
41 </pre>
43 <h2>DESCRIÇÃO</h2>
45 <p>
46 Tazlito é um pequeno utilitário que extrai um LiveCD, reconstrói a imagem ISO
47 e regenera o sistema de arquivos root do LiveCD, criando uma variante
48 (flavor) da distribuição. O Tazlito também pode gerar uma distribuição a
49 partir de uma lista de pacotes previamente baixados. Para rodar, o Tazlito
50 usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf ou o
51 tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica
52 o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos
53 e da ISO a ser gerada. Tazlito também pode ser usado para configurar um
54 diretório contendo arquivos adicionais que serão copiados para o LiveCD na
55 geração da distribuição.
56 </p>
58 <p>
59 Tazlito é distribuído sobre a licença livre GNU GPL V3, istalada por padrão no
60 SliTaz e instalada/testada com sucesso no Debian GNU/Linux. Você irá encontrar
61 informações adicionais sobre a criação de um LiveCD no Manual SliTaz.
62 </p>
64 <h2>COMANDOS</h2>
66 <a name="usage"></a>
67 <h3>usage</h3>
68 <p>
69 O comando "usage" mostra um resumo dos comandos disponíveis com uma pequena
70 descrição:
71 </p>
72 <pre>
73 # tazlito usage
74 </pre>
76 <a name="stats"></a>
77 <h3>stats</h3>
78 <p>
79 "Stats" mostra as variáveis da configuração, os caminhos para os vários arquivos
80 e diretórios e informações sobre a imagem ISO:
81 </p>
82 <pre>
83 # tazlito stats
84 </pre>
86 <a name="gen-config"></a>
87 <h3>gen-config</h3>
88 <p>
89 O comando "gen-config" permite a geração do arquivo de configuração pronto para
90 ser editado. Por padrão o arquivo é criado no diretório atual, mas também pode
91 ser em outro diretório informado na linha de comando:
92 </p>
93 <pre>
94 # tazlito gen-config
95 # tazlito gen-config /path/to/distro
96 </pre>
98 <a name="configure"></a>
99 <h3>configure</h3>
100 <p>
101 Este comando pode configurar o arquivo de configuração do sistema ou o encontrado
102 no diretório atual:
103 </p>
104 <pre>
105 # tazlito configure
106 </pre>
108 <a name="gen-iso"></a>
109 <h3>gen-iso</h3>
110 <p>
111 O comando "gen-iso" pode gerar uma nova imagem do LiveCD a partir de modificações
112 e adições ao sistema de arquivos root do cdrom. Para funcionar, este comando
113 precisa de um diretório que contenha a "árvore" da distribuição do sistema Live.
114 Esta "árvore" pode ser facilmente gerada com o comando "extract-distro", modificada
115 ou reconstruida via:
116 </p>
117 <pre>
118 # tazlito gen-iso
119 </pre>
121 <a name="gen-initiso"></a>
122 <h3>gen-initiso</h3>
123 <p>
124 O comando "gen-initiso" faz o mesmo que o "gen-iso", mas antes ele reconstrói o
125 sistema comprimido initramfs. O initramfs contem o sistema de arquivos root e
126 deve ser reconstruído se modificado:
127 </p>
128 <pre>
129 # tazlito gen-initiso
130 </pre>
132 <a name="list-flavors"></a>
133 <h3>list-flavors</h3>
134 <p>
135 Este comando baixa (se necessário) e mostra a lista de diferentes variantes
136 disponíveis. Pode-se forçar o download com a opção --recharge:
137 </p>
138 <pre>
139 # tazlito list-flavors
140 # tazlito list-flavors --recharge
141 </pre>
143 <a name="get-flavor"></a>
144 <h3>get-flavor</h3>
145 <p>
146 O comando "get-flavor" baixa (se necessário) e prepara os arquivos para que o
147 comando "gen-distro" gere uma variante:
148 </p>
149 <pre>
150 # tazlito get-flavor particular-flavor
151 </pre>
153 <a name="show-flavor"></a>
154 <h3>show-flavor</h3>
155 <p>
156 Este comando mostra a descrição da variante e seu tamanho após a regeneração.
157 As opções --brief e --hoheader reduzem a saida do comando:
158 </p>
159 <pre>
160 # tazlito show-flavor particular-flavor
161 # tazlito show-flavor particular-flavor --brief
162 # tazlito show-flavor particular-flavor --brief --noheader
163 </pre>
165 <a name="gen-flavor"></a>
166 <h3>gen-flavor</h3>
167 <p>
168 O comando "gen-flavor" cria um arquivo de descrição de uma nova variante a partir
169 dos resultados da regeneração da distro (gen-distro). O arquivo .flavor pode
170 ser enviado ao slitaz.org:
171 </p>
172 <pre>
173 # tazlito gen-flavor new-flavor
174 </pre>
176 <a name="gen-liveflavor"></a>
177 <h3>gen-liveflavor</h3>
178 <p>
179 Este comando cria um arquivo de descrição de uma nova variante a partir
180 dos resultados de geração da distro baseada no sistema atual. A opção
181 --help mostra mais informações
182 </p>
183 <pre> # tazlito gen-liveflavor
184 # tazlito gen-liveflavor --help
185 </pre>
187 <a name="upgrade-flavor"></a>
188 <h3>upgrade-flavor</h3>
189 <p>
190 Este comando renova um arquivo flavor, atualizando a lista de pacotes
191 com a versão mais recente disponível no mirror:
192 </p>
193 <pre>
194 # tazlito upgrade-flavor this-flavor
195 </pre>
197 <a name="extract-flavor"></a>
198 <h3>extract-flavor</h3>
199 <p>
200 O comando 'extract-flavor' converte um flavor em uma estrutura de pastas
201 facilmente modificável em /home/slitaz/VERSION/flavors que pode ser ser
202 gerenciada com o mercurial:
203 <a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>.
204 </p>
205 <pre>
206 # tazlito extract-flavor this-flavor
207 </pre>
209 <a name="pack-flavor"></a>
210 <h3>pack-flavor</h3>
211 <p>
212 Este comando converte uma estrutura de pastas encontrada em
213 /home/slitaz/VERSION/flavors em um arquivo de variante (.flavor). É o
214 inverso do que o comando 'extract-flavor' faz:
215 </p>
216 <pre>
217 # tazlito pack-flavor this-flavor
218 </pre>
220 <a name="extract-distro"></a>
221 <h3>extract-distro</h3>
222 <p>
223 Este comando é usado para extrair uma imagem ISO do LiveCD e reconstruir a
224 estrutura do cdrom e sistema root. Isto possibilita fazer as mudanças desejadas,
225 adições e reconstruções da imagem ISO por meio do comando "gen-iso" ou
226 "gen-initiso". Exemplo de uso:
227 </p>
228 <pre>
229 # tazlito extract-distro slitaz-cooking.iso
230 </pre>
232 <a name="gen-distro"></a>
233 <h3>gen-distro</h3>
234 <p>
235 O comando para <em>Geração de Distribuição</em> pode gerar a árvore da distribuição
236 e a imagem ISO por meio de uma lista de pacotes. Para funcionar, este comando
237 precisa da lista de pacotes, um diretório contendo todos os pacotes .tazpgk
238 especificados na lista e um diretório para gerar a distribuição. A lista de
239 pacotes pode ser extraida de uma variante pelo comando "get-flavor". Ao se
240 utilizar o LiveCD, as opções --cdrom e --iso= permitem a regeneração dos
241 pacotes que adicionam arquivos ao diretório /boot sem que seja necessário o
242 download dos mesmos e recuperam os arquivos adicionais do LiveCD. O caminho
243 para os vários diretórios é informado no arquivo de configuração e os pacotes
244 podem ser baixados dos mirrors do SliTaz ou gerados pelo Tazwok. Para gerar uma
245 distribuição:
246 </p>
247 <pre>
248 # tazlito gen-distro
249 # tazlito gen-distro --cdrom
250 # tazlito gen-distro --iso=slitaz.iso
251 # tazlito gen-distro package-list
252 </pre>
254 <a name="clean-distro"></a>
255 <h3>clean-distro</h3>
256 <p>
257 Remove todos os arquivos gerados ou extraidos da estrutura do LiveCD:
258 </p>
259 <pre>
260 # tazlito clean-distro
261 </pre>
263 <a name="check-distro"></a>
264 <h3>check-distro</h3>
265 <p>
266 Este comando simplesmente verifica se os arquivos instalados pelos pacotes estão
267 presentes no sistema:
268 </p>
269 <pre>
270 # tazlito check-distro
271 </pre>
273 <a name="writeiso"></a>
274 <h3>writeiso</h3>
275 <p>
276 Este comando irá converter o sistema de arquivos atual em um arquivo
277 cpio (rootfs.gz) e então gerar uma imagem ISO inicializável. Pode ser
278 usado tanto em instalações no HD quanto em modo LiveCD, e irá arquivar
279 também o conteúdo do diretório /home. Com ele, pode-se facilmente
280 remasterizar e construir sua própria imagem de LiveCD. Para tanto
281 inicie o sistema, modifique arquivos, instale pacotes e então:
282 </p>
283 <pre>
284 # tazlito writeiso [gzip|lzma|none]
285 # tazlito writeiso gzip
286 # tazlito writeiso gzip image-name
287 </pre>
289 <a name="frugal-install"></a>
290 <h3>frugal-install</h3>
291 <p>
292 Executa uma instalação frugal em /boot/frugal e adiciona uma entrada ao
293 GRUB, caso necessário. Este tipo de instalação irá rodar o SliTaz
294 diretamente na memória RAM (mesmo comportamento do LiveCD), o que
295 permite testar a distro ou ter um sistema de recuperação pronto para uso.
296 Para instalar todos os arquivos necessários a partir de uma estrutura
297 de pastas ou de uma imagem ISO:
298 </p>
299 <pre>
300 # tazlito frugal-install
301 # tazlito -fi slitaz.iso
302 </pre>
304 <a name="check-list"></a>
305 <h3>check-list</h3>
306 <p>
307 Verifica se o arquivo distro-packages.list está atualizado com as
308 mais recentes versões dos pacotes:
309 </p>
310 <pre>
311 # tazlito check-list
312 </pre>
314 <a name="repack"></a>
315 <h3>repack</h3>
316 <p>
317 Comprime novamente o rootfs com a melhor compressão possível:
318 </p>
319 <pre>
320 # tazlito repack slitaz.iso
321 </pre>
323 <a name="merge"></a>
324 <h3>merge</h3>
325 <p>
326 Combina diversas variantes. Cada rootfs é uma consequência de seu
327 anterior. O primeiro rootfs é extraido da imagem ISO indicada como
328 terceiro argumento. As variantes serão escolhidas no momento do boot,
329 de acordo com a memória RAM disponível:
330 </p>
331 <pre>
332 # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz
333 </pre>
335 <a name="build-loram"></a>
336 <h3>build-loram</h3>
337 <p>
338 Cria uma variante para sistemas com pouca memória RAM à partir de uma
339 imagem ISO do SliTaz. Pode-se gerar uma variante que seja carregada na
340 diretamente na memória ou lida a partir do cdrom:
341 </p>
342 <pre>
343 # tazlito build-loram slitaz.iso loram.iso
344 # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom
345 </pre>
347 <a name="emu-iso"></a>
348 <h3>emu-iso</h3>
349 <p>
350 O comando emu-iso utiliza o emulador Qemu para iniciar e rodar o SliTaz.
351 É util para testar a iso criada sem a necessidade de gravá-la em um
352 cdrom ou bootar em modo frugal.
353 </p>
354 <pre> # tazlito emu-iso
355 # tazlito emu-iso path/to/image.iso
356 </pre>
358 <a name="burn-iso"></a>
359 <h3>burn-iso</h3>
360 <p>
361 O comando "burn-iso" obtém informações sobre o dispositivo de cd e as velocidades
362 permitidas para gravação, e o wodim (parte do cdrkit) inicia para gravar a imagem
363 ISO. A imagem ISo padrão é aquela especificada no arquivo de configuração, mas
364 é possível especificar uma imagem diferente por meio da linha de comando:
365 </p>
366 <pre>
367 # tazlito burn-iso
368 # tazlito burn-iso slitaz-hacked.iso
369 </pre>
371 <h2>FLAVORS</h2>
372 <p>
373 Um arquivo <i>.flavor</i> contém somente alguns poucos Kb de informação
374 necessária para (re)construir um LiveCD customizado do SliTaz.
375 </p>
377 <a name="rebuild-flavor"></a>
378 <h3>(Re)construa uma variante</h3>
379 <p>
380 Você pode escolher uma variante para (re)construir a partir daquelas
381 disponíveis:
382 </p>
383 <pre>
384 # tazlito list-flavors
386 List of flavors
387 ================================================================================
388 Name ISO Rootfs Description
389 ================================================================================
390 base 6.9M 13.1M Minimal set of packages to boot
391 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
392 core 31.5M 104.6M SliTaz core system
393 eeepc 31.2M 105.4M SliTaz eeepc system
394 justX 16.1M 51.2M SliTaz with a minimal X environment
395 </pre>
396 <p>
397 Como exeplo, começaremos a reconstruir a variante <i>eeepc</i> que
398 ocupa 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M:
399 </p>
400 <pre>
401 # tazlito clean-distro
402 # tazlito get-flavor eeepc
403 # tazlito gen-distro
404 </pre>
406 <a name="create-flavor"></a>
407 <h3>Crie uma variante</h3>
408 <p>
409 Para criar uma variante, você deve:
410 </p>
411 <ul>
412 <li>Criar uma imagem ISO usando o comando <b>tazlito-gen-distro</b>
413 e então criar um arquivo flavor usando <b>tazlito gen-flavor</b>; ou</li>
414 <li>Criar diretamente uma estrutura de arquivos que define o flavor
415 (veja <b>tazlito extract-flavor</b>) e então criar o flavor
416 usando <b>tazlito pack-flavor</b>.</li>
417 </ul>
419 <a name="publish-flavor"></a>
420 <h3>Publique uma variante</h3>
421 <p>
422 Um arquivo .flavor possui alguns Kb de tamanho, então você pode enviá-lo
423 para a lista de discussão do SliTaz.
424 </p>
425 <p>
426 Os arquivos resultantes do comando <b>tazlito extract flavor</b> pode
427 também ser colocado no repositório mercurial (http://repos.slitaz.org/flavors).
428 Este método é preferido porque a estrutura de pastas poderá ser
429 acessada diretamente por uma
430 <a href="http://hg.slitaz.org/flavors/file/tip">interface web</a>.
431 </p>
432 <p>
433 Esta estrutura inclui:
434 </p>
435 <ul>
436 <li>
437 Uma <b>receita</b> (arquivo <i>receipt</i>) que descreve a variante
438 por intermédio das variáveis:
439 <ul>
440 <li>
441 FLAVOR: O nome da variante.
442 </li>
443 <li>
444 SHORT_DESC: Uma curta descrição
445 </li>
446 <li>
447 VERSION: Versão.
448 </li>
449 <li>
450 MAINTAINER: Email do desenvolvedor/criador.
451 </li>
452 <li>
453 FRUGAL_RAM: Memória RAM mínima recomendável (variável opcional).
454 </li>
455 <li>
456 ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM (opcional).
457 </li>
458 <li>
459 INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CDROM (opcional).
460 </li>
461 <li>
462 ISO_SIZE: Tamanho do CDROM (opcional).
463 </li>
464 <li>
465 ROOTFS_SELECTION: Opcional, veja <i>Meta flavor</i> abaixo.
466 </li>
467 </ul>
468 </li>
469 <li>
470 O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar
471 uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis).
472 Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja
473 definida.
474 </li>
475 <li>
476 O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais
477 (undigest) a serem incluidos para se obter pacotes personalizados.
478 </li>
479 <li>
480 O diretório opcional <b>rootfs</b> contem uma estrutura de pastas e arquivos
481 a serem adicionados ao sistema de arquivos rootfs.gz (normalmente serão
482 arquivos de configuração).
483 </li>
484 <li>
485 O diretório opcional <b>rootcd</b> contem uma estrutura de pastas e arquivos
486 a serem adicionados ao CDROM.
487 </li>
488 </ul>
490 <a name="tune-flavor"></a>
491 <h3>Adapte uma variante</h3>
492 <p>
493 Às vezes é mais fácil modificar uma variante existente do que criar uma
494 nova. Para adaptar a variante eeepc, por exemplo:
495 </p>
496 <pre>
497 # tazpkg get-install mercurial
498 # cd /home/slitaz
499 # hg clone http://hg.slitaz.org/flavors
500 # cd flavors
501 # cp -a eeepc myslitaz
502 </pre>
503 <p>
504 Arquivos em <i>my-slitaz</i> podem ser adaptados, então:
505 </p>
506 <pre>
507 # tazlito pack-flavor myslitaz
508 </pre>
509 <p>
510 Isto irá criar uma nova variante adaptada de uma outra existente.
511 </p>
512 <p>
513 Dica: Pode-se evitar a instalação do mercurial extraindo-se uma variante.
514 Usando o exemplo anterior:
515 </p>
516 <pre>
517 # tazlito get-flavor eeepc
518 # tazlito extract-flavor eeepc.flavor
519 # cd /home/slitaz/flavors
520 # cp -a eeepc myslitaz
521 </pre>
523 <a name="meta-flavor"></a>
524 <h3>Meta flavor</h3>
525 <p>
526 Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se
527 iniciar o sistema com uma meta variante, uma variante contida no LiveCD
528 irá ser chamada dependendo do tamanho da memória RAM disponível. A
529 variável ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os
530 parametros das variantes existentes. Exemplo usando a meta variante
531 <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"></a>:
532 </p>
533 <pre>
534 ROOTFS_SELECTION="160M core 96M justX 32M base"
535 </pre>
536 <p>
537 Este tipo de variante não possui uma lista de pacotes (packages.list)
538 e só é suportada no SliTaz a partir do kernel 2.6.30.
539 </p>
541 <h2>MANTENEDOR</h2>
542 <p>
543 Christophe Lincoln <pankso at slitaz.org>
544 </p>
546 <!-- End content -->
547 </div>
548 </body>
549 </html>