<!-- -*- 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: -->