tazlito view doc/tazlito.pt.html @ rev 176
Removed tag 3.3
| author | Christophe Lincoln <pankso@slitaz.org> |
|---|---|
| date | Sun Mar 28 00:59:13 2010 +0100 (2010-03-28) |
| parents | 413df610d881 |
| children | ea533bc95775 |
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="emu-iso"></a>
335 <h3><font color="#6c0023">emu-iso</font></h3>
336 <p>
337 O comando emu-iso utiliza o emulador Qemu para iniciar e rodar o SliTaz.
338 É util para testar a iso criada sem a necessidade de gravá-la em um
339 cdrom ou bootar em modo frugal.
340 </p>
341 <pre> # tazlito emu-iso
342 # tazlito emu-iso path/to/image.iso
343 </pre>
345 <a name="burn-iso"></a>
346 <h3><font color="#6c0023">burn-iso</font></h3>
347 <p>
348 O comando "burn-iso" obtém informações sobre o dispositivo de cd e as velocidades
349 permitidas para gravação, e o wodim (parte do cdrkit) inicia para gravar a imagem
350 ISO. A imagem ISo padrão é aquela especificada no arquivo de configuração, mas
351 é possível especificar uma imagem diferente por meio da linha de comando:
352 </p>
353 <pre>
354 # tazlito burn-iso
355 # tazlito burn-iso slitaz-hacked.iso
356 </pre>
358 <h2>FLAVORS</h2>
359 <p>
360 Um arquivo <i>.flavor</i> contém somente alguns poucos Kb de informação
361 necessária para (re)construir um LiveCD customizado do SliTaz.
362 </p>
364 <a name="rebuild-flavor"></a>
365 <h3><font color="#6c0023">(Re)construa uma variante</font></h3>
366 <p>
367 Você pode escolher uma variante para (re)construir a partir daquelas
368 disponíveis:
369 </p>
370 <pre>
371 # tazlito list-flavors
373 List of flavors
374 ================================================================================
375 Name ISO Rootfs Description
376 ================================================================================
377 base 6.9M 13.1M Minimal set of packages to boot
378 core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives
379 core 31.5M 104.6M SliTaz core system
380 eeepc 31.2M 105.4M SliTaz eeepc system
381 justX 16.1M 51.2M SliTaz with a minimal X environment
382 </pre>
383 <p>
384 Como exeplo, começaremos a reconstruir a variante <i>eeepc</i> que
385 ocupa 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M:
386 </p>
387 <pre>
388 # tazlito clean-distro
389 # tazlito get-flavor eeepc
390 # tazlito gen-distro
391 </pre>
393 <a name="create-flavor"></a>
394 <h3><font color="#6c0023">Crie uma variante</font></h3>
395 <p>
396 Para criar uma variante, você deve:
397 </p>
398 <ul>
399 <li>Criar uma imagem ISO usando o comando <b>tazlito-gen-distro</b>
400 e então criar um arquivo flavor usando <b>tazlito gen-flavor</b>; ou</li>
401 <li>Criar diretamente uma estrutura de arquivos que define o flavor
402 (veja <b>tazlito extract-flavor</b>) e então criar o flavor
403 usando <b>tazlito pack-flavor</b>.</li>
404 </ul>
406 <a name="publish-flavor"></a>
407 <h3><font color="#6c0023">Publique uma variante</font></h3>
408 <p>
409 Um arquivo .flavor possui alguns Kb de tamanho, então você pode enviá-lo
410 para a lista de discussão do SliTaz.
411 </p>
412 <p>
413 Os arquivos resultantes do comando <b>tazlito extract flavor</b> pode
414 também ser colocado no repositório mercurial (http://repos.slitaz.org/flavors).
415 Este método é preferido porque a estrutura de pastas poderá ser
416 acessada diretamente por uma interface web.
417 </p>
418 <p>
419 Esta estrutura inclui:
420 </p>
421 <ul>
422 <li>
423 Uma <b>receita</b> (arquivo <i>receipt</i>) que descreve a variante
424 por intermédio das variáveis:
425 <ul>
426 <li>
427 FLAVOR: O nome da variante.
428 </li>
429 <li>
430 SHORT_DESC: Uma curta descrição
431 </li>
432 <li>
433 VERSION: Versão.
434 </li>
435 <li>
436 MAINTAINER: Email do desenvolvedor/criador.
437 </li>
438 <li>
439 FRUGAL_RAM: Memória RAM mínima recomendável (variável opcional).
440 </li>
441 <li>
442 ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM (opcional).
443 </li>
444 <li>
445 INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CDROM (opcional).
446 </li>
447 <li>
448 ISO_SIZE: Tamanho do CDROM (opcional).
449 </li>
450 <li>
451 ROOTFS_SELECTION: Opcional, veja <i>Meta flavor</i> abaixo.
452 </li>
453 </ul>
454 </li>
455 <li>
456 O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar
457 uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis).
458 Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja
459 definida.
460 </li>
461 <li>
462 O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais
463 (undigest) a serem incluidos para se obter pacotes personalizados.
464 </li>
465 <li>
466 O diretório opcional <b>rootfs</b> contem uma estrutura de pastas e arquivos
467 a serem adicionados ao sistema de arquivos rootfs.gz (normalmente serão
468 arquivos de configuração).
469 </li>
470 <li>
471 O diretório opcional <b>rootcd</b> contem uma estrutura de pastas e arquivos
472 a serem adicionados ao CDROM.
473 </li>
474 </ul>
476 <a name="tune-flavor"></a>
477 <h3><font color="#6c0023">Adapte uma variante</font></h3>
478 <p>
479 Às vezes é mais fácil modificar uma variante existente do que criar uma
480 nova. Para adaptar a variante eeepc, por exemplo:
481 </p>
482 <pre>
483 # tazpkg get-install mercurial
484 # cd /home/slitaz
485 # hg clone http://hg.slitaz.org/flavors
486 # cd flavors
487 # cp -a eeepc myslitaz
488 </pre>
489 <p>
490 Arquivos em <i>my-slitaz</i> podem ser adaptados, então:
491 </p>
492 <pre>
493 # tazlito pack-flavor myslitaz
494 </pre>
495 <p>
496 Isto irá criar uma nova variante adaptada de uma outra existente.
497 </p>
499 <a name="meta-flavor"></a>
500 <h3><font color="#6c0023">Meta flavor</font></h3>
501 <p>
502 Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se
503 iniciar o sistema com uma meta variante, uma variante contida no LiveCD
504 irá ser chamada dependendo do tamanho da memória RAM disponível. A
505 variável ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os
506 parametros das variantes existentes. Exemplo usando a meta variante
507 <a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"></a>:
508 </p>
509 <pre>
510 ROOTFS_SELECTION="160M core 96M justX 32M base"
511 </pre>
512 <p>
513 Este tipo de variante não possui uma lista de pacotes (packages.list)
514 e só é suportada no SliTaz a partir do kernel 2.6.30.
515 </p>
517 <h2>MANTENEDOR</h2>
518 <p>
519 Christophe Lincoln <pankso at slitaz.org>
520 </p>
522 <!-- End content -->
523 </div>
524 </body>
525 </html>