Provided by: apt_0.8.16~exp5ubuntu13_i386 bug

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