tazpkg view doc/tazpkg.pt.html @ rev 509

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