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
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
|
<!-- -*- mode: sgml; mode: fold -*- -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY % aptent SYSTEM "apt.ent.es">
%aptent;
]>
<!--
(c) 2003 Software in the Public Interest
Esta traducci�n ha sido realizada por Rub�n Porras Campo <nahoo@inicia.es>
Est� basada en la p�gina de manual original:
versi�n 1.6 del CVS de
/cvs/debian-doc/manpages/english/apt/apt-cache.8.sgml
-->
<refentry lang=es>
&apt-docinfo;
<refmeta>
<refentrytitle>apt-cache</>
<manvolnum>8</>
</refmeta>
<!-- Man page title -->
<refnamediv>
<refname>apt-cache</>
<refpurpose>utilidad de manejo de paquetes APT -- manipulador de cach�</>
</refnamediv>
<!-- Arguments -->
<refsynopsisdiv>
<cmdsynopsis>
<command>apt-cache</>
<arg><option>-hvsn</></arg>
<arg><option>-o=<replaceable/cadena de configuraci�n/</></arg>
<arg><option>-c=<replaceable/fichero/</></arg>
<group choice=req>
<arg>add <arg choice="plain" rep="repeat"><replaceable>fichero</replaceable></arg></arg>
<arg>gencaches</>
<arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
<arg>showsrc <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
<arg>stats</>
<arg>dump</>
<arg>dumpavail</>
<arg>unmet</>
<arg>search <arg choice="plain"><replaceable>expresi�n regular</replaceable></arg></arg>
<arg>show <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
<arg>depends <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
<arg>rdepends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg>
<arg>pkgnames <arg choice="plain"><replaceable>prefijo</replaceable></arg></arg>
<arg>dotty <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg>
<arg>policy <arg choice="plain" rep="repeat"><replaceable>paquetes</replaceable></arg></arg>
<arg>madison <arg choice="plain" rep="repeat"><replaceable>paquetes</replaceable></arg></arg>
</group>
</cmdsynopsis>
</refsynopsisdiv>
<RefSect1><Title>Descripci�n</>
<para>
<command/apt-cache/ realiza una serie de operaciones sobre la cach� de
paquetes de APT. <command/apt-cache/ no modifica el estado del sistema
pero proporciona operaciones de b�squeda en la informaci�n de los
paquetes, de las cuales se puede obtener informaci�n muy �til.
<para>
A menos que se proporcionen las opciones <option/-h/, o <option/--help/, se
debe de proporcionar una de las siguientes �rdenes:
<VariableList>
<VarListEntry><Term>add <replaceable/fichero(s)/</Term>
<ListItem><Para>
<literal/add/ a�ade el nombre del paquete a los ficheros de
�ndices de la cach� de paquetes. S�lo para depuraci�n.
</VarListEntry>
<VarListEntry><Term>gencaches</Term>
<ListItem><Para>
<literal/gencaches/ realiza la misma operaci�n que
<command/apt-get check/. Construye las cach�s de paquetes fuente y de
paquetes binarios, usando la lista de recursos en &sources-list;
junto con la informaci�n en <filename>/var/lib/dpkg/status</>.
</VarListEntry>
<VarListEntry><Term>showpkg <replaceable/paquete(s)/</Term>
<ListItem><Para>
<literal/showpkg/ muestra informaci�n acerca de los paquetes
listados en la l�nea de �rdenes. Los argumentos restantes se
consideran nombres de paquetes. Por cada paquete se mostrar�n las
versiones disponibles y los paquetes que dependen de �l (reverse
dependencies), as� como los paquetes de que depende (forward dependencies),
(los cuales deben de ser instalados para instalar el paquete).
Por ejemplo, <command>apt-cache showpkg libreadline2</> mostrar� algo
similar a lo siguiente:
<informalexample><programlisting>
Package: libreadline2
Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
Reverse Depends:
libreadlineg2,libreadline2
libreadline2-altdev,libreadline2
Dependencies:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
Provides:
2.1-12 -
Reverse Provides:
</programlisting></informalexample>
<para>
Esta informaci�n nos indica que la versi�n 2.1-12 de libreadline2,
depende de libc5 y ncurses3.0, ambos programas deben instalarse para
que libreadline2 pueda funcionar. Adem�s, libreadlineg2 y
libreadline2-altdev dependen de libreadline2. Es decir, si se instala
libreadline2, tambi�n se instalar�n libc5 y ncurses3.0 (y ldso), pero
libreadlineg2 y libreadline2-altdev no tienen que instalarse.
Para una informaci�n m�s especifica acerca del significado de la salida
consulte el c�digo fuente de apt.
</VarListEntry>
<VarListEntry><Term>stats</Term>
<ListItem><Para>
<literal/stats/ muestra algunas estad�sticas acerca de la cach�.
No necesita ning�n argumento adicional. Las estad�sticas que
muestra son:
<itemizedlist>
<listitem><para>
<literal/Total package names/ es el n�mero de paquetes encontrados
en la cach�.
</listitem>
<listitem><para>
<literal/Normal packages/ es el n�mero de paquetes normales. Estos
paquetes tienen una correspondencia un�voca entre sus nombres y
los nombres que usan otros paquetes al listarlos en sus
dependencias. La mayor�a de los paquetes pertenecen a este grupo.
</listitem>
<listitem><para>
<literal/Pure virtual packages/ es el n�mero de paquetes que
existen s�lo como nombre de paquete virtual, esto es, paquetes
que s�lo "proporcionan" el nombre del paquete virtual, y no hay
ning�n paquete m�s que use realmente el nombre. Por ejemplo,
"mail-transport-agent" en un sistema Debian GNU/Linux es un
paquete virtual puro, varios paquetes proporcionan
"mail-transport-agent", pero no hay ning�n paquete que se llame
"mail-transport-agent".
</listitem>
<listitem><para>
<literal/Single virtual packages/ es el n�mero de paquetes que
s�lo tiene un paquete real que los proporcione. Por ejemplo, en
un sistema Debian GNU/Linux, "X11-text-viewer" es un paquete
virtual, pero s�lo un paquete, xless, proporciona "X11-text-viewer".
</listitem>
<listitem><para>
<literal/Mixed virtual packages/ es el n�mero de paquetes que o
bien proporcionan un determinado paquete virtual o tienen el
mismo nombre como paquete virtual y como paquete real, en un
sistema Debian GNU/Linux, "debconf" es a la vez un paquete real,
y es proporcionado por el paquete debconf-tiny.
</listitem>
<listitem><para>
<literal/Missing/ es el n�mero de nombres de paquetes a los que se hace
referencia como dependencia pero que no son proporcionado por ning�n
paquete. Estos paquetes probablemente signifiquen que no se tiene
acceso al total de la distribuci�n, o bien que alg�n paquete (real o
virtual) ha sido eliminado de la distribuci�n. Normalmente se hace
referencia a ellos desde los campos de conflictos de la descripci�n
de los paquetes.
</listitem>
<listitem><para>
<literal/Total distinct versions/ es el n�mero de versiones de paquetes
encontrados en la cach�, por lo tanto el n�mero es al menos igual al
n�mero total de paquetes. Si m�s de una distribuci�n ("estable"
e "inestable", por ejemplo), se encuentra en la cach� al mismo
tiempo, este valor puede ser considerablemente mayor que el
n�mero total de paquetes.
</listitem>
<listitem><para>
<literal/Total dependencies/ es el n�mero total de relaciones de
dependencia necesitadas por todos los paquetes de la cach�.
</listitem>
</itemizedlist>
</VarListEntry>
<VarListEntry><Term>showsrc <replaceable/paquete(s)/</Term>
<ListItem><Para>
<literal/showsrc/ muestra todos los campos de los paquetes fuente que
coinciden con los nombres de los paquetes suministrados. Se muestran
todas las versiones, as� como los paquetes que son binarios.
</VarListEntry>
<VarListEntry><Term>dump</Term>
<ListItem><Para>
<literal/dump/ muestra una peque�a lista de todos los paquetes en la
cach�. Fundamentalmente para depuraci�n.
</VarListEntry>
<VarListEntry><Term>dumpavail</Term>
<ListItem><Para>
<literal/dumpavail/ env�a a la salida est�ndar una lista de los paquetes
disponibles. Esta lista es apropiada para su uso con &dpkg; y es
usada por el m�todo &dselect;.
</VarListEntry>
<VarListEntry><Term>unmet</Term>
<ListItem><Para>
<literal/unmet/ muestra un resumen de todas las dependencias no
satisfechas en la cach� de paquetes.
</VarListEntry>
<VarListEntry><Term>show <replaceable/paquete(s)/</Term>
<ListItem><Para>
<literal/show/ realiza una funci�n similar a <command>dpkg
--print-avail</>, muestra los datos de los paquetes listados.
</VarListEntry>
<VarListEntry><Term>search <replaceable/regex [regex ...]/</Term>
<ListItem><Para>
<literal/search/ realiza una b�squeda de la expresi�n regular
dada en todo el texto de todos los paquetes disponibles. Busca la
expresi�n regular tanto en el nombre de los paquetes como en
su descripci�n y muestra el nombre del paquete y una peque�a
descripci�n de este. Si se proporciona el argumento <option/--full/ el
resultado es el igual al que produce <literal/show/ para cada paquete en
concreto, pero si se proporciona el argumento <option/--names-only/
entonces s�lo se busca en el nombre de los paquetes.
<para>
Se pueden especificar argumentos separados para buscar una cadena de
caracteres que los contenga todos al mismo tiempo.
</VarListEntry>
<VarListEntry><Term>depends <replaceable/paquete(s)/</Term>
<ListItem><Para>
<literal/depends/ muestra una lista de todas la dependencias de
un paquete y de todos los paquetes que la pueden satisfacer.
</VarListEntry>
<VarListEntry><Term>rdepends <replaceable/paquetes(s)/</Term>
<ListItem><Para>
<literal/rdepends/ muestrade las dependencias inversas de un paquete.
</VarListEntry>
<VarListEntry><Term>pkgnames <replaceable/[ prefijo ]/</Term>
<ListItem><Para>
Esta orden muestra el nombre de todos los paquetes instalados en
el sistema. El argumento opcional es un prefijo por el cual se
filtrar�a la lista de nombres. La salida es apropiada para uso
junto con la funci�n de auto-completado mediante tabulador en un
int�rprete de �rdenes y se genera de forma extremadamente
r�pida. Su mejor uso es con la opci�n <option/--generate/.
</VarListEntry>
<VarListEntry><Term>dotty <replaceable/paquete(s)/</Term>
<ListItem><Para>
<literal/dotty/ toma una lista de paquetes de la l�nea de ordenes
y genera una salida apropiada para dotty, del paquete
<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>.
El resultado ser� una serie de nodos y uniones representando las
relaciones entre paquetes. Por omisi�n los paquetes dados
mostrar�n todas sus dependencias, lo que puede producir una
salida muy grande. Esto puede ser deshabilitado activando la
opci�n <literal>APT::Cache::GivenOnly</>.
<para>
Los nodos resultantes tendr�n varias formas, los paquetes normales son
cajas, pure provides son tri�ngulos, mixed provides son
diamantes, los paquetes no encontrados son hex�gonos. Las cajas naranjas
significan recursion was stopped [leaf packages], l�neas azules
son predependencias, l�neas verdes son conflictos.
<para>
Tenga cuidado, dotty no puede dibujar una gran cantidad de paquetes.
<VarListEntry><Term>policy <replaceable/[ paquete(s) ]/</Term>
<ListItem><Para>
<literal/policy/ est� pensada para ayudar a depurar
asuntos relacionado con el archivo de preferencias. Sin
argumentos mostrar� la prioridad de cada fuente. De lo
contrario muestra una informaci�n detallada acerca de la
prioridad de selecci�n de cada nombre de paquete.
</VarListEntry>
<VarListEntry><Term>madison <replaceable/[ paquete(s) ]/</Term>
<ListItem><Para>
La orden <literal/madison/ de <literal/apt-cache/ intenta imitar el formato
de salida y parte de la funcionalidad de la herramienta para el manejo del
archivo de Debian, <literal/madison/. Muestra las versiones disponibles de
un determinado paquete en un formato tabular. A diferencia del
<literal/madison/ original, s�lo puede mostrar informaci�n para la
arquitectura para la que APT obtuvo las listas de paquetes
(<literal/APT::Architecture/).
</VarListEntry>
</VariableList>
</RefSect1>
<RefSect1><Title>Opciones</>
&apt-cmdblurb;
<VariableList>
<VarListEntry><term><option/-p/</><term><option/--pkg-cache/</>
<ListItem><Para>
Selecciona el fichero para guardar la cach� de paquetes. La cach� de
paquetes es la cach� primaria usada para todas las operaciones.
Opci�n de configuraci�n: <literal/Dir::Cache::pkgcache/.
</VarListEntry>
<VarListEntry><term><option/-s/</><term><option/--src-cache/</>
<ListItem><Para>
Selecciona el fichero para guardar la cach� de fuente. S�lo
<literal/gencaches/ usa esta cach� y guarda una versi�n meticulosamente
analizada de la informaci�n de cada paquete de las fuentes
remotas. Cuando se construye la cach� de paquetes la cach�
fuente se usa para evitar analizar todos los ficheros de paquetes.
Opci�n de configuraci�n: <literal/Dir::Cache::srcpkgcache/.
</VarListEntry>
<VarListEntry><term><option/-q/</><term><option/--quiet/</>
<ListItem><Para>
Silencioso, produce una salida adecuada para su almacenamiento, omitiendo los
indicadores de progreso. M�s q's producir�n una salida m�s silenciosa,
hasta un m�ximo de 2. Adem�s es posible usar <option/-q=#/ para
ajustar el nivel de silenciosidad, ignorando el fichero de
configuraci�n. Opci�n de configuraci�n: <literal/quiet/.
</VarListEntry>
<VarListEntry><term><option/-i/</><term><option/--important/</>
<ListItem><Para>
Muestra s�lo las dependencias importantes, se usa junto con
<literal/unmet/. Hace que s�lo se muestren las dependencias y predependencias.
Opci�n de configuraci�n: <literal/APT::Cache::Important/.
</VarListEntry>
<VarListEntry><term><option/-f/</><term><option/--full/</>
<ListItem><Para>
Muestra todos los campos de informaci�n cuando se busque. Opci�n de
configuraci�n: <literal/APT::Cache::ShowFull/.
</VarListEntry>
<VarListEntry><term><option/-a/</><term><option/--all-versions/</>
<ListItem><Para>
Muestra la descripci�n completa de todos las versiones disponibles. Es el
comportamiento predeterminado, para desactivarlo use
<option/--no-all-versions/. Si se especifica <option/--no-all-versions/,
s�lo se muestra la versi�n candidata (la que se seleccionar�a para
instalar). Esta opci�n s�lo es aplicable a la orden <literal/show/. Opci�n
de configuraci�n: <literal/APT::Cache::AllVersions/.
</VarListEntry>
<VarListEntry><term><option/-g/</><term><option/--generate/</>
<ListItem><Para>
Realiza una regeneraci�n completa de la cach� de paquetes en vez de
usarla tal y como est�. Esta es la opci�n por omisi�n, para
desactivarlo use <option/--no-generate/. Opci�n de
configuraci�n: <literal/APT::Cache::Generate/.
</VarListEntry>
<VarListEntry><term><option/--names-only/</><term><option/-n/</>
<ListItem><Para>
S�lo busca en los nombres de paquetes, no en las descripciones largas.
Opci�n de configuraci�n: <literal/APT::Cache::NamesOnly/.
</VarListEntry>
<VarListEntry><term><option/--all-names/</>
<ListItem><Para>
Hace que <literal/pkgnames/ muestre todos los nombres,
incluyendo los paquetes virtuales y las dependencias insatisfechas.
Opci�n de configuraci�n: <literal/APT::Cache::AllNames/.
</VarListEntry>
<VarListEntry><term><option/--recurse/</>
<ListItem><Para>
Hace <literal/depends/ y <literal/rdepends/ recursivos de modo que todos
los paquetes mencionados se muestran s�lo una vez. Opci�n de configuraci�n
<literal/APT::Cache::RecurseDepends/.
</VarListEntry>
<VarListEntry><term><option/--installed/</>
<ListItem><Para>
Limita la salida de <literal/depends/ y <literal/rdepends/ a paquetes
instalados. Opci�n de configuraci�n: <literal/APT::Cache::Installed/.
</VarListEntry>
&apt-commonoptions;
</VariableList>
</RefSect1>
<RefSect1><Title>Ficheros</>
<variablelist>
<VarListEntry><term><filename>/etc/apt/sources.list</></term>
<ListItem><Para>
Fichero que contiene los sitios de donde se obtienen los paquetes.
Opci�n de configuraci�n: <literal/Dir::Etc::SourceList/.
</VarListEntry>
<VarListEntry><term><filename>&statedir;/lists/</></term>
<ListItem><Para>
Directorio donde se almacena la informaci�n del estado de cada paquete
fuente por cada sitio especificado &sources-list;
Opci�n de configuraci�n: <literal/Dir::State::Lists/.
</VarListEntry>
<VarListEntry><term><filename>&statedir;/lists/partial/</></term>
<ListItem><Para>
Directorio de almacenamiento para la informaci�n de estado en
tr�nsito. Opci�n de Configuraci�n: <literal/Dir::State::Lists/
(lo que implica que no estar�n completos).
</VarListEntry>
</variablelist>
</RefSect1>
<RefSect1><Title>Vea adem�s</>
<para>
&apt-conf;, &sources-list;, &apt-get;
</RefSect1>
<RefSect1><Title>Diagn�sticos</>
<para>
<command/apt-cache/ devuelve cero en operaciones satisfactorias, 100 en caso
de error.
</RefSect1>
&manbugs;
&manauthor;
<RefSect1><Title>Traduci�n</>
<para>
P�gina del manual traducida por Rub�n Porras <email>nahoo@inicia.es</>,
revisada por Gustavo Saldumbide <email>gsal@adinet.com.uy</>.
</RefSect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
-->
|