1
.\" This manpage has been automatically generated by docbook2man
2
.\" from a DocBook document. This tool can be found at:
3
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
4
.\" Please send any bug reports, improvements, comments, patches,
5
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
.TH "APT-CACHE" "8" "26 March 2005" "" ""
9
apt-cache \- utilidad de manejo de paquetes APT -- manipulador de cach�
12
\fBapt-cache\fR [ \fB-hvsn\fR ] [ \fB-o=\fIcadena de configuraci�n\fB\fR ] [ \fB-c=\fIfichero\fB\fR ] { \fBadd \fIfichero\fB\fI ...\fB\fR | \fBgencaches\fR | \fBshowpkg \fIpaquete\fB\fI ...\fB\fR | \fBshowsrc \fIpaquete\fB\fI ...\fB\fR | \fBstats\fR | \fBdump\fR | \fBdumpavail\fR | \fBunmet\fR | \fBsearch \fIexpresi�n regular\fB\fR | \fBshow \fIpaquete\fB\fI ...\fB\fR | \fBdepends \fIpaquete\fB\fI ...\fB\fR | \fBrdepends \fIpkg\fB\fI ...\fB\fR | \fBpkgnames \fIprefijo\fB\fR | \fBdotty \fIpaquete\fB\fI ...\fB\fR | \fBpolicy \fIpaquetes\fB\fI ...\fB\fR | \fBmadison \fIpaquetes\fB\fI ...\fB\fR }
16
\fBapt-cache\fR realiza una serie de operaciones sobre la cach� de
17
paquetes de APT. \fBapt-cache\fR no modifica el estado del sistema
18
pero proporciona operaciones de b�squeda en la informaci�n de los
19
paquetes, de las cuales se puede obtener informaci�n muy �til.
21
A menos que se proporcionen las opciones \fB-h\fR, o \fB--help\fR, se
22
debe de proporcionar una de las siguientes �rdenes:
24
\fBadd \fIfichero(s)\fB\fR
25
add a�ade el nombre del paquete a los ficheros de
26
�ndices de la cach� de paquetes. S�lo para depuraci�n.
29
gencaches realiza la misma operaci�n que
30
\fBapt-get check\fR\&. Construye las cach�s de paquetes fuente y de
31
paquetes binarios, usando la lista de recursos en \fB\fIsources.list\fB\fR(5)
32
junto con la informaci�n en \fI/var/lib/dpkg/status\fR\&.
34
\fBshowpkg \fIpaquete(s)\fB\fR
35
showpkg muestra informaci�n acerca de los paquetes
36
listados en la l�nea de �rdenes. Los argumentos restantes se
37
consideran nombres de paquetes. Por cada paquete se mostrar�n las
38
versiones disponibles y los paquetes que dependen de �l (reverse
39
dependencies), as� como los paquetes de que depende (forward dependencies),
40
(los cuales deben de ser instalados para instalar el paquete).
41
Por ejemplo, \fBapt-cache showpkg libreadline2\fR mostrar� algo
42
similar a lo siguiente:
47
Versions: 2.1-12(/var/state/apt/lists/foo_Packages),
49
libreadlineg2,libreadline2
50
libreadline2-altdev,libreadline2
52
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
58
Esta informaci�n nos indica que la versi�n 2.1-12 de libreadline2,
59
depende de libc5 y ncurses3.0, ambos programas deben instalarse para
60
que libreadline2 pueda funcionar. Adem�s, libreadlineg2 y
61
libreadline2-altdev dependen de libreadline2. Es decir, si se instala
62
libreadline2, tambi�n se instalar�n libc5 y ncurses3.0 (y ldso), pero
63
libreadlineg2 y libreadline2-altdev no tienen que instalarse.
64
Para una informaci�n m�s especifica acerca del significado de la salida
65
consulte el c�digo fuente de apt.
68
stats muestra algunas estad�sticas acerca de la cach�.
69
No necesita ning�n argumento adicional. Las estad�sticas que
74
Total package names es el n�mero de paquetes encontrados
78
Normal packages es el n�mero de paquetes normales. Estos
79
paquetes tienen una correspondencia un�voca entre sus nombres y
80
los nombres que usan otros paquetes al listarlos en sus
81
dependencias. La mayor�a de los paquetes pertenecen a este grupo.
84
Pure virtual packages es el n�mero de paquetes que
85
existen s�lo como nombre de paquete virtual, esto es, paquetes
86
que s�lo "proporcionan" el nombre del paquete virtual, y no hay
87
ning�n paquete m�s que use realmente el nombre. Por ejemplo,
88
"mail-transport-agent" en un sistema Debian GNU/Linux es un
89
paquete virtual puro, varios paquetes proporcionan
90
"mail-transport-agent", pero no hay ning�n paquete que se llame
91
"mail-transport-agent".
94
Single virtual packages es el n�mero de paquetes que
95
s�lo tiene un paquete real que los proporcione. Por ejemplo, en
96
un sistema Debian GNU/Linux, "X11-text-viewer" es un paquete
97
virtual, pero s�lo un paquete, xless, proporciona "X11-text-viewer".
100
Mixed virtual packages es el n�mero de paquetes que o
101
bien proporcionan un determinado paquete virtual o tienen el
102
mismo nombre como paquete virtual y como paquete real, en un
103
sistema Debian GNU/Linux, "debconf" es a la vez un paquete real,
104
y es proporcionado por el paquete debconf-tiny.
107
Missing es el n�mero de nombres de paquetes a los que se hace
108
referencia como dependencia pero que no son proporcionado por ning�n
109
paquete. Estos paquetes probablemente signifiquen que no se tiene
110
acceso al total de la distribuci�n, o bien que alg�n paquete (real o
111
virtual) ha sido eliminado de la distribuci�n. Normalmente se hace
112
referencia a ellos desde los campos de conflictos de la descripci�n
116
Total distinct versions es el n�mero de versiones de paquetes
117
encontrados en la cach�, por lo tanto el n�mero es al menos igual al
118
n�mero total de paquetes. Si m�s de una distribuci�n ("estable"
119
e "inestable", por ejemplo), se encuentra en la cach� al mismo
120
tiempo, este valor puede ser considerablemente mayor que el
121
n�mero total de paquetes.
124
Total dependencies es el n�mero total de relaciones de
125
dependencia necesitadas por todos los paquetes de la cach�.
128
\fBshowsrc \fIpaquete(s)\fB\fR
129
showsrc muestra todos los campos de los paquetes fuente que
130
coinciden con los nombres de los paquetes suministrados. Se muestran
131
todas las versiones, as� como los paquetes que son binarios.
134
dump muestra una peque�a lista de todos los paquetes en la
135
cach�. Fundamentalmente para depuraci�n.
138
dumpavail env�a a la salida est�ndar una lista de los paquetes
139
disponibles. Esta lista es apropiada para su uso con \fBdpkg\fR(8) y es
140
usada por el m�todo \fBdselect\fR(8)\&.
143
unmet muestra un resumen de todas las dependencias no
144
satisfechas en la cach� de paquetes.
146
\fBshow \fIpaquete(s)\fB\fR
147
show realiza una funci�n similar a \fBdpkg
148
--print-avail\fR, muestra los datos de los paquetes listados.
150
\fBsearch \fIregex [regex ...]\fB\fR
151
search realiza una b�squeda de la expresi�n regular
152
dada en todo el texto de todos los paquetes disponibles. Busca la
153
expresi�n regular tanto en el nombre de los paquetes como en
154
su descripci�n y muestra el nombre del paquete y una peque�a
155
descripci�n de este. Si se proporciona el argumento \fB--full\fR el
156
resultado es el igual al que produce show para cada paquete en
157
concreto, pero si se proporciona el argumento \fB--names-only\fR
158
entonces s�lo se busca en el nombre de los paquetes.
160
Se pueden especificar argumentos separados para buscar una cadena de
161
caracteres que los contenga todos al mismo tiempo.
163
\fBdepends \fIpaquete(s)\fB\fR
164
depends muestra una lista de todas la dependencias de
165
un paquete y de todos los paquetes que la pueden satisfacer.
167
\fBrdepends \fIpaquetes(s)\fB\fR
168
rdepends muestrade las dependencias inversas de un paquete.
170
\fBpkgnames \fI[ prefijo ]\fB\fR
171
Esta orden muestra el nombre de todos los paquetes instalados en
172
el sistema. El argumento opcional es un prefijo por el cual se
173
filtrar�a la lista de nombres. La salida es apropiada para uso
174
junto con la funci�n de auto-completado mediante tabulador en un
175
int�rprete de �rdenes y se genera de forma extremadamente
176
r�pida. Su mejor uso es con la opci�n \fB--generate\fR\&.
178
\fBdotty \fIpaquete(s)\fB\fR
179
dotty toma una lista de paquetes de la l�nea de ordenes
180
y genera una salida apropiada para dotty, del paquete
181
GraphViz <URL:http://www.research.att.com/sw/tools/graphviz/>\&.
182
El resultado ser� una serie de nodos y uniones representando las
183
relaciones entre paquetes. Por omisi�n los paquetes dados
184
mostrar�n todas sus dependencias, lo que puede producir una
185
salida muy grande. Esto puede ser deshabilitado activando la
186
opci�n APT::Cache::GivenOnly\&.
188
Los nodos resultantes tendr�n varias formas, los paquetes normales son
189
cajas, pure provides son tri�ngulos, mixed provides son
190
diamantes, los paquetes no encontrados son hex�gonos. Las cajas naranjas
191
significan recursion was stopped [leaf packages], l�neas azules
192
son predependencias, l�neas verdes son conflictos.
194
Tenga cuidado, dotty no puede dibujar una gran cantidad de paquetes.
196
\fBpolicy \fI[ paquete(s) ]\fB\fR
197
policy est� pensada para ayudar a depurar
198
asuntos relacionado con el archivo de preferencias. Sin
199
argumentos mostrar� la prioridad de cada fuente. De lo
200
contrario muestra una informaci�n detallada acerca de la
201
prioridad de selecci�n de cada nombre de paquete.
203
\fBmadison \fI[ paquete(s) ]\fB\fR
204
La orden madison de apt-cache intenta imitar el formato
205
de salida y parte de la funcionalidad de la herramienta para el manejo del
206
archivo de Debian, madison\&. Muestra las versiones disponibles de
207
un determinado paquete en un formato tabular. A diferencia del
208
madison original, s�lo puede mostrar informaci�n para la
209
arquitectura para la que APT obtuvo las listas de paquetes
213
Todas las opciones de l�nea de �rdenes pueden ser especificadas
214
mediante el fichero de configuraci�n, en la descripci�n de cada opci�n
215
se indica la opci�n de configuraci�n que hay que modificar. Para
216
opciones booleanas puedes modificar el fichero de configuraci�n usando
217
cosas parecidas a \fB-f-\fR,\fB--no-f\fR, \fB-f=no\fR y alguna que
223
Selecciona el fichero para guardar la cach� de paquetes. La cach� de
224
paquetes es la cach� primaria usada para todas las operaciones.
225
Opci�n de configuraci�n: Dir::Cache::pkgcache\&.
230
Selecciona el fichero para guardar la cach� de fuente. S�lo
231
gencaches usa esta cach� y guarda una versi�n meticulosamente
232
analizada de la informaci�n de cada paquete de las fuentes
233
remotas. Cuando se construye la cach� de paquetes la cach�
234
fuente se usa para evitar analizar todos los ficheros de paquetes.
235
Opci�n de configuraci�n: Dir::Cache::srcpkgcache\&.
240
Silencioso, produce una salida adecuada para su almacenamiento, omitiendo los
241
indicadores de progreso. M�s q's producir�n una salida m�s silenciosa,
242
hasta un m�ximo de 2. Adem�s es posible usar \fB-q=#\fR para
243
ajustar el nivel de silenciosidad, ignorando el fichero de
244
configuraci�n. Opci�n de configuraci�n: quiet\&.
249
Muestra s�lo las dependencias importantes, se usa junto con
250
unmet\&. Hace que s�lo se muestren las dependencias y predependencias.
251
Opci�n de configuraci�n: APT::Cache::Important\&.
256
Muestra todos los campos de informaci�n cuando se busque. Opci�n de
257
configuraci�n: APT::Cache::ShowFull\&.
262
Muestra la descripci�n completa de todos las versiones disponibles. Es el
263
comportamiento predeterminado, para desactivarlo use
264
\fB--no-all-versions\fR\&. Si se especifica \fB--no-all-versions\fR,
265
s�lo se muestra la versi�n candidata (la que se seleccionar�a para
266
instalar). Esta opci�n s�lo es aplicable a la orden show\&. Opci�n
267
de configuraci�n: APT::Cache::AllVersions\&.
272
Realiza una regeneraci�n completa de la cach� de paquetes en vez de
273
usarla tal y como est�. Esta es la opci�n por omisi�n, para
274
desactivarlo use \fB--no-generate\fR\&. Opci�n de
275
configuraci�n: APT::Cache::Generate\&.
280
S�lo busca en los nombres de paquetes, no en las descripciones largas.
281
Opci�n de configuraci�n: APT::Cache::NamesOnly\&.
284
Hace que pkgnames muestre todos los nombres,
285
incluyendo los paquetes virtuales y las dependencias insatisfechas.
286
Opci�n de configuraci�n: APT::Cache::AllNames\&.
289
Hace depends y rdepends recursivos de modo que todos
290
los paquetes mencionados se muestran s�lo una vez. Opci�n de configuraci�n
291
APT::Cache::RecurseDepends\&.
294
Limita la salida de depends y rdepends a paquetes
295
instalados. Opci�n de configuraci�n: APT::Cache::Installed\&.
300
Muestra un breve resumen del modo de uso.
305
Muestra la versi�n del programa.
310
Especifica el fichero de configuraci�n a usar.
311
El programa leer� el fichero de configuraci�n por omisi�n y luego
312
este otro. Lea \fB\fIapt.conf\fB\fR(5) para m�s informaci�n acerca de la sintaxis.
317
Establece una opci�n de configuraci�n. La sintaxis es \fB-o
321
\fB\fI/etc/apt/sources.list\fB\fR
322
Fichero que contiene los sitios de donde se obtienen los paquetes.
323
Opci�n de configuraci�n: Dir::Etc::SourceList\&.
325
\fB\fI/var/lib/apt/lists/\fB\fR
326
Directorio donde se almacena la informaci�n del estado de cada paquete
327
fuente por cada sitio especificado \fB\fIsources.list\fB\fR(5)
328
Opci�n de configuraci�n: Dir::State::Lists\&.
330
\fB\fI/var/lib/apt/lists/partial/\fB\fR
331
Directorio de almacenamiento para la informaci�n de estado en
332
tr�nsito. Opci�n de Configuraci�n: Dir::State::Lists
333
(lo que implica que no estar�n completos).
336
\fB\fIapt.conf\fB\fR(5), \fB\fIsources.list\fB\fR(5), \fBapt-get\fR(8)
339
\fBapt-cache\fR devuelve cero en operaciones satisfactorias, 100 en caso
343
Vea la p�gina de fallos de APT <URL:http://bugs.debian.org/src:apt>\&.
344
Si desea avisar de un fallo en APT, vea
345
\fI/usr/share/doc/debian/bug-reporting.txt\fR o la orden \fBreportbug\fR(1)\&.
348
APT fue escrito por el equipo de APT <apt@packages.debian.org>\&.
351
P�gina del manual traducida por Rub�n Porras <nahoo@inicia.es>,
352
revisada por Gustavo Saldumbide <gsal@adinet.com.uy>\&.