tazlito view doc/tazlito.pt_BR.html @ rev 281

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