tazlito diff doc/tazlito.pt.html @ rev 305
tazlito/deduplicate: ln may fail
author | Pascal Bellard <pascal.bellard@slitaz.org> |
---|---|
date | Sat Feb 02 10:38:08 2013 +0100 (2013-02-02) |
parents | |
children | 07b0ae7de856 |
line diff
1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/doc/tazlito.pt.html Sat Feb 02 10:38:08 2013 +0100 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 +