tazpkg annotate doc/tazpkg.pt_BR.html @ rev 571

doc: add some clear markup to en, providing it in css (do we need 88% letters size? its small; auto-hyphenation added), add ru doc
author Aleksej Bobylev <al.bobylev@gmail.com>
date Thu Mar 22 16:40:10 2012 +0200 (2012-03-22)
parents bb26956e94ad
children 456401591663
rev   line source
claudinei@568 1 <!DOCTYPE html>
al@571 2 <html xmlns="http://www.w3.org/1999/xhtml" lang="pt_BR">
claudinei@568 3 <head>
claudinei@568 4 <title>Manual Tazpkg (pt)</title>
claudinei@568 5 <meta charset="utf-8" />
claudinei@568 6 <link rel="shortcut icon" href="favicon.ico" />
claudinei@568 7 <link rel="stylesheet" type="text/css" href="style.css" />
claudinei@568 8 </head>
claudinei@568 9 <body>
claudinei@568 10
claudinei@568 11 <!-- Header -->
claudinei@568 12 <div id="header">
claudinei@568 13 <h1>Manual Tazpkg</h1>
claudinei@568 14 </div>
claudinei@568 15
claudinei@568 16 <!-- Start content -->
claudinei@568 17 <div id="content">
claudinei@568 18
claudinei@568 19 <h2>NOME</h2>
claudinei@568 20
claudinei@568 21 <p>
claudinei@568 22 Tazpkg - Tiny autonomous zone package manager
claudinei@568 23 </p>
claudinei@568 24
claudinei@568 25 <h2>SINTAXE</h2>
claudinei@568 26
claudinei@568 27 <pre>
claudinei@568 28 tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
claudinei@568 29 </pre>
claudinei@568 30
claudinei@568 31 <h2>DESCRIÇÃO</h2>
claudinei@568 32
claudinei@568 33 <p>
claudinei@568 34 Tazpkg é um gerenciador de pacotes ultraleve (~ 35KB) que instala, lista, baixa,
claudinei@568 35 atualiza ou remove pacotes precompilados em um sistema GNU/Linux. Tazpkg fornece
claudinei@568 36 comandos para busca e criação de pacotes e foi criado independentemente. Os
claudinei@568 37 pacotes usando a extensão *.tazpkg são constituidos de arquivos cpio
claudinei@568 38 que contém um sistema de arquivos comprimido com o gzip, uma receita e uma
claudinei@568 39 descrição opcional. O Tazpkg também gerencia dependências baseado nas receitas
claudinei@568 40 de pacote: cada receita contém todas as informações sobre um pacote e também
claudinei@568 41 pode incluir funções de pré e pós-instalação. A mesma receita é usada pelo
claudinei@568 42 Tazwok para compilar fontes e gerar um pacote .tazpkg.
claudinei@568 43 </p>
claudinei@568 44 <p>
claudinei@568 45 O Tazpkg é inteiramente construído a partir do zero usando SHell Script.
claudinei@568 46 Compatível com o Bash, roda sobre o Ash - parte do projeto Busybox. O Tazpkg
claudinei@568 47 é distribuído sob a licença livre GNU GPL V3.
claudinei@568 48 </p>
claudinei@568 49
claudinei@568 50 <h2>COMANDOS</h2>
claudinei@568 51
claudinei@568 52 <a name="list"></a>
claudinei@568 53 <h3>list</h3>
claudinei@568 54 <p>
claudinei@568 55 Lista pacotes instalados no sistema. Este comando mostra uma lista em formato
claudinei@568 56 de coluna com todos os pacotes instalados, e também permite listar categorias,
claudinei@568 57 pacotes baseados em categorias e pacotes bloqueados para instalação. Você também
claudinei@568 58 pode usar o comando "search" (buscar) para uma lista baseada em um termo ou em
claudinei@568 59 um nome de pacote:
claudinei@568 60 </p>
claudinei@568 61 <pre>
claudinei@568 62 # tazpkg list
claudinei@568 63 # tazpkg list cat|categories
claudinei@568 64 # tazpkg list blocked
claudinei@568 65 </pre>
claudinei@568 66
claudinei@568 67 <a name="xhtml-list"></a>
claudinei@568 68 <h3>xhtml-list</h3>
claudinei@568 69 <p>
claudinei@568 70 O comando "xhtml-list" cria uma lista em formato xHTML de todos os pacotes
claudinei@568 71 instalados no sistema que pode ser lida com o seu navegador web favorito. Pode
claudinei@568 72 ser utilizado por um usuário comum e criar uma página "instaled-packages.html"
claudinei@568 73 (pacotes instalados) no diretório atual. Note que você pode mudar o nome da
claudinei@568 74 lista gerada por meio da linha de comando:
claudinei@568 75 </p>
claudinei@568 76 <pre>
claudinei@568 77 # tazpkg xhtml-list
claudinei@568 78 # tazpkg xhtml-list list-name.html
claudinei@568 79 </pre>
claudinei@568 80
claudinei@568 81 <a name="list-mirror"></a>
claudinei@568 82 <h3>list-mirror</h3>
claudinei@568 83 <p>
claudinei@568 84 Lista pacotes disponíveis no mirror. Este comando mostra o arquivo "packages-list"
claudinei@568 85 recarregado a partir do mirror. Se este arquivo não existir, será pedido a
claudinei@568 86 você que rode o comando "tazpkg recharge" como usuário root para listar os
claudinei@568 87 pacotes disponíveis. A opção --diff é usada para mostrar as diferenças entre
claudinei@568 88 a última e a atual lista de pacotes:
claudinei@568 89 </p>
claudinei@568 90 <pre>
claudinei@568 91 # tazpkg list-mirror
claudinei@568 92 # tazpkg list-mirror --diff
claudinei@568 93 </pre>
claudinei@568 94
claudinei@568 95 <a name="info"></a>
claudinei@568 96 <h3>info</h3>
claudinei@568 97 <p>
claudinei@568 98 Mostra qualquer informação disponível na receita para o pacote em questão - sua
claudinei@568 99 versão, categoria, mantenedor, website e quaisquer dependências (veja também
claudinei@568 100 Tazwok para mais informações sobre receitas):
claudinei@568 101 </p>
claudinei@568 102 <pre>
claudinei@568 103 # tazpkg info busybox
claudinei@568 104 </pre>
claudinei@568 105
claudinei@568 106 <a name="desc"></a>
claudinei@568 107 <h3>desc</h3>
claudinei@568 108 <p>
claudinei@568 109 Descrição do pacote (se existir). Este comando mostra o arquivo "description.txt"
claudinei@568 110 de cada pacote (um arquivo de texto simples, justificado em 80 caracteres para
claudinei@568 111 caber num terminal padrão):
claudinei@568 112 </p>
claudinei@568 113 <pre>
claudinei@568 114 # tazpkg desc busybox
claudinei@568 115 </pre>
claudinei@568 116
claudinei@568 117 <a name="list-config"></a>
claudinei@568 118 <h3>list-config</h3>
claudinei@568 119 <p>
claudinei@568 120 Lista os arquivos de configuração do sistema. A opção --box mostra estas
claudinei@568 121 informações em formato de tabela
claudinei@568 122 </p>
claudinei@568 123 <pre> # tazpkg list-config
claudinei@568 124 # tazpkg list-config --box
claudinei@568 125 </pre>
claudinei@568 126
claudinei@568 127 <a name="list-files"></a>
claudinei@568 128 <h3>list-files</h3>
claudinei@568 129 <p>
claudinei@568 130 Lista todos os arquivos instalados pelo pacote. Este comando lê e mostra o
claudinei@568 131 conteúdo do arquivo "files.list" de cada pacote, o qual é automaticamente gerado
claudinei@568 132 quando um pacote é criado e também é usado para remover arquivos quando se
claudinei@568 133 desinstala um pacote. Para listar os arquivos instalados pelo pacote bc:
claudinei@568 134 </p>
claudinei@568 135 <pre>
claudinei@568 136 # tazpkg list-files bc
claudinei@568 137 </pre>
claudinei@568 138
claudinei@568 139 <a name="search"></a>
claudinei@568 140 <h3>search</h3>
claudinei@568 141 <p>
claudinei@568 142 Busca por pacotes por proprietário ou nome do pacote. Este comando busca pelo
claudinei@568 143 termo informado nos pacotes instalados e na lista de pacotes disponíveis no
claudinei@568 144 mirror. Para obter a mais recente lista de pacotes disponíveis, rode "tazkpg
claudinei@568 145 recharge" antes de iniciar uma busca:
claudinei@568 146 </p>
claudinei@568 147 <pre>
claudinei@568 148 # tazpkg search gcc
claudinei@568 149 </pre>
claudinei@568 150
claudinei@568 151 <a name="search-file"></a>
claudinei@568 152 <h3>search-file</h3>
claudinei@568 153 <p>
claudinei@568 154 O comando "search-file" permite a busca por um arquivo entre os instalados pelos
claudinei@568 155 pacotes. Este comando é muito útil para achar o caminho completo para um
claudinei@568 156 arquivo e determinar se um arquivo está presente no sistema. Exemplo:
claudinei@568 157 </p>
claudinei@568 158 <pre>
claudinei@568 159 $ tazpkg search-file libnss
claudinei@568 160 </pre>
claudinei@568 161
claudinei@568 162 <a name="install"></a>
claudinei@568 163 <h3>install</h3>
claudinei@568 164 <p>
claudinei@568 165 Este comando instala um pacote disponível localmente que possui a extensão
claudinei@568 166 .tazpkg. Veja "get-install" para instalar pacotes disponíves na internet. Note
claudinei@568 167 que você pode forçar a instalação com a opção --force. Você também dispõe de
claudinei@568 168 opções para desinstalação e reinstalação ou para especificar o sistema root
claudinei@568 169 no qual você deseja instalar o pacote com a opção -root= :
claudinei@568 170 </p>
claudinei@568 171 <pre>
claudinei@568 172 # tazpkg install package-1.0.tazpkg
claudinei@568 173 # tazpkg install path/to/package-1.0.tazpkg --forced
claudinei@568 174 # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
claudinei@568 175 </pre>
claudinei@568 176
claudinei@568 177 <a name="install-list"></a>
claudinei@568 178 <h3>install-list ou get-install-list</h3>
claudinei@568 179 <p>
claudinei@568 180 Instala uma seleção de pacotes listados em um arquivo. Este comando permite a
claudinei@568 181 você instalar vários pacotes com um único comando, e também oferece a opção
claudinei@568 182 --forced:
claudinei@568 183 </p>
claudinei@568 184 <pre>
claudinei@568 185 # tazpkg install-list my-packages.list
claudinei@568 186 # tazpkg get-install-list my-packages.list --forced
claudinei@568 187 </pre>
claudinei@568 188
claudinei@568 189 <a name="link"></a>
claudinei@568 190 <h3>link</h3>
claudinei@568 191 <p>
claudinei@568 192 Permite a instalação de um pacote a partir de uma mídia qualquer.
claudinei@568 193 A configuração é feita criando links simbólicos e consome pouca memória.
claudinei@568 194 Geralmente é usado em sistemas LiveCD para instalar pacotes encontrados
claudinei@568 195 numa mídia USB:
claudinei@568 196 </p>
claudinei@568 197 <pre>
claudinei@568 198 # tazpkg link openoffice /media/usbdisk
claudinei@568 199 </pre>
claudinei@568 200
claudinei@568 201 <a name="remove"></a>
claudinei@568 202 <h3>remove</h3>
claudinei@568 203 <p>
claudinei@568 204 Remove um pacote. Será pedido que você confirme a ação (y/N). Este comando
claudinei@568 205 deleta todos os arquivos instalados pelo pacote. Para ver a lista de arquivos,
claudinei@568 206 use o comando "list-files" seguido do nome do pacote. Exemplo com o pacote bc:
claudinei@568 207 </p>
claudinei@568 208 <pre>
claudinei@568 209 # tazpkg remove bc
claudinei@568 210 </pre>
claudinei@568 211
claudinei@568 212 <a name="extract"></a>
claudinei@568 213 <h3>extract</h3>
claudinei@568 214 <p>
claudinei@568 215 Extrai um pacote em um diretório. Se você não especificar o diretório de destino,
claudinei@568 216 o pacote será extraido no diretório atual usando o formato nome do pacote-versão:
claudinei@568 217 </p>
claudinei@568 218 <pre>
claudinei@568 219 # tazpkg extract package.tazpkg
claudinei@568 220 # tazpkg extract package.tazpkg target/dir
claudinei@568 221 </pre>
claudinei@568 222
claudinei@568 223 <a name="pack"></a>
claudinei@568 224 <h3>pack</h3>
claudinei@568 225 <p>
claudinei@568 226 O comando "pack" cria um pacote a partir de um diretório preparado previamente
claudinei@568 227 ou a partir de um pacote extraido localmente. Pode também criar manualmente um
claudinei@568 228 pacote .tazpkg (veja a documentação do Tazwok para a criação automática de
claudinei@568 229 pacotes). Para "empacotar" (pack) um pacote:
claudinei@568 230 </p>
claudinei@568 231 <pre>
claudinei@568 232 # tazpkg pack package-version
claudinei@568 233 </pre>
claudinei@568 234
claudinei@568 235 <a name="repack"></a>
claudinei@568 236 <h3>repack</h3>
claudinei@568 237 <p>
claudinei@568 238 O comando "repack" permite a recriação de um pacote a partir dos arquivos
claudinei@568 239 instalados no sistema em que este pacote foi instalado. Para "re-empacotar"
claudinei@568 240 (repack) um pacote:
claudinei@568 241 </p>
claudinei@568 242 <pre>
claudinei@568 243 # tazpkg repack package
claudinei@568 244 </pre>
claudinei@568 245
claudinei@568 246 <a name="repack-config"></a>
claudinei@568 247 <h3>repack-config</h3>
claudinei@568 248 <p>
claudinei@568 249 O comando 'repack-config' recria um pacote a partir dos arquivos de
claudinei@568 250 configuração do sistema (veja list-config). É suficiente para instalar
claudinei@568 251 um pacote para encontrar a configuração atual. Para re-empacotar os
claudinei@568 252 arquivos de configuração:
claudinei@568 253 </p>
claudinei@568 254 <pre> # tazpkg repack-config
claudinei@568 255 </pre>
claudinei@568 256
claudinei@568 257 <a name="recharge"></a>
claudinei@568 258 <h3>recharge</h3>
claudinei@568 259 <p>
claudinei@568 260 Recarrega a lista de pacotes disponíves no mirror. Este comando baixa o arquivo
claudinei@568 261 "packages.list" (lista de pacotes instaláveis) mais recente e salva a antiga.
claudinei@568 262 Uma vez que a lista está atualizada, você pode usar os comandos "list" e
claudinei@568 263 "search". Para ver uma relação com as diferenças entre a lista atual e a
claudinei@568 264 antiga, use o comando "list-mirror --diff" e para ver e atualizar pacotes,
claudinei@568 265 use o comando "upgrade". Para recarregar a lista de pacotes:
claudinei@568 266 </p>
claudinei@568 267 <pre>
claudinei@568 268 # tazpkg recharge
claudinei@568 269 </pre>
claudinei@568 270
claudinei@568 271 <a name="upgrade"></a>
claudinei@568 272 <h3>up ou upgrade</h3>
claudinei@568 273 <p>
claudinei@568 274 O comando upgrade permite a atualização de todos os pacotes disponíveis no mirror.
claudinei@568 275 Atualizar pacotes é uma parte importante da manutenção da segurança do sistema,
claudinei@568 276 permitindo o acesso às últimas atualizações e correções. O projeto SliTaz,
claudinei@568 277 embora leve, fornece atualizações de segurança regulares e geralmente oferece
claudinei@568 278 as últimas versões dos programas. Note que esta função é direcionada àquelas
claudinei@568 279 pessoas que possuem o SliTaz instalado no seu disco rígido. Pacotes atualizados
claudinei@568 280 a partir do LiveCD serão perdidos no desligamento do sistema. Para atualizar
claudinei@568 281 ou mostrar as opções para o comando:
claudinei@568 282 </p>
claudinei@568 283 <pre>
claudinei@568 284 # tazpkg up
claudinei@568 285 # tazpkg --help-up
claudinei@568 286 # tazpkg up --recharge --install
claudinei@568 287 # tazpkg up -r -i
claudinei@568 288 </pre>
claudinei@568 289
claudinei@568 290 <a name="check"></a>
claudinei@568 291 <h3>check</h3>
claudinei@568 292 <p>
claudinei@568 293 O comando "check" checa por dependências em pacotes instalados e determina
claudinei@568 294 se todos os arquivos necessários para o re-empacotamento de um pacote estão
claudinei@568 295 presentes:
claudinei@568 296 </p>
claudinei@568 297 <pre>
claudinei@568 298 # tazpkg check package
claudinei@568 299 </pre>
claudinei@568 300
claudinei@568 301 <a name="block"></a>
claudinei@568 302 <h3>block ou unblock</h3>
claudinei@568 303 <p>
claudinei@568 304 Os comandos "block" e "unblock" permitem o bloqueio de pacotes instalados para
claudinei@568 305 que estes não possam ser atualizados com o comando "upgrade". A lista de pacotes
claudinei@568 306 bloqueados está contida no arquivo /var/lib/tazpkg/blocked-packages.list,
claudinei@568 307 que também pode ser editado manualmente. Para bloquear ou desbloquear pacotes,
claudinei@568 308 como o Grub, por exemplo:
claudinei@568 309 </p>
claudinei@568 310 <pre>
claudinei@568 311 # tazpkg block grub
claudinei@568 312 Ou :
claudinei@568 313 # tazpkg unblock grub
claudinei@568 314 </pre>
claudinei@568 315
claudinei@568 316 <a name="get"></a>
claudinei@568 317 <h3>get</h3>
claudinei@568 318 <p>
claudinei@568 319 Baixa um pacote do mirror (se existir). O arquivo baixado é arquivado no
claudinei@568 320 diretório atual. Para descobrir qual o diretório atual utilize o comando "pwd".
claudinei@568 321 Para baixar o pacote Grub:
claudinei@568 322 </p>
claudinei@568 323 <pre>
claudinei@568 324 # tazpkg get grub
claudinei@568 325 </pre>
claudinei@568 326
claudinei@568 327 <a name="get-install"></a>
claudinei@568 328 <h3>get-install</h3>
claudinei@568 329 <p>
claudinei@568 330 Baixa e instala um pacote de um mirror na internet. O comando "get-install"
claudinei@568 331 inicia checando se o pacote requerido existe no mirror e se já foi baixado.
claudinei@568 332 Para uma lista de pacotes do mirror, usa-se o comando "list-mirror". Para
claudinei@568 333 baixar e instalar o pacote Grub:
claudinei@568 334 </p>
claudinei@568 335 <pre>
claudinei@568 336 # tazpkg get-install grub
claudinei@568 337 </pre>
claudinei@568 338
claudinei@568 339 <a name="clean-cache"></a>
claudinei@568 340 <h3>clean-cache</h3>
claudinei@568 341 <p>
claudinei@568 342 Remove pacotes *.tazpkg baixados que se encontram no cache. Durante a instalação,
claudinei@568 343 o Tazpkg mantém uma cópia dos pacotes baixados da internet. Isto é feito para
claudinei@568 344 economizar banda no caso de uma reinstalação, mas pode ser que você queira
claudinei@568 345 ter mais espaço no disco rígido ou baixar os pacotes novamente:
claudinei@568 346 </p>
claudinei@568 347 <pre>
claudinei@568 348 # tazpkg clean-cache
claudinei@568 349 </pre>
claudinei@568 350
claudinei@568 351 <a name="setup-mirror"></a>
claudinei@568 352 <h3>setup-mirror</h3>
claudinei@568 353 <p>
claudinei@568 354 Configura a URL do mirror. O comando "setup-mirror" pedirá a URL do novo mirror.
claudinei@568 355 Você pode especificar várias URLs separadas por espaços. Note que você também
claudinei@568 356 pode modificar manualmente o arquivo /var/lib/tazpkg/mirror. A URL deve apontar
claudinei@568 357 para um diretório contendo um arquivo "packages.list" e os pacotes:
claudinei@568 358 </p>
claudinei@568 359 <pre>
claudinei@568 360 # tazpkg setup-mirror
claudinei@568 361 </pre>
claudinei@568 362
claudinei@568 363 <a name="reconfigure"></a>
claudinei@568 364 <h3>reconfigure</h3>
claudinei@568 365 <p>
claudinei@568 366 Executa novamente o script de pós instalação de um pacote. Exemplo
claudinei@568 367 usando o gcc:
claudinei@568 368 </p>
claudinei@568 369 <pre> # tazpkg reconfigure gcc
claudinei@568 370 </pre>
claudinei@568 371
claudinei@568 372 <a name="depends"></a>
claudinei@568 373 <h3>depends ou rdepends</h3>
claudinei@568 374 <p>
claudinei@568 375 Mostra a árvore de dependências (direta ou inversamente) para um pacote.
claudinei@568 376 Exemplo utilizando o mpd:
claudinei@568 377 </p>
claudinei@568 378 <pre>
claudinei@568 379 # tazpkg depends mpd
claudinei@568 380 # tazpkg rdepends mpd
claudinei@568 381 </pre>
claudinei@568 382
claudinei@568 383 <a name="add-undigest"></a>
claudinei@568 384 <h3>add-undigest ou setup-undigest</h3>
claudinei@568 385 <p>
claudinei@568 386 Define a URL de um mirror não oficial para testar ou usar pacotes que
claudinei@568 387 não estão disponíveis no mirror oficial (chamados 'undigest'). Note que
claudinei@568 388 em vez de rodar este comando você pode editar diretamente o arquivo
claudinei@568 389 /var/lib/tazpkg/undigest/'repositorio'. A URL deve apontar para um
claudinei@568 390 diretório na web que contenha um arquivo 'packages.list':
claudinei@568 391 </p>
claudinei@568 392 <pre>
claudinei@568 393 # tazpkg add-undigest public-repository http://my.home.org/slitaz
claudinei@568 394 # tazpkg setup-undigest local-repository /home/slitaz/packages
claudinei@568 395 </pre>
claudinei@568 396
claudinei@568 397 <a name="remove-undigest"></a>
claudinei@568 398 <h3>remove-undigest</h3>
claudinei@568 399 <p>
claudinei@568 400 Remove a URL de um mirror undigest:
claudinei@568 401 </p>
claudinei@568 402 <pre>
claudinei@568 403 # tazpkg remove-undigest my-repository
claudinei@568 404 </pre>
claudinei@568 405
claudinei@568 406 <a name="list-undigest"></a>
claudinei@568 407 <h3>list-undigest</h3>
claudinei@568 408 <p>
claudinei@568 409 Lista os mirrors undigest adicionados:
claudinei@568 410 </p>
claudinei@568 411 <pre>
claudinei@568 412 # tazpkg list-undigest
claudinei@568 413 </pre>
claudinei@568 414
claudinei@568 415 <a name="convert"></a>
claudinei@568 416 <h3>convert</h3>
claudinei@568 417 <p>
claudinei@568 418 Converte pacotes .deb (debian), .rpm (RedHat), .tgz (Slackware) ou
claudinei@568 419 .pgk.tar.gz (Archlinux) em pacotes .tazpkg (SliTaz):
claudinei@568 420 </p>
claudinei@568 421 <pre>
claudinei@568 422 # tazpkg convert pacote{.deb|.rpm|.tgz|.pkg.tar.gz}
claudinei@568 423 </pre>
claudinei@568 424
claudinei@568 425 <a name="set-release"></a>
claudinei@568 426 <h3>set-release</h3>
claudinei@568 427 <p>
claudinei@568 428 Este comando muda a versão atual e faz a atualização de pacotes para
claudinei@568 429 o lançamento mais recente:
claudinei@568 430 </p>
claudinei@568 431 <pre> # tazpkg set-release cooking
claudinei@568 432 </pre>
claudinei@568 433
claudinei@568 434 <a name="bugs"></a>
claudinei@568 435 <h3>bugs</h3>
claudinei@568 436 <p>
claudinei@568 437 Mostra uma lista de bugs conhecidos dos pacotes:
claudinei@568 438 </p>
claudinei@568 439 <pre> # tazpkg bugs
claudinei@568 440 </pre>
claudinei@568 441 <h2>MANTENEDOR</h2>
claudinei@568 442 <p>
claudinei@568 443 Christophe Lincoln &lt;pankso at slitaz.org&gt;
claudinei@568 444 </p>
claudinei@568 445
claudinei@568 446 <!-- End content -->
claudinei@568 447 </div>
claudinei@568 448
claudinei@568 449 </body>
claudinei@568 450 </html>
claudinei@568 451