summaryrefslogtreecommitdiffstats
path: root/man/pt/dpkg-divert.pod
blob: 01aaa33b5f52c26e58acd76ec0a494b96e0b8ff6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

dpkg-divert - sobrepõe a versão de pacote de um ficheiro

=head1 SINOPSE

B<dpkg-divert> [I<option>...] I<command>

=head1 DESCRIÇÃO

B<dpkg-divert> é o utilitário usado para definir e actualizar a lista de
desvios.

I<diversions> de ficheiros são um modo de forçar o B<dpkg>(1)  a não
instalar um ficheiro na sua localização, mas numa localização
I<desviada>. Estes desvios podem ser usados através dos scripts de pacote
Debian para afastar um ficheiro quando este causa um conflito. Os
administradores de sistemas também o podem usar para sobrepor ficheiros de
configuração de alguns pacotes, ou sempre que alguns ficheiros (que não
sejam marcados como “conffiles”) precisam de ser conservados pelo B<dpkg>,
quando instala uma versão mais recente do pacote que contém esses ficheiros.

=head1 COMANDOS

=over 

=item [B<--add>] I<file>

Adiciona um desvio para I<file>. Este ficheiro é actualmente não renomeado,
veja B<--rename>.

=item B<--remove> I<file>

Remove um desvio para I<file>. Este ficheiro é actualmente não renomeado,
veja B<--rename>.

=item B<--list> I<glob-pattern>

Lista desvios que correspondem a I<glob-pattern>.

=item B<--listpackage> I<file>

Escreve o nome do pacote que desvia I<file> (desde dpkg 1.15.0).  Escreve
LOCAL se I<file> é desviado localmente e nada se I<file> não é desviado.

=item B<--truename> I<file>

Escreve o nome real para um ficheiro desviado.

=back

=head1 OPÇÕES

=over 

=item B<--admindir> I<directory>

Define o directório administrativo para I<directory>. A predefinição é
«I<%ADMINDIR%>».

=item B<--instdir> I<directory>

Define o directório de instalação, o qual se refere ao directório onde os
pacotes são instalados (desde dpkg 1.19.2). A predefinição é «I</>».

=item B<--root> I<directory>

Define o directório raiz para B<directory>, o que define o directório de
instalação para «I<directory>» e o directório administrativo apara
«I<directory>B<%ADMINDIR%>» (desde dpkg 1.19.2).

=item B<--divert> I<divert-to>

I<divert-to> é a localização para onde as versões de I<file>, como fornecido
por outros pacotes, serão desviadas.

=item B<--local>

Especifica que todas as versões de pacotes deste ficheiro são
desviadas. Isto significa, que não há excepções, e seja em que pacote esteja
instalado, o ficheiro é desviado. Isto pode ser usado pro uma administrador
para instalar uma versão modificada localmente.

=item B<--package> I<package>

I<package> é o nome do pacote cuja cópia de I<file> não será desviada. Isto
é, I<file> será desviado para todos os pacotes excepto I<package>.

=item B<--quiet>

Modo silencioso, isto é, não há resultados detalhados.

=item B<--rename>

Actualmente mete o ficheiro de lado (ou para trás). B<dpkg-divert> irá
abortar a operação no caso do ficheiro de destino já existir. Este é o
comportamento comum usado para desvios de ficheiros de um conjunto de
pacotes não-B<Essential> (veja B<--no-rename> para mais detalhes).

=item B<--no-rename>

Especifica que o ficheiro não deve ser renomeado enquanto se adiciona ou
remove o desvio na base de dados (desde dpkg 1.19.1). Isto destina-se a
desvios de ficheiros do conjunto de pacotes B<Essential>, onde o
desaparecimento temporário do ficheiro original não é aceitável, pois pode
tornar o sistema não-funcional. Este é o comportamento predefinido, mas isso
irá mudar no ciclo dpkg 1.20.x.

=item B<--test>

Modo de teste, isto é, não faz realmente nenhumas alterações, apenas uma
demonstração.

=item B<-?>, B<--help>

Mostra a mensagem de utilização e termina.

=item B<--version>

Mostra a versão e termina.

=back

=head1 ESTADO À SAÍDA

=over 

=item B<0>

A acção requisitada foi executada com sucesso.

=item B<2>

Erro fatal ou irrecuperável devido a utilização de linha de comandos
inválida, ou interações com o sistema, tais como acesso à base de dados,
alocações de memória, etc.

=back

=head1 AMBIENTE

=over 

=item B<DPKG_ROOT>

Se definido e as opções B<--instdir> ou B<--root> não foram especificadas,
será usado como o directório raiz do sistema de ficheiros (desde dpkg
1.19.2).

=item B<DPKG_ADMINDIR>

Se definido e as opções B<--admindir> ou B<--root> não foram especificadas,
será usado como o directório de dados do B<dpkg>.

=item B<DPKG_MAINTSCRIPT_PACKAGE>

Se definido e as opções B<--local> e B<--package> não foram especificadas,
B<dpkg-divert> irá usá-lo como o nome do pacote.

=item B<DPKG_COLORS>

Define o modo de cor (desde dpkg 1.18.5). Os valores actualmente aceites
são: B<auto> (predefinido), B<always> e B<never>.

=back

=head1 FICHEIROS

=over 

=item I<%ADMINDIR%/diversions>

Ficheiro que contém a lista actual das divergências do sistema. Está
localizado no directório de administração do B<dpkg>, juntamente com outros
ficheiros importantes para o B<dpkg>, tais como <estado> ou I<disponível>.

B<Nota:> O B<dpkg-divert> preserva uma cópia antiga deste ficheiro, com a
extensão I<-old>, antes do o substituir pelo novo.

=back

=head1 NOTAS

Quando adiciona, a predefinição é B<--local> e B<--divert>
I<original>B<.distrib>. Quando remove, B<--package> ou B<--local> e
B<--divert> tem de corresponder se for especificado.

Os directórios não podem ser desviados com B<dpkg-divert>.

Deve tomar-se cuidado ao desviar bibliotecas partilhadas, B<ldconfig>(8)
cria um link simbólico baseado no campo DT_SONAME embebido na
biblioteca. Devido a B<ldconfig> não honrar desvios (apenas B<dpkg> o faz),
o link simbólico pode acabar a apontar para a biblioteca desviada, se uma
biblioteca desviada tiver o mesmo SONAME que a não desviada.

=head1 EXEMPLOS

Para desviar todas as cópias de um I</usr/bin/example> para
I</usr/bin/example.foo>, isto é, direcciona todos os pacotes que fornecem
I</usr/bin/example> para o instalar como I</usr/bin/example.foo>, executando
a mudança de nome caso necessário:

 dpkg-divert --divert /usr/bin/example.foo --rename /usr/bin/example

Para remover esse desvio:

 dpkg-divert --rename --remove /usr/bin/example

Para desviar qualquer pacote que tente instalar I</usr/bin/example> para
I</usr/bin/example.foo>, excepto o seu próprio pacote I<wibble>:

 dpkg-divert --package wibble --divert /usr/bin/example.foo \
    --rename /usr/bin/example

Para remover esse desvio:

 dpkg-divert --package wibble --rename --remove /usr/bin/example

=head1 VEJA TAMBÉM

B<dpkg>(1).


=head1 TRADUÇÃO

Américo Monteiro

Se encontrar algum erro na tradução deste documento, por favor comunique para
Américo Monteiro <a_monteiro@gmx.com>.