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

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