tazlito rev 288
move back 'pt_BR' doc name to 'pt' so tazlocale can handle it properly
author | Claudinei Pereira <claudinei@slitaz.org> |
---|---|
date | Sun Sep 02 13:49:05 2012 -0300 (2012-09-02) |
parents | 16df1f602d4d |
children | ff1150bb5001 |
files | doc/tazlito.pt.html doc/tazlito.pt_BR.html |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/doc/tazlito.pt.html Sun Sep 02 13:49:05 2012 -0300 1.3 @@ -0,0 +1,536 @@ 1.4 +<!DOCTYPE html> 1.5 +<html xmlns="http://www.w3.org/1999/xhtml" lang="en"> 1.6 +<head> 1.7 + <title>Manual Tazlito - Ferramenta Live do SliTaz</title> 1.8 + <meta charset="utf-8" /> 1.9 + <link rel="shortcut icon" href="favicon.ico" /> 1.10 + <link rel="stylesheet" type="text/css" href="style.css" /> 1.11 +</head> 1.12 +<body> 1.13 + 1.14 +<div id="header"> 1.15 + <h1>Manual Tazlito</h1> 1.16 +</div> 1.17 + 1.18 +<!-- Start content --> 1.19 +<div id="content"> 1.20 + 1.21 +<h2>NOME</h2> 1.22 +<p> 1.23 +Tazlito - SliTaz Live Tool. 1.24 +</p> 1.25 + 1.26 +<h2>SINTAXE</h2> 1.27 +<pre> 1.28 +tazlito [command] [list|iso|flavor] [dir] 1.29 +</pre> 1.30 + 1.31 +<h2>DESCRIÇÃO</h2> 1.32 + 1.33 +<p> 1.34 +Tazlito é um pequeno utilitário que extrai um LiveCD, reconstrói a imagem ISO 1.35 +e regenera o sistema de arquivos root do LiveCD, criando uma variante 1.36 +(flavor) da distribuição. O Tazlito também pode gerar uma distribuição a 1.37 +partir de uma lista de pacotes previamente baixados. Para rodar, o Tazlito 1.38 +usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf ou o 1.39 +tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica 1.40 +o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos 1.41 +e da ISO a ser gerada. Tazlito também pode ser usado para configurar um 1.42 +diretório contendo arquivos adicionais que serão copiados para o LiveCD na 1.43 +geração da distribuição. 1.44 +</p> 1.45 + 1.46 +<p> 1.47 +Tazlito é distribuído sobre a licença livre GNU GPL V3, istalada por padrão no 1.48 +SliTaz e instalada/testada com sucesso no Debian GNU/Linux. Você irá encontrar 1.49 +informações adicionais sobre a criação de um LiveCD no Manual SliTaz. 1.50 +</p> 1.51 + 1.52 +<h2>COMANDOS</h2> 1.53 + 1.54 +<a name="usage"></a> 1.55 +<h3>usage</h3> 1.56 +<p> 1.57 +O comando "usage" mostra um resumo dos comandos disponíveis com uma pequena 1.58 +descrição: 1.59 +</p> 1.60 +<pre> 1.61 + # tazlito usage 1.62 +</pre> 1.63 + 1.64 +<a name="stats"></a> 1.65 +<h3>stats</h3> 1.66 +<p> 1.67 +"Stats" mostra as variáveis da configuração, os caminhos para os vários arquivos 1.68 +e diretórios e informações sobre a imagem ISO: 1.69 +</p> 1.70 +<pre> 1.71 + # tazlito stats 1.72 +</pre> 1.73 + 1.74 +<a name="gen-config"></a> 1.75 +<h3>gen-config</h3> 1.76 +<p> 1.77 +O comando "gen-config" permite a geração do arquivo de configuração pronto para 1.78 +ser editado. Por padrão o arquivo é criado no diretório atual, mas também pode 1.79 +ser em outro diretório informado na linha de comando: 1.80 +</p> 1.81 +<pre> 1.82 + # tazlito gen-config 1.83 + # tazlito gen-config /path/to/distro 1.84 +</pre> 1.85 + 1.86 +<a name="configure"></a> 1.87 +<h3>configure</h3> 1.88 +<p> 1.89 +Este comando pode configurar o arquivo de configuração do sistema ou o encontrado 1.90 +no diretório atual: 1.91 +</p> 1.92 +<pre> 1.93 + # tazlito configure 1.94 +</pre> 1.95 + 1.96 +<a name="gen-iso"></a> 1.97 +<h3>gen-iso</h3> 1.98 +<p> 1.99 +O comando "gen-iso" pode gerar uma nova imagem do LiveCD a partir de modificações 1.100 +e adições ao sistema de arquivos root do cdrom. Para funcionar, este comando 1.101 +precisa de um diretório que contenha a "árvore" da distribuição do sistema Live. 1.102 +Esta "árvore" pode ser facilmente gerada com o comando "extract-distro", modificada 1.103 +ou reconstruida via: 1.104 +</p> 1.105 +<pre> 1.106 + # tazlito gen-iso 1.107 +</pre> 1.108 + 1.109 +<a name="gen-initiso"></a> 1.110 +<h3>gen-initiso</h3> 1.111 +<p> 1.112 +O comando "gen-initiso" faz o mesmo que o "gen-iso", mas antes ele reconstrói o 1.113 +sistema comprimido initramfs. O initramfs contem o sistema de arquivos root e 1.114 +deve ser reconstruído se modificado: 1.115 +</p> 1.116 +<pre> 1.117 + # tazlito gen-initiso 1.118 +</pre> 1.119 + 1.120 +<a name="list-flavors"></a> 1.121 +<h3>list-flavors</h3> 1.122 +<p> 1.123 +Este comando baixa (se necessário) e mostra a lista de diferentes variantes 1.124 +disponíveis. Pode-se forçar o download com a opção --recharge: 1.125 +</p> 1.126 +<pre> 1.127 + # tazlito list-flavors 1.128 + # tazlito list-flavors --recharge 1.129 +</pre> 1.130 + 1.131 +<a name="get-flavor"></a> 1.132 +<h3>get-flavor</h3> 1.133 +<p> 1.134 +O comando "get-flavor" baixa (se necessário) e prepara os arquivos para que o 1.135 +comando "gen-distro" gere uma variante: 1.136 +</p> 1.137 +<pre> 1.138 + # tazlito get-flavor particular-flavor 1.139 +</pre> 1.140 + 1.141 +<a name="show-flavor"></a> 1.142 +<h3>show-flavor</h3> 1.143 +<p> 1.144 +Este comando mostra a descrição da variante e seu tamanho após a regeneração. 1.145 +As opções --brief e --hoheader reduzem a saida do comando: 1.146 +</p> 1.147 +<pre> 1.148 + # tazlito show-flavor particular-flavor 1.149 + # tazlito show-flavor particular-flavor --brief 1.150 + # tazlito show-flavor particular-flavor --brief --noheader 1.151 +</pre> 1.152 + 1.153 +<a name="gen-flavor"></a> 1.154 +<h3>gen-flavor</h3> 1.155 +<p> 1.156 +O comando "gen-flavor" cria um arquivo de descrição de uma nova variante a partir 1.157 +dos resultados da regeneração da distro (gen-distro). O arquivo .flavor pode 1.158 +ser enviado ao slitaz.org: 1.159 +</p> 1.160 +<pre> 1.161 + # tazlito gen-flavor new-flavor 1.162 +</pre> 1.163 + 1.164 +<a name="gen-liveflavor"></a> 1.165 +<h3>gen-liveflavor</h3> 1.166 +<p> 1.167 +Este comando cria um arquivo de descrição de uma nova variante a partir 1.168 +dos resultados de geração da distro baseada no sistema atual. A opção 1.169 +--help mostra mais informações 1.170 +</p> 1.171 +<pre> # tazlito gen-liveflavor 1.172 + # tazlito gen-liveflavor --help 1.173 +</pre> 1.174 + 1.175 +<a name="upgrade-flavor"></a> 1.176 +<h3>upgrade-flavor</h3> 1.177 +<p> 1.178 +Este comando renova um arquivo flavor, atualizando a lista de pacotes 1.179 +com a versão mais recente disponível no mirror: 1.180 +</p> 1.181 +<pre> 1.182 + # tazlito upgrade-flavor this-flavor 1.183 +</pre> 1.184 + 1.185 +<a name="extract-flavor"></a> 1.186 +<h3>extract-flavor</h3> 1.187 +<p> 1.188 +O comando 'extract-flavor' converte um flavor em uma estrutura de pastas 1.189 +facilmente modificável em /home/slitaz/VERSION/flavors que pode ser ser 1.190 +gerenciada com o mercurial: 1.191 +<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>. 1.192 +</p> 1.193 +<pre> 1.194 + # tazlito extract-flavor this-flavor 1.195 +</pre> 1.196 + 1.197 +<a name="pack-flavor"></a> 1.198 +<h3>pack-flavor</h3> 1.199 +<p> 1.200 +Este comando converte uma estrutura de pastas encontrada em 1.201 +/home/slitaz/VERSION/flavors em um arquivo de variante (.flavor). É o 1.202 +inverso do que o comando 'extract-flavor' faz: 1.203 +</p> 1.204 +<pre> 1.205 + # tazlito pack-flavor this-flavor 1.206 +</pre> 1.207 + 1.208 +<a name="extract-distro"></a> 1.209 +<h3>extract-distro</h3> 1.210 +<p> 1.211 +Este comando é usado para extrair uma imagem ISO do LiveCD e reconstruir a 1.212 +estrutura do cdrom e sistema root. Isto possibilita fazer as mudanças desejadas, 1.213 +adições e reconstruções da imagem ISO por meio do comando "gen-iso" ou 1.214 +"gen-initiso". Exemplo de uso: 1.215 +</p> 1.216 +<pre> 1.217 + # tazlito extract-distro slitaz-cooking.iso 1.218 +</pre> 1.219 + 1.220 +<a name="gen-distro"></a> 1.221 +<h3>gen-distro</h3> 1.222 +<p> 1.223 +O comando para <em>Geração de Distribuição</em> pode gerar a árvore da distribuição 1.224 +e a imagem ISO por meio de uma lista de pacotes. Para funcionar, este comando 1.225 +precisa da lista de pacotes, um diretório contendo todos os pacotes .tazpgk 1.226 +especificados na lista e um diretório para gerar a distribuição. A lista de 1.227 +pacotes pode ser extraida de uma variante pelo comando "get-flavor". Ao se 1.228 +utilizar o LiveCD, as opções --cdrom e --iso= permitem a regeneração dos 1.229 +pacotes que adicionam arquivos ao diretório /boot sem que seja necessário o 1.230 +download dos mesmos e recuperam os arquivos adicionais do LiveCD. O caminho 1.231 +para os vários diretórios é informado no arquivo de configuração e os pacotes 1.232 +podem ser baixados dos mirrors do SliTaz ou gerados pelo Cookutils. Para gerar uma 1.233 +distribuição: 1.234 +</p> 1.235 +<pre> 1.236 + # tazlito gen-distro 1.237 + # tazlito gen-distro --cdrom 1.238 + # tazlito gen-distro --iso=slitaz.iso 1.239 + # tazlito gen-distro package-list 1.240 +</pre> 1.241 + 1.242 +<a name="clean-distro"></a> 1.243 +<h3>clean-distro</h3> 1.244 +<p> 1.245 +Remove todos os arquivos gerados ou extraidos da estrutura do LiveCD: 1.246 +</p> 1.247 +<pre> 1.248 + # tazlito clean-distro 1.249 +</pre> 1.250 + 1.251 +<a name="check-distro"></a> 1.252 +<h3>check-distro</h3> 1.253 +<p> 1.254 +Este comando simplesmente verifica se os arquivos instalados pelos pacotes estão 1.255 +presentes no sistema: 1.256 +</p> 1.257 +<pre> 1.258 + # tazlito check-distro 1.259 +</pre> 1.260 + 1.261 +<a name="writeiso"></a> 1.262 +<h3>writeiso</h3> 1.263 +<p> 1.264 +Este comando irá converter o sistema de arquivos atual em um arquivo 1.265 +cpio (rootfs.gz) e então gerar uma imagem ISO inicializável. Pode ser 1.266 +usado tanto em instalações no HD quanto em modo LiveCD, e irá arquivar 1.267 +também o conteúdo do diretório /home. Com ele, pode-se facilmente 1.268 +remasterizar e construir sua própria imagem de LiveCD. Para tanto 1.269 +inicie o sistema, modifique arquivos, instale pacotes e então: 1.270 +</p> 1.271 +<pre> 1.272 + # tazlito writeiso [gzip|lzma|none] 1.273 + # tazlito writeiso gzip 1.274 + # tazlito writeiso gzip image-name 1.275 +</pre> 1.276 + 1.277 +<a name="frugal-install"></a> 1.278 +<h3>frugal-install</h3> 1.279 +<p> 1.280 +Executa uma instalação frugal em /boot/frugal e adiciona uma entrada ao 1.281 +GRUB, caso necessário. Este tipo de instalação irá rodar o SliTaz 1.282 +diretamente na memória RAM (mesmo comportamento do LiveCD), o que 1.283 +permite testar a distro ou ter um sistema de recuperação pronto para uso. 1.284 +Para instalar todos os arquivos necessários a partir de uma estrutura 1.285 +de pastas ou de uma imagem ISO: 1.286 +</p> 1.287 +<pre> 1.288 + # tazlito frugal-install 1.289 + # tazlito -fi slitaz.iso 1.290 +</pre> 1.291 + 1.292 +<a name="check-list"></a> 1.293 +<h3>check-list</h3> 1.294 +<p> 1.295 +Verifica se o arquivo distro-packages.list está atualizado com as 1.296 +mais recentes versões dos pacotes: 1.297 +</p> 1.298 +<pre> 1.299 + # tazlito check-list 1.300 +</pre> 1.301 + 1.302 +<a name="repack"></a> 1.303 +<h3>repack</h3> 1.304 +<p> 1.305 +Comprime novamente o rootfs com a melhor compressão possível: 1.306 +</p> 1.307 +<pre> 1.308 + # tazlito repack slitaz.iso 1.309 +</pre> 1.310 + 1.311 +<a name="merge"></a> 1.312 +<h3>merge</h3> 1.313 +<p> 1.314 +Combina diversas variantes. Cada rootfs é uma consequência de seu 1.315 +anterior. O primeiro rootfs é extraido da imagem ISO indicada como 1.316 +terceiro argumento. As variantes serão escolhidas no momento do boot, 1.317 +de acordo com a memória RAM disponível: 1.318 +</p> 1.319 +<pre> 1.320 + # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz 1.321 +</pre> 1.322 + 1.323 +<a name="build-loram"></a> 1.324 +<h3>build-loram</h3> 1.325 +<p> 1.326 +Cria uma variante para sistemas com pouca memória RAM à partir de uma 1.327 +imagem ISO do SliTaz. Pode-se gerar uma variante que seja carregada na 1.328 +diretamente na memória ou lida a partir do cdrom: 1.329 +</p> 1.330 +<pre> 1.331 + # tazlito build-loram slitaz.iso loram.iso 1.332 + # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom 1.333 +</pre> 1.334 + 1.335 +<a name="emu-iso"></a> 1.336 +<h3>emu-iso</h3> 1.337 +<p> 1.338 +O comando emu-iso utiliza o emulador Qemu para iniciar e rodar o SliTaz. 1.339 +É util para testar a iso criada sem a necessidade de gravá-la em um 1.340 +cdrom ou bootar em modo frugal. 1.341 +</p> 1.342 +<pre> # tazlito emu-iso 1.343 + # tazlito emu-iso path/to/image.iso 1.344 +</pre> 1.345 + 1.346 +<a name="burn-iso"></a> 1.347 +<h3>burn-iso</h3> 1.348 +<p> 1.349 +O comando "burn-iso" obtém informações sobre o dispositivo de cd e as velocidades 1.350 +permitidas para gravação, e o wodim (parte do cdrkit) inicia para gravar a imagem 1.351 +ISO. A imagem ISo padrão é aquela especificada no arquivo de configuração, mas 1.352 +é possível especificar uma imagem diferente por meio da linha de comando: 1.353 +</p> 1.354 +<pre> 1.355 + # tazlito burn-iso 1.356 + # tazlito burn-iso slitaz-hacked.iso 1.357 +</pre> 1.358 + 1.359 +<h2>FLAVORS</h2> 1.360 +<p> 1.361 +Um arquivo <i>.flavor</i> contém somente alguns poucos Kb de informação 1.362 +necessária para (re)construir um LiveCD customizado do SliTaz. 1.363 +</p> 1.364 + 1.365 +<a name="rebuild-flavor"></a> 1.366 +<h3>(Re)construa uma variante</h3> 1.367 +<p> 1.368 +Você pode escolher uma variante para (re)construir a partir daquelas 1.369 +disponíveis: 1.370 +</p> 1.371 +<pre> 1.372 +# tazlito list-flavors 1.373 + 1.374 +List of flavors 1.375 +================================================================================ 1.376 +Name ISO Rootfs Description 1.377 +================================================================================ 1.378 +base 6.9M 13.1M Minimal set of packages to boot 1.379 +core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives 1.380 +core 31.5M 104.6M SliTaz core system 1.381 +eeepc 31.2M 105.4M SliTaz eeepc system 1.382 +justX 16.1M 51.2M SliTaz with a minimal X environment 1.383 +</pre> 1.384 +<p> 1.385 +Como exeplo, começaremos a reconstruir a variante <i>eeepc</i> que 1.386 +ocupa 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M: 1.387 +</p> 1.388 +<pre> 1.389 +# tazlito clean-distro 1.390 +# tazlito get-flavor eeepc 1.391 +# tazlito gen-distro 1.392 +</pre> 1.393 + 1.394 +<a name="create-flavor"></a> 1.395 +<h3>Crie uma variante</h3> 1.396 +<p> 1.397 +Para criar uma variante, você deve: 1.398 +</p> 1.399 +<ul> 1.400 + <li>Criar uma imagem ISO usando o comando <b>tazlito-gen-distro</b> 1.401 + e então criar um arquivo flavor usando <b>tazlito gen-flavor</b>; ou</li> 1.402 + <li>Criar diretamente uma estrutura de arquivos que define o flavor 1.403 + (veja <b>tazlito extract-flavor</b>) e então criar o flavor 1.404 + usando <b>tazlito pack-flavor</b>.</li> 1.405 +</ul> 1.406 + 1.407 +<a name="publish-flavor"></a> 1.408 +<h3>Publique uma variante</h3> 1.409 +<p> 1.410 +Um arquivo .flavor possui alguns Kb de tamanho, então você pode enviá-lo 1.411 +para a lista de discussão do SliTaz. 1.412 +</p> 1.413 +<p> 1.414 +Os arquivos resultantes do comando <b>tazlito extract flavor</b> pode 1.415 +também ser colocado no repositório mercurial (http://repos.slitaz.org/flavors). 1.416 +Este método é preferido porque a estrutura de pastas poderá ser 1.417 +acessada diretamente por uma 1.418 +<a href="http://hg.slitaz.org/flavors/file/tip">interface web</a>. 1.419 +</p> 1.420 +<p> 1.421 +Esta estrutura inclui: 1.422 +</p> 1.423 +<ul> 1.424 +<li> 1.425 +Uma <b>receita</b> (arquivo <i>receipt</i>) que descreve a variante 1.426 +por intermédio das variáveis: 1.427 + <ul> 1.428 + <li> 1.429 +FLAVOR: O nome da variante. 1.430 + </li> 1.431 + <li> 1.432 +SHORT_DESC: Uma curta descrição 1.433 + </li> 1.434 + <li> 1.435 +VERSION: Versão. 1.436 + </li> 1.437 + <li> 1.438 +MAINTAINER: Email do desenvolvedor/criador. 1.439 + </li> 1.440 + <li> 1.441 +FRUGAL_RAM: Memória RAM mínima recomendável (variável opcional). 1.442 + </li> 1.443 + <li> 1.444 +ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM (opcional). 1.445 + </li> 1.446 + <li> 1.447 +INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CDROM (opcional). 1.448 + </li> 1.449 + <li> 1.450 +ISO_SIZE: Tamanho do CDROM (opcional). 1.451 + </li> 1.452 + <li> 1.453 +ROOTFS_SELECTION: Opcional, veja <i>Meta flavor</i> abaixo. 1.454 + </li> 1.455 + </ul> 1.456 +</li> 1.457 +<li> 1.458 +O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar 1.459 +uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis). 1.460 +Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja 1.461 +definida. 1.462 +</li> 1.463 +<li> 1.464 +O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais 1.465 +(undigest) a serem incluidos para se obter pacotes personalizados. 1.466 +</li> 1.467 +<li> 1.468 +O diretório opcional <b>rootfs</b> contem uma estrutura de pastas e arquivos 1.469 +a serem adicionados ao sistema de arquivos rootfs.gz (normalmente serão 1.470 +arquivos de configuração). 1.471 +</li> 1.472 +<li> 1.473 +O diretório opcional <b>rootcd</b> contem uma estrutura de pastas e arquivos 1.474 +a serem adicionados ao CDROM. 1.475 +</li> 1.476 +</ul> 1.477 + 1.478 +<a name="tune-flavor"></a> 1.479 +<h3>Adapte uma variante</h3> 1.480 +<p> 1.481 +Às vezes é mais fácil modificar uma variante existente do que criar uma 1.482 +nova. Para adaptar a variante eeepc, por exemplo: 1.483 +</p> 1.484 +<pre> 1.485 +# tazpkg get-install mercurial 1.486 +# cd /home/slitaz 1.487 +# hg clone http://hg.slitaz.org/flavors 1.488 +# cd flavors 1.489 +# cp -a eeepc myslitaz 1.490 +</pre> 1.491 +<p> 1.492 +Arquivos em <i>my-slitaz</i> podem ser adaptados, então: 1.493 +</p> 1.494 +<pre> 1.495 +# tazlito pack-flavor myslitaz 1.496 +</pre> 1.497 +<p> 1.498 +Isto irá criar uma nova variante adaptada de uma outra existente. 1.499 +</p> 1.500 +<p> 1.501 +Dica: Pode-se evitar a instalação do mercurial extraindo-se uma variante. 1.502 +Usando o exemplo anterior: 1.503 +</p> 1.504 +<pre> 1.505 +# tazlito get-flavor eeepc 1.506 +# tazlito extract-flavor eeepc.flavor 1.507 +# cd /home/slitaz/flavors 1.508 +# cp -a eeepc myslitaz 1.509 +</pre> 1.510 + 1.511 +<a name="meta-flavor"></a> 1.512 +<h3>Meta flavor</h3> 1.513 +<p> 1.514 +Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se 1.515 +iniciar o sistema com uma meta variante, uma variante contida no LiveCD 1.516 +irá ser chamada dependendo do tamanho da memória RAM disponível. A 1.517 +variável ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os 1.518 +parametros das variantes existentes. Exemplo usando a meta variante 1.519 +<a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"></a>: 1.520 +</p> 1.521 +<pre> 1.522 +ROOTFS_SELECTION="160M core 96M justX 32M base" 1.523 +</pre> 1.524 +<p> 1.525 +Este tipo de variante não possui uma lista de pacotes (packages.list) 1.526 +e só é suportada no SliTaz a partir do kernel 2.6.30. 1.527 +</p> 1.528 + 1.529 +<h2>MANTENEDOR</h2> 1.530 +<p> 1.531 +Christophe Lincoln <pankso at slitaz.org><br /> 1.532 +Pascal bellard <pascal.bellard at slitaz.org> 1.533 +</p> 1.534 + 1.535 +<!-- End content --> 1.536 +</div> 1.537 +</body> 1.538 +</html> 1.539 +
2.1 --- a/doc/tazlito.pt_BR.html Tue Aug 07 18:49:08 2012 +0200 2.2 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 2.3 @@ -1,536 +0,0 @@ 2.4 -<!DOCTYPE html> 2.5 -<html xmlns="http://www.w3.org/1999/xhtml" lang="en"> 2.6 -<head> 2.7 - <title>Manual Tazlito - Ferramenta Live do SliTaz</title> 2.8 - <meta charset="utf-8" /> 2.9 - <link rel="shortcut icon" href="favicon.ico" /> 2.10 - <link rel="stylesheet" type="text/css" href="style.css" /> 2.11 -</head> 2.12 -<body> 2.13 - 2.14 -<div id="header"> 2.15 - <h1>Manual Tazlito</h1> 2.16 -</div> 2.17 - 2.18 -<!-- Start content --> 2.19 -<div id="content"> 2.20 - 2.21 -<h2>NOME</h2> 2.22 -<p> 2.23 -Tazlito - SliTaz Live Tool. 2.24 -</p> 2.25 - 2.26 -<h2>SINTAXE</h2> 2.27 -<pre> 2.28 -tazlito [command] [list|iso|flavor] [dir] 2.29 -</pre> 2.30 - 2.31 -<h2>DESCRIÇÃO</h2> 2.32 - 2.33 -<p> 2.34 -Tazlito é um pequeno utilitário que extrai um LiveCD, reconstrói a imagem ISO 2.35 -e regenera o sistema de arquivos root do LiveCD, criando uma variante 2.36 -(flavor) da distribuição. O Tazlito também pode gerar uma distribuição a 2.37 -partir de uma lista de pacotes previamente baixados. Para rodar, o Tazlito 2.38 -usa o arquivo de configuração /etc/slitaz-tools/tazlito.conf ou o 2.39 -tazlito.conf gerado pelo Tazlito no diretório atual. Este arquivo especifica 2.40 -o nome da ISO, volume, mantenedor, os caminhos dos pacotes a serem incluidos 2.41 -e da ISO a ser gerada. Tazlito também pode ser usado para configurar um 2.42 -diretório contendo arquivos adicionais que serão copiados para o LiveCD na 2.43 -geração da distribuição. 2.44 -</p> 2.45 - 2.46 -<p> 2.47 -Tazlito é distribuído sobre a licença livre GNU GPL V3, istalada por padrão no 2.48 -SliTaz e instalada/testada com sucesso no Debian GNU/Linux. Você irá encontrar 2.49 -informações adicionais sobre a criação de um LiveCD no Manual SliTaz. 2.50 -</p> 2.51 - 2.52 -<h2>COMANDOS</h2> 2.53 - 2.54 -<a name="usage"></a> 2.55 -<h3>usage</h3> 2.56 -<p> 2.57 -O comando "usage" mostra um resumo dos comandos disponíveis com uma pequena 2.58 -descrição: 2.59 -</p> 2.60 -<pre> 2.61 - # tazlito usage 2.62 -</pre> 2.63 - 2.64 -<a name="stats"></a> 2.65 -<h3>stats</h3> 2.66 -<p> 2.67 -"Stats" mostra as variáveis da configuração, os caminhos para os vários arquivos 2.68 -e diretórios e informações sobre a imagem ISO: 2.69 -</p> 2.70 -<pre> 2.71 - # tazlito stats 2.72 -</pre> 2.73 - 2.74 -<a name="gen-config"></a> 2.75 -<h3>gen-config</h3> 2.76 -<p> 2.77 -O comando "gen-config" permite a geração do arquivo de configuração pronto para 2.78 -ser editado. Por padrão o arquivo é criado no diretório atual, mas também pode 2.79 -ser em outro diretório informado na linha de comando: 2.80 -</p> 2.81 -<pre> 2.82 - # tazlito gen-config 2.83 - # tazlito gen-config /path/to/distro 2.84 -</pre> 2.85 - 2.86 -<a name="configure"></a> 2.87 -<h3>configure</h3> 2.88 -<p> 2.89 -Este comando pode configurar o arquivo de configuração do sistema ou o encontrado 2.90 -no diretório atual: 2.91 -</p> 2.92 -<pre> 2.93 - # tazlito configure 2.94 -</pre> 2.95 - 2.96 -<a name="gen-iso"></a> 2.97 -<h3>gen-iso</h3> 2.98 -<p> 2.99 -O comando "gen-iso" pode gerar uma nova imagem do LiveCD a partir de modificações 2.100 -e adições ao sistema de arquivos root do cdrom. Para funcionar, este comando 2.101 -precisa de um diretório que contenha a "árvore" da distribuição do sistema Live. 2.102 -Esta "árvore" pode ser facilmente gerada com o comando "extract-distro", modificada 2.103 -ou reconstruida via: 2.104 -</p> 2.105 -<pre> 2.106 - # tazlito gen-iso 2.107 -</pre> 2.108 - 2.109 -<a name="gen-initiso"></a> 2.110 -<h3>gen-initiso</h3> 2.111 -<p> 2.112 -O comando "gen-initiso" faz o mesmo que o "gen-iso", mas antes ele reconstrói o 2.113 -sistema comprimido initramfs. O initramfs contem o sistema de arquivos root e 2.114 -deve ser reconstruído se modificado: 2.115 -</p> 2.116 -<pre> 2.117 - # tazlito gen-initiso 2.118 -</pre> 2.119 - 2.120 -<a name="list-flavors"></a> 2.121 -<h3>list-flavors</h3> 2.122 -<p> 2.123 -Este comando baixa (se necessário) e mostra a lista de diferentes variantes 2.124 -disponíveis. Pode-se forçar o download com a opção --recharge: 2.125 -</p> 2.126 -<pre> 2.127 - # tazlito list-flavors 2.128 - # tazlito list-flavors --recharge 2.129 -</pre> 2.130 - 2.131 -<a name="get-flavor"></a> 2.132 -<h3>get-flavor</h3> 2.133 -<p> 2.134 -O comando "get-flavor" baixa (se necessário) e prepara os arquivos para que o 2.135 -comando "gen-distro" gere uma variante: 2.136 -</p> 2.137 -<pre> 2.138 - # tazlito get-flavor particular-flavor 2.139 -</pre> 2.140 - 2.141 -<a name="show-flavor"></a> 2.142 -<h3>show-flavor</h3> 2.143 -<p> 2.144 -Este comando mostra a descrição da variante e seu tamanho após a regeneração. 2.145 -As opções --brief e --hoheader reduzem a saida do comando: 2.146 -</p> 2.147 -<pre> 2.148 - # tazlito show-flavor particular-flavor 2.149 - # tazlito show-flavor particular-flavor --brief 2.150 - # tazlito show-flavor particular-flavor --brief --noheader 2.151 -</pre> 2.152 - 2.153 -<a name="gen-flavor"></a> 2.154 -<h3>gen-flavor</h3> 2.155 -<p> 2.156 -O comando "gen-flavor" cria um arquivo de descrição de uma nova variante a partir 2.157 -dos resultados da regeneração da distro (gen-distro). O arquivo .flavor pode 2.158 -ser enviado ao slitaz.org: 2.159 -</p> 2.160 -<pre> 2.161 - # tazlito gen-flavor new-flavor 2.162 -</pre> 2.163 - 2.164 -<a name="gen-liveflavor"></a> 2.165 -<h3>gen-liveflavor</h3> 2.166 -<p> 2.167 -Este comando cria um arquivo de descrição de uma nova variante a partir 2.168 -dos resultados de geração da distro baseada no sistema atual. A opção 2.169 ---help mostra mais informações 2.170 -</p> 2.171 -<pre> # tazlito gen-liveflavor 2.172 - # tazlito gen-liveflavor --help 2.173 -</pre> 2.174 - 2.175 -<a name="upgrade-flavor"></a> 2.176 -<h3>upgrade-flavor</h3> 2.177 -<p> 2.178 -Este comando renova um arquivo flavor, atualizando a lista de pacotes 2.179 -com a versão mais recente disponível no mirror: 2.180 -</p> 2.181 -<pre> 2.182 - # tazlito upgrade-flavor this-flavor 2.183 -</pre> 2.184 - 2.185 -<a name="extract-flavor"></a> 2.186 -<h3>extract-flavor</h3> 2.187 -<p> 2.188 -O comando 'extract-flavor' converte um flavor em uma estrutura de pastas 2.189 -facilmente modificável em /home/slitaz/VERSION/flavors que pode ser ser 2.190 -gerenciada com o mercurial: 2.191 -<a href="http://hg.slitaz.org/flavors">http://hg.slitaz.org/flavors</a>. 2.192 -</p> 2.193 -<pre> 2.194 - # tazlito extract-flavor this-flavor 2.195 -</pre> 2.196 - 2.197 -<a name="pack-flavor"></a> 2.198 -<h3>pack-flavor</h3> 2.199 -<p> 2.200 -Este comando converte uma estrutura de pastas encontrada em 2.201 -/home/slitaz/VERSION/flavors em um arquivo de variante (.flavor). É o 2.202 -inverso do que o comando 'extract-flavor' faz: 2.203 -</p> 2.204 -<pre> 2.205 - # tazlito pack-flavor this-flavor 2.206 -</pre> 2.207 - 2.208 -<a name="extract-distro"></a> 2.209 -<h3>extract-distro</h3> 2.210 -<p> 2.211 -Este comando é usado para extrair uma imagem ISO do LiveCD e reconstruir a 2.212 -estrutura do cdrom e sistema root. Isto possibilita fazer as mudanças desejadas, 2.213 -adições e reconstruções da imagem ISO por meio do comando "gen-iso" ou 2.214 -"gen-initiso". Exemplo de uso: 2.215 -</p> 2.216 -<pre> 2.217 - # tazlito extract-distro slitaz-cooking.iso 2.218 -</pre> 2.219 - 2.220 -<a name="gen-distro"></a> 2.221 -<h3>gen-distro</h3> 2.222 -<p> 2.223 -O comando para <em>Geração de Distribuição</em> pode gerar a árvore da distribuição 2.224 -e a imagem ISO por meio de uma lista de pacotes. Para funcionar, este comando 2.225 -precisa da lista de pacotes, um diretório contendo todos os pacotes .tazpgk 2.226 -especificados na lista e um diretório para gerar a distribuição. A lista de 2.227 -pacotes pode ser extraida de uma variante pelo comando "get-flavor". Ao se 2.228 -utilizar o LiveCD, as opções --cdrom e --iso= permitem a regeneração dos 2.229 -pacotes que adicionam arquivos ao diretório /boot sem que seja necessário o 2.230 -download dos mesmos e recuperam os arquivos adicionais do LiveCD. O caminho 2.231 -para os vários diretórios é informado no arquivo de configuração e os pacotes 2.232 -podem ser baixados dos mirrors do SliTaz ou gerados pelo Cookutils. Para gerar uma 2.233 -distribuição: 2.234 -</p> 2.235 -<pre> 2.236 - # tazlito gen-distro 2.237 - # tazlito gen-distro --cdrom 2.238 - # tazlito gen-distro --iso=slitaz.iso 2.239 - # tazlito gen-distro package-list 2.240 -</pre> 2.241 - 2.242 -<a name="clean-distro"></a> 2.243 -<h3>clean-distro</h3> 2.244 -<p> 2.245 -Remove todos os arquivos gerados ou extraidos da estrutura do LiveCD: 2.246 -</p> 2.247 -<pre> 2.248 - # tazlito clean-distro 2.249 -</pre> 2.250 - 2.251 -<a name="check-distro"></a> 2.252 -<h3>check-distro</h3> 2.253 -<p> 2.254 -Este comando simplesmente verifica se os arquivos instalados pelos pacotes estão 2.255 -presentes no sistema: 2.256 -</p> 2.257 -<pre> 2.258 - # tazlito check-distro 2.259 -</pre> 2.260 - 2.261 -<a name="writeiso"></a> 2.262 -<h3>writeiso</h3> 2.263 -<p> 2.264 -Este comando irá converter o sistema de arquivos atual em um arquivo 2.265 -cpio (rootfs.gz) e então gerar uma imagem ISO inicializável. Pode ser 2.266 -usado tanto em instalações no HD quanto em modo LiveCD, e irá arquivar 2.267 -também o conteúdo do diretório /home. Com ele, pode-se facilmente 2.268 -remasterizar e construir sua própria imagem de LiveCD. Para tanto 2.269 -inicie o sistema, modifique arquivos, instale pacotes e então: 2.270 -</p> 2.271 -<pre> 2.272 - # tazlito writeiso [gzip|lzma|none] 2.273 - # tazlito writeiso gzip 2.274 - # tazlito writeiso gzip image-name 2.275 -</pre> 2.276 - 2.277 -<a name="frugal-install"></a> 2.278 -<h3>frugal-install</h3> 2.279 -<p> 2.280 -Executa uma instalação frugal em /boot/frugal e adiciona uma entrada ao 2.281 -GRUB, caso necessário. Este tipo de instalação irá rodar o SliTaz 2.282 -diretamente na memória RAM (mesmo comportamento do LiveCD), o que 2.283 -permite testar a distro ou ter um sistema de recuperação pronto para uso. 2.284 -Para instalar todos os arquivos necessários a partir de uma estrutura 2.285 -de pastas ou de uma imagem ISO: 2.286 -</p> 2.287 -<pre> 2.288 - # tazlito frugal-install 2.289 - # tazlito -fi slitaz.iso 2.290 -</pre> 2.291 - 2.292 -<a name="check-list"></a> 2.293 -<h3>check-list</h3> 2.294 -<p> 2.295 -Verifica se o arquivo distro-packages.list está atualizado com as 2.296 -mais recentes versões dos pacotes: 2.297 -</p> 2.298 -<pre> 2.299 - # tazlito check-list 2.300 -</pre> 2.301 - 2.302 -<a name="repack"></a> 2.303 -<h3>repack</h3> 2.304 -<p> 2.305 -Comprime novamente o rootfs com a melhor compressão possível: 2.306 -</p> 2.307 -<pre> 2.308 - # tazlito repack slitaz.iso 2.309 -</pre> 2.310 - 2.311 -<a name="merge"></a> 2.312 -<h3>merge</h3> 2.313 -<p> 2.314 -Combina diversas variantes. Cada rootfs é uma consequência de seu 2.315 -anterior. O primeiro rootfs é extraido da imagem ISO indicada como 2.316 -terceiro argumento. As variantes serão escolhidas no momento do boot, 2.317 -de acordo com a memória RAM disponível: 2.318 -</p> 2.319 -<pre> 2.320 - # tazlito merge 160M slitaz-core.iso 96M rootfs-justx.gz 32M rootfs-base.gz 2.321 -</pre> 2.322 - 2.323 -<a name="build-loram"></a> 2.324 -<h3>build-loram</h3> 2.325 -<p> 2.326 -Cria uma variante para sistemas com pouca memória RAM à partir de uma 2.327 -imagem ISO do SliTaz. Pode-se gerar uma variante que seja carregada na 2.328 -diretamente na memória ou lida a partir do cdrom: 2.329 -</p> 2.330 -<pre> 2.331 - # tazlito build-loram slitaz.iso loram.iso 2.332 - # tazlito build-loram slitaz.iso loram-cdrom.iso cdrom 2.333 -</pre> 2.334 - 2.335 -<a name="emu-iso"></a> 2.336 -<h3>emu-iso</h3> 2.337 -<p> 2.338 -O comando emu-iso utiliza o emulador Qemu para iniciar e rodar o SliTaz. 2.339 -É util para testar a iso criada sem a necessidade de gravá-la em um 2.340 -cdrom ou bootar em modo frugal. 2.341 -</p> 2.342 -<pre> # tazlito emu-iso 2.343 - # tazlito emu-iso path/to/image.iso 2.344 -</pre> 2.345 - 2.346 -<a name="burn-iso"></a> 2.347 -<h3>burn-iso</h3> 2.348 -<p> 2.349 -O comando "burn-iso" obtém informações sobre o dispositivo de cd e as velocidades 2.350 -permitidas para gravação, e o wodim (parte do cdrkit) inicia para gravar a imagem 2.351 -ISO. A imagem ISo padrão é aquela especificada no arquivo de configuração, mas 2.352 -é possível especificar uma imagem diferente por meio da linha de comando: 2.353 -</p> 2.354 -<pre> 2.355 - # tazlito burn-iso 2.356 - # tazlito burn-iso slitaz-hacked.iso 2.357 -</pre> 2.358 - 2.359 -<h2>FLAVORS</h2> 2.360 -<p> 2.361 -Um arquivo <i>.flavor</i> contém somente alguns poucos Kb de informação 2.362 -necessária para (re)construir um LiveCD customizado do SliTaz. 2.363 -</p> 2.364 - 2.365 -<a name="rebuild-flavor"></a> 2.366 -<h3>(Re)construa uma variante</h3> 2.367 -<p> 2.368 -Você pode escolher uma variante para (re)construir a partir daquelas 2.369 -disponíveis: 2.370 -</p> 2.371 -<pre> 2.372 -# tazlito list-flavors 2.373 - 2.374 -List of flavors 2.375 -================================================================================ 2.376 -Name ISO Rootfs Description 2.377 -================================================================================ 2.378 -base 6.9M 13.1M Minimal set of packages to boot 2.379 -core-3in1 31.5M 105.6M SliTaz core system with justX and base alternatives 2.380 -core 31.5M 104.6M SliTaz core system 2.381 -eeepc 31.2M 105.4M SliTaz eeepc system 2.382 -justX 16.1M 51.2M SliTaz with a minimal X environment 2.383 -</pre> 2.384 -<p> 2.385 -Como exeplo, começaremos a reconstruir a variante <i>eeepc</i> que 2.386 -ocupa 105.4M de RAM e possui um tamanho de imagem ISO de 31.2M: 2.387 -</p> 2.388 -<pre> 2.389 -# tazlito clean-distro 2.390 -# tazlito get-flavor eeepc 2.391 -# tazlito gen-distro 2.392 -</pre> 2.393 - 2.394 -<a name="create-flavor"></a> 2.395 -<h3>Crie uma variante</h3> 2.396 -<p> 2.397 -Para criar uma variante, você deve: 2.398 -</p> 2.399 -<ul> 2.400 - <li>Criar uma imagem ISO usando o comando <b>tazlito-gen-distro</b> 2.401 - e então criar um arquivo flavor usando <b>tazlito gen-flavor</b>; ou</li> 2.402 - <li>Criar diretamente uma estrutura de arquivos que define o flavor 2.403 - (veja <b>tazlito extract-flavor</b>) e então criar o flavor 2.404 - usando <b>tazlito pack-flavor</b>.</li> 2.405 -</ul> 2.406 - 2.407 -<a name="publish-flavor"></a> 2.408 -<h3>Publique uma variante</h3> 2.409 -<p> 2.410 -Um arquivo .flavor possui alguns Kb de tamanho, então você pode enviá-lo 2.411 -para a lista de discussão do SliTaz. 2.412 -</p> 2.413 -<p> 2.414 -Os arquivos resultantes do comando <b>tazlito extract flavor</b> pode 2.415 -também ser colocado no repositório mercurial (http://repos.slitaz.org/flavors). 2.416 -Este método é preferido porque a estrutura de pastas poderá ser 2.417 -acessada diretamente por uma 2.418 -<a href="http://hg.slitaz.org/flavors/file/tip">interface web</a>. 2.419 -</p> 2.420 -<p> 2.421 -Esta estrutura inclui: 2.422 -</p> 2.423 -<ul> 2.424 -<li> 2.425 -Uma <b>receita</b> (arquivo <i>receipt</i>) que descreve a variante 2.426 -por intermédio das variáveis: 2.427 - <ul> 2.428 - <li> 2.429 -FLAVOR: O nome da variante. 2.430 - </li> 2.431 - <li> 2.432 -SHORT_DESC: Uma curta descrição 2.433 - </li> 2.434 - <li> 2.435 -VERSION: Versão. 2.436 - </li> 2.437 - <li> 2.438 -MAINTAINER: Email do desenvolvedor/criador. 2.439 - </li> 2.440 - <li> 2.441 -FRUGAL_RAM: Memória RAM mínima recomendável (variável opcional). 2.442 - </li> 2.443 - <li> 2.444 -ROOTFS_SIZE: Tamanho que o rootfs.gz ocupa descomprimido na RAM (opcional). 2.445 - </li> 2.446 - <li> 2.447 -INITRAMFS_SIZE: Tamanho que o rootfs.gz ocupa em um CDROM (opcional). 2.448 - </li> 2.449 - <li> 2.450 -ISO_SIZE: Tamanho do CDROM (opcional). 2.451 - </li> 2.452 - <li> 2.453 -ROOTFS_SELECTION: Opcional, veja <i>Meta flavor</i> abaixo. 2.454 - </li> 2.455 - </ul> 2.456 -</li> 2.457 -<li> 2.458 -O arquivo <b>packages.list</b> contem a lista de pacotes sem especificar 2.459 -uma versão (o tazlito sempre utiliza os últimos pacotes disponíveis). 2.460 -Este arquivo não aparece caso a variável ROOTFS_SELECTION esteja 2.461 -definida. 2.462 -</li> 2.463 -<li> 2.464 -O arquivo opcional <b>mirrors</b> contem a lista de mirror não oficiais 2.465 -(undigest) a serem incluidos para se obter pacotes personalizados. 2.466 -</li> 2.467 -<li> 2.468 -O diretório opcional <b>rootfs</b> contem uma estrutura de pastas e arquivos 2.469 -a serem adicionados ao sistema de arquivos rootfs.gz (normalmente serão 2.470 -arquivos de configuração). 2.471 -</li> 2.472 -<li> 2.473 -O diretório opcional <b>rootcd</b> contem uma estrutura de pastas e arquivos 2.474 -a serem adicionados ao CDROM. 2.475 -</li> 2.476 -</ul> 2.477 - 2.478 -<a name="tune-flavor"></a> 2.479 -<h3>Adapte uma variante</h3> 2.480 -<p> 2.481 -Às vezes é mais fácil modificar uma variante existente do que criar uma 2.482 -nova. Para adaptar a variante eeepc, por exemplo: 2.483 -</p> 2.484 -<pre> 2.485 -# tazpkg get-install mercurial 2.486 -# cd /home/slitaz 2.487 -# hg clone http://hg.slitaz.org/flavors 2.488 -# cd flavors 2.489 -# cp -a eeepc myslitaz 2.490 -</pre> 2.491 -<p> 2.492 -Arquivos em <i>my-slitaz</i> podem ser adaptados, então: 2.493 -</p> 2.494 -<pre> 2.495 -# tazlito pack-flavor myslitaz 2.496 -</pre> 2.497 -<p> 2.498 -Isto irá criar uma nova variante adaptada de uma outra existente. 2.499 -</p> 2.500 -<p> 2.501 -Dica: Pode-se evitar a instalação do mercurial extraindo-se uma variante. 2.502 -Usando o exemplo anterior: 2.503 -</p> 2.504 -<pre> 2.505 -# tazlito get-flavor eeepc 2.506 -# tazlito extract-flavor eeepc.flavor 2.507 -# cd /home/slitaz/flavors 2.508 -# cp -a eeepc myslitaz 2.509 -</pre> 2.510 - 2.511 -<a name="meta-flavor"></a> 2.512 -<h3>Meta flavor</h3> 2.513 -<p> 2.514 -Uma meta variante (meta flavor) contem diversas variantes juntas. Ao se 2.515 -iniciar o sistema com uma meta variante, uma variante contida no LiveCD 2.516 -irá ser chamada dependendo do tamanho da memória RAM disponível. A 2.517 -variável ROOTFS_SELECTION define o mínimo de RAM a ser utilizada e os 2.518 -parametros das variantes existentes. Exemplo usando a meta variante 2.519 -<a href="http://hg.slitaz.org/flavors/file/tip/core-3in1/receipt"></a>: 2.520 -</p> 2.521 -<pre> 2.522 -ROOTFS_SELECTION="160M core 96M justX 32M base" 2.523 -</pre> 2.524 -<p> 2.525 -Este tipo de variante não possui uma lista de pacotes (packages.list) 2.526 -e só é suportada no SliTaz a partir do kernel 2.6.30. 2.527 -</p> 2.528 - 2.529 -<h2>MANTENEDOR</h2> 2.530 -<p> 2.531 -Christophe Lincoln <pankso at slitaz.org><br /> 2.532 -Pascal bellard <pascal.bellard at slitaz.org> 2.533 -</p> 2.534 - 2.535 -<!-- End content --> 2.536 -</div> 2.537 -</body> 2.538 -</html> 2.539 -