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