tazpkg annotate doc/tazpkg.pt.html @ rev 519

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