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

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