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