Provided by:
apt_0.8.16~exp5ubuntu13_i386 
NAME
apt-cache - query the APT cache
SYNOPSIS
apt-cache [-hvsn] [-o=config string] [-c=file] {[gencaches] |
[showpkg pkg...] | [showsrc pkg...] | [stats] | [dump] |
[dumpavail] | [unmet] | [search regex] | [show pkg...] |
[depends pkg...] | [rdepends pkg...] | [pkgnames prefix] |
[dotty pkg...] | [xvcg pkg...] | [policy pkgs...] |
[madison pkgs...]}
DESCRIPCI'oN
apt-cache realiza una serie de operaciones sobre la cache (registro o
lista) de paquetes de APT. apt-cache no modifica el estado del sistema
pero proporciona operaciones de busqueda y genera informacion
interesante a partir de los metadatos del paquete.
A menos que se use la opcion -h o --help, una de las siguientes ordenes
debe estar presente.
gencaches
gencaches realiza la misma operacion que apt-get check. Genera las
caches de los paquetes fuente y de los paquetes binarios a partir
de la lista de fuentes en sources.list(5) y a partir de
/var/lib/dpkg/status.
showpkg paquete(s)
showpkg muestra la informacion relativa a los paquetes listados en
la linea de ordenes. Los argumentos restantes se consideran nombres
de paquetes. Para cada paquete de la lista se listan las versiones
y dependencias inversas disponibles, asi como las dependencias de
cada version. Las dependencias (normales) son los paquetes de los
que depende el paquete en cuestion, las dependencias inversas son
los paquetes que dependen del paquete en cuestion. Por ello, las
dependencias se deben satisfacer para un paquete, pero las
dependencias inversas no. Por ejemplo, apt-cache showpkg
libreadline2 produciria una salida similar a la siguiente:
Paquete: libreadline2
Versiones: 2.1-12(/var/state/apt/lists/foo_Packages),
Dependencias inversas:
libreadlineg2,libreadline2
libreadline2-altdev,libreadline2
Dependencias:
2.1-12 - libc5 (2 5.4.0-0) ncurses3.0 (0 (null))
Provides:
2.1-12 -
Reverse Provides:
La informacion de salida muestra que libreadline2, con version
2.1-12, depende de libc5 y ncurses3.0, que se deben instalar para
que libreadline2 funcione. Ademas, libreadlineg2 y
libreadline2-altdev dependen de libreadline2. De modo que si
libreadline2 esta instalado, libc5 y ncurses3.0 (y ldso) tambien
deben estar instalados, pero libreadlineg2 y libreadline2-altdev no
tienen que estarlo. Para el significado especifico del resto de la
salida lo mejor es consultar el codigo fuente de apt.
stats
stats muestra algunas estadisticas sobre la cache. No necesita
ningun argumento adicional. Las estadisticas que muestra son:
o Total de nombres de paquetes es el numero de paquetes
encontrados en la cache.
o Paquetes normales es el numero de nombres de paquetes normales.
Estos paquetes tienen una correspondencia univoca entre sus
nombres y los nombres que usan otros paquetes al listarlos en
sus dependencias. La mayoria de los paquetes pertenecen a este
grupo.
o Paquetes virtuales puros es el numero de paquetes que existen
solo como nombre de un paquete virtual, esto es, paquetes que
solo <<proporcionan>> el nombre del paquete virtual, y no hay
ningun paquete mas que use 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 ningun paquete que se
llame <<mail-transport-agent>>.
o Paquetes virtuales unicos es el numero de paquetes con un unico
paquete que proporciona un paquete virtual en concreto. Por
ejemplo, en un sistema Debian GNU/Linux, <<X11-text-viewer>> es
un paquete virtual, pero solo un paquete, xless, proporciona
<<X11-text-viewer>>.
o Paquetes virtuales mixtos es el numero de paquetes que o bien
proporcionan un determinado paquete virtual o tienen el mismo
nombre como paquete virtual y como paquete normal. Por ejemplo,
en un sistema Debian GNU/Linux debconf es a la vez un paquete
normal, y lo proporciona el paquete debconf-tiny.
o No encontrados es el numero de nombres de paquetes mencionados
como dependencia pero que ningun paquete los proporciona. Estos
paquetes pueden ser una prueba de que no se tiene acceso a toda
la distribucion, o de la eliminacion de algun paquete (real o
virtual) dentro de la distribucion. Normalmente se hace
referencia a ellos desde los campos <<Conflicts>> o <<Breaks>>
de la descripcion de los paquetes.
o Total de versiones distintas es el numero de versiones de
paquetes encontradas en la cache, por lo tanto el numero es al
menos igual al numero total de paquetes. Si se encuentra en la
cache mas de una distribucion (<<estable>> e <<inestable>>, por
ejemplo) al mismo tiempo, este valor puede ser
considerablemente mayor que el numero total de paquetes.
o Total de dependencias es el numero total de relaciones de
dependencia de todos los paquetes de la cache.
showsrc paquete(s)
showsrc muestra todos los campos de los paquetes fuente que
coinciden con los nombres de los paquetes proporcionados. Se
muestran todas las versiones, asi como todos los campos cuyo nombre
manifiesta que son binarios.
dump
dump muestra una pequena lista de todos los paquetes en la cache.
Fundamentalmente para depuracion.
dumpavail
dumpavail muestra por la salida estandar una lista de los paquetes
disponibles. Esta lista es apropiada para su uso con dpkg(1) y,
ademas, la usa el metodo dselect(1).
unmet
unmet muestra un resumen de todas las dependencias no satisfechas
en la cache de paquetes.
show paquete(s)
show realiza una funcion similar a dpkg --print-avail, muestra los
campos del paquete para los paquetes nombrados.
search exp-regular [exp-regular ...]
search realiza una busqueda de la expresion regular POSIX
proporcionada en todo el texto de todos los paquetes disponibles,
vease regex(7). Busca la expresion regular tanto en el nombre de
los paquetes como en su descripcion y muestra el nombre del paquete
y una pequena descripcion de este, incluyendo nombres de paquetes
virtuales. Si se proporciona el argumento --full el resultado es
igual al que produce show para cada paquete, pero si se proporciona
el argumento --names-only entonces solo se busca en el nombre de
los paquetes, no en la descripcion larga.
Se pueden usar argumentos separados para especificar varios
patrones de busqueda que se juntaran mediante una <<Y logica>>.
depends paquete(s)
depends muestra una lista de todas la dependencias de un paquete y
de todos los demas paquetes que la pueden satisfacer.
rdepends paquete(s)
rdepends muestra las dependencias inversas de un paquete.
pkgnames [ prefijo ]
Esta orden muestra el nombre de todos los paquetes que APT conoce.
El argumento opcional es un prefijo para filtrar la lista de
nombres. La salida es apropiada para su uso junto con la funcion de
completado automatico mediante tabulador en un interprete de
ordenes y se genera de forma extremadamente rapida. El mejor uso de
la orden es con la opcion --generate.
Tenga en cuenta que un paquete que conoce APT puede no estar
necesariamente disponible para descargar, instalar o instalado, por
ejemplo: los paquetes virtuales tambien aparecen en la lista
generada.
dotty paquete(s)
dotty toma una lista de paquetes de la linea de ordenes y genera
una salida apropiada para su uso con dotty, del paquete
GraphViz[1]. El resultado sera un conjunto de nodos y uniones
representando las relaciones entre los paquetes. De forma
predeterminada, los paquetes proporcionados mostraran todas sus
dependencias, lo que puede producir un grafo muy grande. Para
limitar la salida solo a los paquetes listados en la linea de
ordenes, active la opcion APT::Cache::GivenOnly.
Los nodos resultantes tendran varias formas: los paquetes normales
son cajas, los paquetes virtuales puros son triangulos, los
paquetes virtuales mixtos son diamantes y los paquetes no
encontrados son hexagonos. Las cajas naranjas simbolizan que el
recorrido se detuvo en paquetes que ningun otro declara como
dependencia, las lineas azules son pre-dependencias y las lineas
verdes son conflictos.
Tenga cuidado, dotty no puede dibujar grandes conjuntos de
paquetes.
xvcg paquete(s)
Lo mismo que dotty, solo para xvcg de la herramienta VCG[2].
policy [ paquete(s) ]
policy esta pensado para ayudar a depurar asuntos relacionados con
el fichero de preferencias. Sin argumentos mostrara las prioridades
de cada fuente. De forma alternativa, muestra una informacion
detallada acerca de la prioridad de seleccion del paquete nombrado.
madison [ paquete(s) ]
La orden madison de apt-cache intenta imitar el formato de salida y
parte de la funcionalidad de la herramienta para la gestion del
archivo de Debian, madison. Muestra las versiones disponibles de un
determinado paquete en un formato tabular. A diferencia del madison
original, solo puede mostrar informacion para la arquitectura para
la que APT obtuvo las listas de paquetes (APT::Architecture).
OPCIONES
Todas las opciones de la linea de ordenes se pueden definir mediante el
fichero de configuracion, las descripciones indican la opcion de la
configuracion a definir. Para opciones de tipo <<boolean>> puede
invalidar el fichero de configuracion utilizando algo como -f-,--no-f,
-f=no u otras muchas variaciones.
-p, --pkg-cache
Define el fichero donde guardar la cache de paquetes. La cache de
paquetes es la cache primaria usada para todas las operaciones.
Opcion de configuracion: Dir::Cache::pkgcache.
-s, --src-cache
Escoge el fichero para guardar la cache fuente. Solo gencaches usa
esta cache y guarda una version analizada de la informacion de los
paquetes de las fuentes remotas. Cuando se genera la cache de
paquetes la cache fuente se usa para evitar analizar todos los
ficheros de paquetes. Opcion de configuracion:
Dir::Cache::srcpkgcache.
-q, --quiet
Produce una salida adecuada para su almacenamiento, omitiendo los
indicadores de progreso. Mas <<q>> produciran una salida mas
silenciosa, hasta un maximo de dos. Tambien se puede usar -q=# para
definir el nivel de silencio, ignorando el fichero de
configuracion. Opcion de configuracion: quiet.
-i, --important
Muestra solo las dependencias importantes, se usa junto con unmet y
depends. Hace que solo se muestren las dependencias y
pre-dependencias. Opcion de configuracion: APT::Cache::Important.
--no-pre-depends, --no-depends, --no-recommends, --no-suggests,
--no-conflicts, --no-breaks, --no-replaces, --no-enhances
Per default the depends and rdepends print all dependencies. This
can be tweaked with these flags which will omit the specified
dependency type. Configuration Item: APT::Cache::ShowDependencyType
e.g. APT::Cache::ShowRecommends.
-f, --full
Muestra todos los campos de informacion cuando se realiza una
busqueda. Opcion de configuracion: APT::Cache::ShowFull.
-a, --all-versions
Muestra los campos completos de todas las versiones disponibles. Es
el comportamiento predeterminado, para desactivarlo use
--no-all-versions. Si se especifica --no-all-versions, solo se
muestra la version candidata (la que se escogeria para instalar).
Esta opcion solo se aplica a la orden show. Opcion de
configuracion: APT::Cache::AllVersions.
-g, --generate
Realiza una regeneracion completa de la cache de paquetes, en vez
de usarla tal y como esta. Esta es la opcion predeterminada, para
desactivarla use --no-generate. Opcion de configuracion:
APT::Cache::Generate.
--names-only, -n
Solo busca en los nombres de paquetes, no en las descripciones
largas. Opcion de configuracion: APT::Cache::NamesOnly.
--all-names
Hace que pkgnames muestre todos los nombres, incluyendo los
paquetes virtuales y las dependencias no encontradas. Opcion de
configuracion: APT::Cache::AllNames.
--recurse
Hace que depends y rdepends sean recursivos de modo que todos los
paquetes mencionados se muestran solo una vez. Opcion de
configuracion APT::Cache::RecurseDepends.
--installed
Limita la salida de depends y rdepends a paquetes actualmente
instalados. Opcion de configuracion: APT::Cache::Installed.
-h, --help
Muestra un mensaje corto sobre el uso.
-v, --version
Muestra la version del programa.
-c, --config-file
Fichero de configuracion: Especifica el fichero de configuracion a
usar. El programa leera el fichero de configuracion predeterminado
y, despues, este fichero de configuracion. Si necesita que ciertas
opciones de configuracion se definan antes que el analisis de los
de los ficheros de configuracion predeterminados, defina un fichero
con la variable de entorno APT_CONFIG. Consulte apt.conf(5) para
informacion sobre la sintaxis.
-o, --option
Define una opcion de configuracion: Esto definira una opcion
arbitraria de configuracion. La sintaxis es -o Algo::Cosa=cosa. -o
y --option se pueden usar varias veces para definir diferentes
opciones.
FICHEROS
/etc/apt/sources.list
Ubicaciones de donde conseguir los paquetes. Opcion de
configuracion: Dir::Etc::SourceList.
/etc/apt/sources.list.d/
Fragmentos de fichero para las ubicaciones de donde descargar los
paquetes. Opcion de configuracion: Dir::Etc::SourceParts.
/var/lib/apt/lists/
Area de almacenamiento para la informacion del estado de cada
fuente de paquetes especificado en sources.list(5) Opcion de
configuracion: Dir::State::Lists.
/var/lib/apt/lists/partial/
Area de almacenamiento para la informacion del estado en transito.
Opcion de configuracion: Dir::State::Lists (parcialmente
implicito).
V'eASE TAMBI'eN
apt.conf(5), sources.list(5), apt-get(8)
DIAGN'oSTICOS
apt-cache devuelve cero si no hay ningun error, y el valor 100 en caso
de error.
BUGS
P'agina de errores de APT[3]. Si quiere informar de un error en APT,
consulte /usr/share/doc/debian/bug-reporting.txt o use la orden
reportbug(1).
TRADUCCI'ON
La traduccion al espanol la realizaron Ismael Fanlo, Carlos Mestre,
Rudy Godoy, Gustavo Saldumbide, Javier Fernandez-Sanguino y Ruben
Porras Campo entre los anos 2003 y 2004. La traduccion fue actualizada
por Francisco Javier Cuadrado y Omar Campagne Polaino entre los anos
2009 y 2010.
Tenga en cuenta que este documento puede contener secciones sin
traducir. Esto es intencionado para evitar perder contenido cuando la
traduccion no esta actualizada con respecto al documento original.
AUTHORS
Jason Gunthorpe
Equipo de APT
NOTES
1. GraphViz
http://www.research.att.com/sw/tools/graphviz/
2. herramienta VCG
http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html
3. Pagina de errores de APT
http://bugs.debian.org/src:apt