tazpkg diff doc/tazpkg.pt.html @ rev 316

Prepa for release 3.2.1
author: Pascal Bellard <pascal.bellard@slitaz.org>
date: Thu Feb 11 11:11:45 2010 +0100 (2010-02-11)
children: 8e77902dd45b
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/doc/tazpkg.pt.html	Thu Feb 11 11:11:45 2010 +0100
     1.3 @@ -0,0 +1,374 @@
     1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
     1.5 +    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
     1.6 +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt" lang="pt">
     1.7 +<head>
     1.8 +    <title>Tazpkg Manual</title>
     1.9 +    <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" />
    1.10 +    <meta name="description" content="" />
    1.11 +    <meta name="expires" content="never" />
    1.12 +    <meta name="modified" content="2008-07-18 19:45:00" />
    1.13 +    <style type="text/css"><!--
    1.14 +    body { font: 90% sans-serif, vernada, arial; margin: 0; }
    1.15 +    #header { background: #f0ba08; color: black; height: 50px;
    1.16 +        border-top: 1px solid black; border-bottom: 1px solid black; }
    1.17 +    #content { margin: 0px 50px 26px 50px; }
    1.18 +    h1 { margin: 14px 0px 0px 16px; }
    1.19 +    li { line-height: 1.4em; }
    1.20 +    pre { padding: 5px; color: black; background: #e1e0b0; }
    1.21 +    pre.script { padding: 10px; color: black; background: #e8e8e8;
    1.22 +        border: 1px inset #333333; }
    1.23 +    code { font-size: 100%; color: #669900; background: transparent; }
    1.24 +    hr { color: white; background: white; height: 1px; border: 0; }
    1.25 +    --></style>
    1.26 +</head>
    1.27 +<body bgcolor="#ffffff">
    1.28 +<div id="header">
    1.29 +<h1><font color="#3e1220">Manual Tazpkg</font></h1>
    1.30 +</div>
    1.31 +<hr />
    1.32 +<!-- Start content -->
    1.33 +<div id="content">
    1.34 +
    1.35 +<h2>NOME</h2>
    1.36 +<p>
    1.37 +Tazpkg - Tiny autonomous zone package manager
    1.38 +</p>
    1.39 +
    1.40 +<h2>SINTAXE</h2>
    1.41 +<pre>
    1.42 + tazpkg [command] [package|dir|pattern|list|cat|--opt] [dir|--opt]
    1.43 +</pre>
    1.44 +
    1.45 +<h2>DESCRI��O</h2>
    1.46 +<p>
    1.47 +Tazpkg � um gerenciador de pacotes ultraleve (~ 35KB) que instala, lista, baixa,
    1.48 +atualiza ou remove pacotes precompilados em um sistema GNU/Linux. Tazpkg fornece
    1.49 +comandos para busca e cria��o de pacotes e foi criado independentemente. Os 
    1.50 +pacotes usando a extens�o *.tazpkg s�o constituidos de arquivos cpio 
    1.51 +que cont�m um sistema de arquivos comprimido com o gzip, uma receita e uma 
    1.52 +descri��o opcional. O Tazpkg tamb�m gerencia depend�ncias baseado nas receitas
    1.53 +de pacote: cada receita cont�m todas as informa��es sobre um pacote e tamb�m
    1.54 +pode incluir fun��es de pr� e p�s-instala��o. A mesma receita � usada pelo
    1.55 +Tazwok para compilar fontes e gerar um pacote .tazpkg.
    1.56 +</p>
    1.57 +<p>
    1.58 +O Tazpkg � inteiramente constru�do a partir do zero usando SHell Script.
    1.59 +Compat�vel com o Bash, roda sobre o Ash - parte do projeto Busybox. O Tazpkg
    1.60 +� distribu�do sob a licen�a livre GNU GPL V3.
    1.61 +</p>
    1.62 +
    1.63 +<h2>COMANDOS</h2>
    1.64 +<a name="list"></a>
    1.65 +<h3><font color="#6c0023">list</font></h3>
    1.66 +<p>
    1.67 +Lista pacotes instalados no sistema. Este comando mostra uma lista em formato
    1.68 +de coluna com todos os pacotes instalados, e tamb�m permite listar categorias,
    1.69 +pacotes baseados em categorias e pacotes bloqueados para instala��o. Voc� tamb�m
    1.70 +pode usar o comando "search" (buscar) para uma lista baseada em um termo ou em
    1.71 +um nome de pacote:
    1.72 +</p>
    1.73 +<pre>
    1.74 + # tazpkg list
    1.75 + # tazpkg list cat|categories
    1.76 + # tazpkg list blocked
    1.77 +</pre>
    1.78 +<a name="xhtml-list"></a>
    1.79 +<h3><font color="#6c0023">xhtml-list</font></h3>
    1.80 +<p>
    1.81 +O comando "xhtml-list" cria uma lista em formato xHTML de todos os pacotes
    1.82 +instalados no sistema que pode ser lida com o seu navegador web favorito. Pode
    1.83 +ser utilizado por um usu�rio comum e criar uma p�gina "instaled-packages.html"
    1.84 +(pacotes instalados) no diret�rio atual. Note que voc� pode mudar o nome da 
    1.85 +lista gerada por meio da linha de comando:
    1.86 +</p>
    1.87 +<pre>
    1.88 + # tazpkg xhtml-list
    1.89 + # tazpkg xhtml-list list-name.html
    1.90 +</pre>
    1.91 +<a name="list-mirror"></a>
    1.92 +<h3><font color="#6c0023">list-mirror</font></h3>
    1.93 +<p>
    1.94 +Lista pacotes dispon�veis no mirror. Este comando mostra o arquivo "packages-list"
    1.95 +recarregado a partir do mirror. Se este arquivo n�o existir, ser� pedido a 
    1.96 +voc� que rode o comando "tazpkg recharge" como usu�rio root para listar os
    1.97 +pacotes dispon�veis. A op��o --diff � usada para mostrar as diferen�as entre
    1.98 +a �ltima e a atual lista de pacotes:
    1.99 +</p>
   1.100 +<pre>
   1.101 + # tazpkg list-mirror
   1.102 + # tazpkg list-mirror --diff
   1.103 +</pre>
   1.104 +<a name="info"></a>
   1.105 +<h3><font color="#6c0023">info</font></h3>
   1.106 +<p>
   1.107 +Mostra qualquer informa��o dispon�vel na receita para o pacote em quest�o - sua
   1.108 +vers�o, categoria, mantenedor, website e quaisquer depend�ncias (veja tamb�m 
   1.109 +Tazwok para mais informa��es sobre receitas):
   1.110 +</p>
   1.111 +<pre>
   1.112 + # tazpkg info busybox
   1.113 +</pre>
   1.114 +<a name="desc"></a>
   1.115 +<h3><font color="#6c0023">desc</font></h3>
   1.116 +<p>
   1.117 +Descri��o do pacote (se existir). Este comando mostra o arquivo "description.txt"
   1.118 +de cada pacote (um arquivo de texto simples, justificado em 80 caracteres para
   1.119 +caber num terminal padr�o):
   1.120 +</p>
   1.121 +<pre>
   1.122 + # tazpkg desc busybox
   1.123 +</pre>
   1.124 +<a name="list-config"></a>
   1.125 +<h3><font color="#6c0023">list-config</font></h3>
   1.126 +<p>
   1.127 +Lista os arquivos de configura��o do sistema. A op��o --box mostra estas
   1.128 +informa��es em formato de tabela
   1.129 +</p>
   1.130 +<pre> # tazpkg list-config
   1.131 + # tazpkg list-config --box
   1.132 +</pre>
   1.133 +<a name="list-files"></a>
   1.134 +<h3><font color="#6c0023">list-files</font></h3>
   1.135 +<p>
   1.136 +Lista todos os arquivos instalados pelo pacote. Este comando l� e mostra o
   1.137 +conte�do do arquivo "files.list" de cada pacote, o qual � automaticamente gerado
   1.138 +quando um pacote � criado e tamb�m � usado para remover arquivos quando se 
   1.139 +desinstala um pacote. Para listar os arquivos instalados pelo pacote bc:
   1.140 +</p>
   1.141 +<pre>
   1.142 + # tazpkg list-files bc
   1.143 +</pre>
   1.144 +<a name="search"></a>
   1.145 +<h3><font color="#6c0023">search</font></h3>
   1.146 +<p>
   1.147 +Busca por pacotes por propriet�rio ou nome do pacote. Este comando busca pelo
   1.148 +termo informado nos pacotes instalados e na lista de pacotes dispon�veis no
   1.149 +mirror. Para obter a mais recente lista de pacotes dispon�veis, rode "tazkpg
   1.150 +recharge" antes de iniciar uma busca:
   1.151 +</p>
   1.152 +<pre>
   1.153 + # tazpkg search gcc
   1.154 +</pre>
   1.155 +<a name="search-file"></a>
   1.156 +<h3><font color="#6c0023">search-file</font></h3>
   1.157 +<p>
   1.158 +O comando "search-file" permite a busca por um arquivo entre os instalados pelos
   1.159 +pacotes. Este comando � muito �til para achar o caminho completo para um 
   1.160 +arquivo e determinar se um arquivo est� presente no sistema. Exemplo:
   1.161 +</p>
   1.162 +<pre>
   1.163 + $ tazpkg search-file libnss
   1.164 +</pre>
   1.165 +<a name="install"></a>
   1.166 +<h3><font color="#6c0023">install</font></h3>
   1.167 +<p>
   1.168 +Este comando instala um pacote dispon�vel localmente que possui a extens�o
   1.169 +.tazpkg. Veja "get-install" para instalar pacotes dispon�ves na internet. Note
   1.170 +que voc� pode for�ar a instala��o com a op��o --force. Voc� tamb�m disp�e de 
   1.171 +op��es para desinstala��o e reinstala��o ou para especificar o sistema root 
   1.172 +no qual voc� deseja instalar o pacote com a op��o -root= op��o:
   1.173 +</p>
   1.174 +<pre>
   1.175 + # tazpkg install package-1.0.tazpkg
   1.176 + Ou :
   1.177 + # tazpkg install path/to/package-1.0.tazpkg --forced
   1.178 + Ou :
   1.179 + # tazpkg install path/to/package-1.0.tazpkg --root=/mnt/rootfs
   1.180 +</pre>
   1.181 +<h3><font color="#6c0023">install-list ou get-install-list</font></h3>
   1.182 +<p>
   1.183 +Instala uma sele��o de pacotes listados em um arquivo. Este comando permite a
   1.184 +voc� instalar v�rios pacotes com um �nico comando, e tamb�m oferece a op��o 
   1.185 +--forced:
   1.186 +</p>
   1.187 +<pre>
   1.188 + # tazpkg install-list my-packages.list
   1.189 + # tazpkg get-install-list my-packages.list --forced
   1.190 +</pre>
   1.191 +<a name="remove"></a>
   1.192 +<h3><font color="#6c0023">remove</font></h3>
   1.193 +<p>
   1.194 +Remove um pacote. Ser� pedido que voc� confirme a a��o (y/N). Este comando
   1.195 +deleta todos os arquivos instalados pelo pacote. Para ver a lista de arquivos,
   1.196 +use o comando "list-files" seguido do nome do pacote. Exemplo com o pacote bc:
   1.197 +</p>
   1.198 +<pre>
   1.199 + # tazpkg remove bc
   1.200 +</pre>
   1.201 +<a name="extract"></a>
   1.202 +<h3><font color="#6c0023">extract</font></h3>
   1.203 +<p>
   1.204 +Extrai um pacote em um diret�rio. Se voc� n�o especificar o diret�rio de destino,
   1.205 +o pacote ser� extraido no diret�rio atual usando o formato nome do pacote-vers�o:
   1.206 +</p>
   1.207 +<pre>
   1.208 + # tazpkg extract package.tazpkg
   1.209 + # tazpkg extract package.tazpkg target/dir
   1.210 +</pre>
   1.211 +<a name="pack"></a>
   1.212 +<h3><font color="#6c0023">pack</font></h3>
   1.213 +<p>
   1.214 +O comando "pack" cria um pacote a partir de um diret�rio preparado previamente
   1.215 +ou a partir de um pacote extraido localmente. Pode tamb�m criar manualmente um
   1.216 +pacote .tazpkg (veja a documenta��o do Tazwok para a cria��o autom�tica de 
   1.217 +pacotes). Para "empacotar" (pack) um pacote:
   1.218 +</p>
   1.219 +<pre>
   1.220 + # tazpkg pack package-version
   1.221 +</pre>
   1.222 +<a name="repack"></a>
   1.223 +<h3><font color="#6c0023">repack</font></h3>
   1.224 +<p>
   1.225 +O comando "repack" permite a recria��o de um pacote a partir dos arquivos
   1.226 +instalados no sistema em que este pacote foi instalado. Para "re-empacotar"
   1.227 +(repack) um pacote:
   1.228 +</p>
   1.229 +<pre>
   1.230 + # tazpkg repack package
   1.231 +</pre>
   1.232 +<a name="repack-config"></a>
   1.233 +<h3><font color="#6c0023">repack-config</font></h3>
   1.234 +<p>
   1.235 +O comando 'repack-config' recria um pacote a partir dos arquivos de 
   1.236 +configura��o do sistema (veja list-config). � suficiente para instalar
   1.237 +um pacote para encontrar a configura��o atual. Para re-empacotar os 
   1.238 +arquivos de configura��o:
   1.239 +</p>
   1.240 +<pre> # tazpkg repack-config
   1.241 +</pre>
   1.242 +<a name="recharge"></a>
   1.243 +<h3><font color="#6c0023">recharge</font></h3>
   1.244 +<p>
   1.245 +Recarrega a lista de pacotes dispon�ves no mirror. Este comando baixa o arquivo
   1.246 +"packages.list" (lista de pacotes instal�veis) mais recente e salva a antiga. 
   1.247 +Uma vez que a lista est� atualizada, voc� pode usar os comandos "list" e 
   1.248 +"search". Para ver uma rela��o com as diferen�as entre a lista atual e a 
   1.249 +antiga, use o comando "list-mirror --diff" e para ver e atualizar pacotes,
   1.250 +use o comando "upgrade". Para recarregar a lista de pacotes:
   1.251 +</p>
   1.252 +<pre>
   1.253 + # tazpkg recharge
   1.254 +</pre>
   1.255 +<a name="upgrade"></a>
   1.256 +<h3><font color="#6c0023">upgrade</font></h3>
   1.257 +<p>
   1.258 +Este comando permite a atualiza��o de todos os pacotes dispon�veis no mirror.
   1.259 +Atualizar pacotes � uma parte importante da manuten��o da seguran�a do sistema,
   1.260 +permitindo o acesso �s �ltimas atualiza��es e corre��es. O projeto SliTaz,
   1.261 +embora leve, fornece atualiza��es de seguran�a regulares e geralmente oferece
   1.262 +as �ltimas vers�es dos programas. Note que esta fun��o � direcionada �quelas
   1.263 +pessoas que possuem o SliTaz instalado no seu disco r�gido. Pacotes atualizados
   1.264 +a partir do LiveCD ser�o perdidos no desligamento do sistema. Para atualizar:
   1.265 +</p>
   1.266 +<pre>
   1.267 + # tazpkg upgrade
   1.268 +</pre>
   1.269 +<a name="check"></a>
   1.270 +<h3><font color="#6c0023">check</font></h3>
   1.271 +<p>
   1.272 +O comando "check" checa por depend�ncias em pacotes instalados e determina
   1.273 +se todos os arquivos necess�rios para o re-empacotamento de um pacote est�o
   1.274 +presentes:
   1.275 +</p>
   1.276 +<pre>
   1.277 + # tazpkg check package
   1.278 +</pre>
   1.279 +<a name="block"></a>
   1.280 +<h3><font color="#6c0023">block ou unblock</font></h3>
   1.281 +<p>
   1.282 +Os comandos "block" e "unblock" permitem o bloqueio de pacotes instalados para
   1.283 +que estes n�o possam ser atualizados com o comando "upgrade". A lista de pacotes
   1.284 +bloqueados est� contida no arquivo /var/lib/tazpkg/blocked-packages.list, 
   1.285 +que tamb�m pode ser editado manualmente. Para bloquear ou desbloquear pacotes,
   1.286 +como o Grub, por exemplo:
   1.287 +</p>
   1.288 +<pre>
   1.289 + # tazpkg block grub
   1.290 + Ou :
   1.291 + # tazpkg unblock grub
   1.292 +</pre>
   1.293 +<a name="get"></a>
   1.294 +<h3><font color="#6c0023">get</font></h3>
   1.295 +<p>
   1.296 +Baixa um pacote do mirror (se existir). O arquivo baixado � arquivado no
   1.297 +diret�rio atual. Para descobrir qual o diret�rio atual utilize o comando "pwd".
   1.298 +Para baixar o pacote Grub:
   1.299 +</p>
   1.300 +<pre>
   1.301 + # tazpkg get grub
   1.302 +</pre>
   1.303 +<a name="get-install"></a>
   1.304 +<h3><font color="#6c0023">get-install</font></h3>
   1.305 +<p>
   1.306 +Baixa e instala um pacote de um mirror na internet. O comando "get-install" 
   1.307 +inicia checando se o pacote requerido existe no mirror e se j� foi baixado.
   1.308 +Para uma lista de pacotes do mirror, usa-se o comando "list-mirror". Para 
   1.309 +baixar e instalar o pacote Grub:
   1.310 +</p>
   1.311 +<pre>
   1.312 + # tazpkg get-install grub
   1.313 +</pre>
   1.314 +<a name="clean-cache"></a>
   1.315 +<h3><font color="#6c0023">clean-cache</font></h3>
   1.316 +<p>
   1.317 +Remove pacotes *.tazpkg baixados que se encontram no cache. Durante a instala��o,
   1.318 +o Tazpkg mant�m uma c�pia dos pacotes baixados da internet. Isto � feito para
   1.319 +economizar banda no caso de uma reinstala��o, mas pode ser que voc� queira
   1.320 +ter mais espa�o no disco r�gido ou baixar os pacotes novamente:
   1.321 +</p>
   1.322 +<pre>
   1.323 + # tazpkg clean-cache
   1.324 +</pre>
   1.325 +<a name="setup-mirror"></a>
   1.326 +<h3><font color="#6c0023">setup-mirror</font></h3>
   1.327 +<p>
   1.328 +Configura a URL do mirror. O comando "setup-mirror" pedir� a URL do novo mirror.
   1.329 +Voc� pode especificar v�rias URLs separadas por espa�os. Note que voc� tamb�m
   1.330 +pode modificar manualmente o arquivo /var/lib/tazpkg/mirror. A URL deve apontar
   1.331 +para um diret�rio contendo um arquivo "packages.list" e os pacotes:
   1.332 +</p>
   1.333 +<pre>
   1.334 + # tazpkg setup-mirror
   1.335 +</pre>
   1.336 +<a name="reconfigure"></a>
   1.337 +<h3><font color="#6c0023">reconfigure</font></h3>
   1.338 +<p>
   1.339 +Executa novamente o script de p�s instala��o de um pacote. Exemplo
   1.340 +usando o gcc:
   1.341 +</p>
   1.342 +<pre> # tazpkg reconfigure gcc
   1.343 +</pre>
   1.344 +<a name="depends"></a>
   1.345 +<h3><font color="#6c0023">depends ou rdepends</font></h3>
   1.346 +<p>
   1.347 +Mostra a �rvore de depend�ncias (direta ou inversamente) para um pacote.
   1.348 +Exemplo utilizando o mpd:
   1.349 +</p>
   1.350 +<pre> # tazpkg depends mpd
   1.351 + # tazpkg rdepends mpd
   1.352 +</pre>
   1.353 +<a name="set-release"></a>
   1.354 +<h3><font color="#6c0023">set-release</font></h3>
   1.355 +<p>
   1.356 +Este comando muda a vers�o atual e faz a atualiza��o de pacotes para
   1.357 +o lan�amento mais recente:
   1.358 +</p>
   1.359 +<pre> # tazpkg set-release cooking
   1.360 +</pre>
   1.361 +<a name="bugs"></a>
   1.362 +<h3><font color="#6c0023">bugs</font></h3>
   1.363 +<p>
   1.364 +Mostra uma lista de bugs conhecidos dos pacotes:
   1.365 +</p>
   1.366 +<pre> # tazpkg bugs
   1.367 +</pre>
   1.368 +<h2>MANTENEDOR</h2>
   1.369 +<p>
   1.370 +Christophe Lincoln &lt;pankso at slitaz.org&gt;
   1.371 +</p>
   1.372 +
   1.373 +</div>
   1.374 +<!-- End content -->
   1.375 +</body>
   1.376 +</html>
   1.377 +
author	Pascal Bellard <pascal.bellard@slitaz.org>
date	Thu Feb 11 11:11:45 2010 +0100 (2010-02-11)
parents
children	8e77902dd45b