APT-CACHE(8) APT APT-CACHE(8) NOMBRE apt-cache - Realiza consultas al cache de APT SINOPSIS apt-cache [-agipns] [-o=config_string] [-c=config_file] {gencaches | showpkg pkg... | showsrc pkg... | stats | dump | dumpavail | unmet | search regex... | show pkg [{=pkg_version_number | /target_release}]... | depends pkg [{=pkg_version_number | /target_release}]... | rdepends pkg [{=pkg_version_number | /target_release}]... | pkgnames [prefix] | dotty pkg [{=pkg_version_number | /target_release}]... | xvcg pkg [{=pkg_version_number | /target_release}]... | policy [pkg...] | madison pkg... | {-v | --version} | {-h | --help}} DESCRIPCION apt-cache performs a variety of operations on APT's package cache. apt-cache does not manipulate the state of the system but does provide operations to search and generate interesting output from the package metadata. The metadata is acquired and updated via the 'update' command of e.g. apt-get, so that it can be outdated if the last update is too long ago, but in exchange apt-cache works independently of the availability of the configured sources (e.g. offline). A menos que se use la opcion -h o --help, una de las siguientes ordenes debe estar presente. gencaches gencaches genera la cache de paquetes de APT. Todas las ordenes realizan esta accion de forma implicita si no se detecta la cache o si esta obsoleta. showpkg pkg... 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 <> el nombre del paquete virtual, y no hay ningun paquete mas que use el nombre. Por ejemplo, <> en un sistema Debian es un paquete virtual puro, varios paquetes proporcionan <>, pero no hay ningun paquete que se llame <>. 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, <> es un paquete virtual, pero solo un paquete, xless, proporciona <>. 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, <> es a la vez un paquete normal, y que 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 <> o <> de la descripcion de los paquetes. o Total distinct versions is the number of package versions found in the cache. If more than one distribution is being accessed (for instance, "stable" and "unstable"), this value can be considerably larger than the number of total package names. o Total de dependencias es el numero total de relaciones de dependencia de todos los paquetes de la cache. showsrc pkg... showsrc displays all the source package records that match the given package names. All versions are shown, as well as all records that declare the name to be a binary package. Use --only-source to display only source package names. 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 pkg... show realiza una funcion similar a dpkg --print-avail, muestra los campos del paquete para los paquetes nombrados. search regex... search performs a full text search on all available package lists for the POSIX regex pattern given, see regex(7). It searches the package names and the descriptions for an occurrence of the regular expression and prints out the package name and the short description, including virtual package names. If --full is given then output identical to show is produced for each matched package, and if --names-only is given then the long description is not searched, only the package name and provided packages are. Se pueden usar argumentos separados para especificar varios patrones de busqueda que se juntaran mediante una <>. depends pkg... depends muestra una lista de todas la dependencias de un paquete y de todos los demas paquetes que la pueden satisfacer. rdepends pkg... rdepends muestra las dependencias inversas de un paquete. pkgnames [prefix] 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 pkg... 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 pkg... Lo mismo que dotty, solo para xvcg de la herramienta VCG[2]. policy [pkg...] 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 pkg... 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 <> 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 <> 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. --implicit Per default depends and rdepends print only dependencies explicitly expressed in the metadata. With this flag it will also show dependencies implicitly added based on the encountered data. A Conflicts: foo e.g. expresses implicitly that this package also conflicts with the package foo from any other architecture. Configuration Item: APT::Cache::ShowImplicit. -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 utilice --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 Only search on the package and provided package names, not the long descriptions. Configuration Item: 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. --with-source filename Adds the given file as a source for metadata. Can be repeated to add multiple files. Supported are currently *.deb, *.dsc, *.changes, Sources and Packages files as well as source package directories. Files are matched based on their name only, not their content! Sources and Packages can be compressed in any format apt supports as long as they have the correct extension. If you need to store multiple of these files in one directory you can prefix a name of your choice with the last character being an underscore ("_"). Example: my.example_Packages.xz Note that these sources are treated as trusted (see apt-secure(8)). Configuration Item: APT::Sources::With. -h, --help Muestra un mensaje corto sobre el uso. -v, --version Muestra la version del programa. --audit Show audit (and notice) messages. This overrides the quiet option, but only for notice messages, not progress ones. -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 Set a Configuration Option; This will set an arbitrary configuration option. The syntax is -o Foo::Bar=bar. -o and --option can be used multiple times to set different options. --no-color, --color Turn colors on or off. Colors are on by default on supported terminals for apt(8) and can also be disabled using the NO_COLOR or APT_NO_COLOR environment variables, or further configured by the APT::Color configuration option and scope, see apt.conf(5) for information on that. 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 de estado en transito. Elemento de configuracion: Dir::State::Lists (se anade partial de forma implicita) VEASE TAMBIEN apt.conf(5), sources.list(5), apt-get(8), apt-patterns(7) DIAGNOSTICOS apt-cache devuelve cero si no hay ningun error, y el valor 100 en caso de error. BUGS Pagina 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). TRADUCCION 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 2012 . 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. AUTORES Jason Gunthorpe Equipo de APT NOTAS 1. GraphViz https://graphviz.org/ 2. herramienta VCG https://www.rw.cdl.uni- saarland.de/people/sander/private/html/gsvcg1.html 3. Pagina de errores de APT https://bugs.debian.org/src:apt APT 2.9.6 14 Marzo 2024 APT-CACHE(8)