<!-- -*- 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.7 del CVS de /cvs/debian-doc/manpages/english/apt/apt-get.8.sgml --> <refentry lang=es> &apt-docinfo; <refmeta> <refentrytitle>apt-get</> <manvolnum>8</> </refmeta> <!-- Man page title --> <refnamediv> <refname>apt-get</> <refpurpose>utilidad de manejo de paquetes APT -- interfaz en l�nea de ordenes.</> </refnamediv> <!-- Arguments --> <refsynopsisdiv> <cmdsynopsis> <command>apt-get</> <arg><option>-hvs</></arg> <arg><option>-o=<replaceable/cadena de configuraci�n/</></arg> <arg><option>-c=<replaceable/fichero/</></arg> <group choice=req> <arg>update</> <arg>upgrade</> <arg>dselect-upgrade</> <arg>install <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg> <arg>remove <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg> <arg>source <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg> <arg>build-dep <arg choice="plain" rep="repeat"><replaceable>paquete</replaceable></arg></arg> <arg>check</> <arg>clean</> <arg>autoclean</> </group> </cmdsynopsis> </refsynopsisdiv> <RefSect1><Title>Descripci�n</> <para> <command/apt-get/ es la herramienta en l�nea de �rdenes usada para el manejo de paquetes, tambi�n es la herramienta usada por otras que dependen de la biblioteca APT. Hay varias interfaces disponibles, como dselect(8), aptitude, synaptic, gnome-apt and wajig. <para> Se debe proporcionar una de las siguientes �rdenes a menos que se den las opciones <option/-h/, o <option/--help/. <VariableList> <VarListEntry><Term>update</Term> <ListItem><Para> <literal/update/ se usa para sincronizar el �ndice de paquetes respecto a sus fuentes. Los �ndices de paquetes disponibles se obtienen de los lugares especificados en <filename>/etc/apt/sources.list</>. Por ejemplo, cuando se usa un archivo de Debian, esta orden descarga y analiza los ficheros <filename>Packages.gz</>, de tal forma que la informaci�n acerca de nuevos paquetes pasa a estar disponible. Siempre se debe realizar un <literal/update/ antes de un <literal/upgrade/ o un <literal/dist-upgrade/. Se debe tener en cuenta que el indicador de progreso ser� incorrecto, ya que el tama�o de los pr�ximos ficheros con informaci�n sobre paquetes es desconocido hasta el momento de su descarga. </VarListEntry> <VarListEntry><Term>upgrade</Term> <ListItem><Para> <literal/upgrade/ se usa para instalar la versi�n m�s nueva de todos los paquetes instalados en el sistema provenientes de alguna de las fuentes listadas en <filename>/etc/apt/sources.list</>. Los paquetes instalados con una nueva versi�n disponible son descargados y actualizados, bajo ninguna circunstancia se desinstalar�n paquetes, o se instalar�n paquetes nuevos. Las nuevas versiones de programas instalados que no puedan ser actualizados sin cambiar el estado de instalaci�n de otros paquetes no se instalar�n, manteni�ndose la versi�n actual. Debe realizarse un <literal/update/ antes para que <command/apt-get/ sepa cuales son las versiones disponibles de los paquetes. </VarListEntry> <VarListEntry><Term>dselect-upgrade</Term> <ListItem><Para> <literal/dselect-upgrade/ se usa junto con el tradicional administrador de paquetes de Debian GNU/Linux, &dselect;. <literal/dselect-upgrade/ recoge los cambios hechos al campo de <literal/Status/ de los paquetes disponibles por &dselect;, y realiza las acciones necesarias para que los cambios se lleven a cabo (por ejemplo, borrar paquetes antiguos e instalar las nuevas versiones). </VarListEntry> <VarListEntry><Term>dist-upgrade</Term> <ListItem><Para> <literal/dist-upgrade/, adem�s de realizar las acciones de <literal/upgrade/, maneja inteligentemente los cambios de dependencias debidos a nuevas versiones de paquetes, <command/apt-get/ tiene un sofisticado sistema de resoluci�n de conflictos, si es necesario tratar� de actualizar los paquetes m�s importantes a costa de los menos importantes. El fichero <filename>/etc/apt/sources.list</> contiene la lista de sitios de los cuales se descargan los ficheros. Tambi�n puede consultar &apt-preferences; si quiere modificar este comportamiento para paquetes individuales. </VarListEntry> <VarListEntry><Term>install</Term> <ListItem><Para> <literal/install/ instala los paquetes que siguen a la palabra install. Cada nombre de paquete no es el nombre completo del paquete junto con la versi�n de Debian, sino s�lo el nombre del paquete (por ejemplo, en un sistema Debian GNU/Linux, el argumento ser�a libc6, no <literal/libc6_1.9.6-2.deb/). Se obtendr�n e instalar�n todos los paquetes especificados para la instalaci�n, as� como los requeridos por estos. El fichero <filename>/etc/apt/sources.list</> se usa para localizar los paquetes. Si al nombre del paquete se le antepone un gui�n (sin ning�n espacio), el paquete ser� desinstalado en vez de instalado. Similarmente el signo del la suma se puede usar para especificar que un paquete debe de ser instalado. Esta �ltimas caracter�sticas se pueden usar para modificar decisiones tomadas por el sistema de resoluci�n de conflictos de apt-get. <para> Se puede seleccionar una versi�n especifica de un paquete poniendo a continuaci�n del paquete un igual ('=') seguido de la versi�n deseada. Alternativamente se puede seleccionar una distribuci�n especifica poniendo a continuaci�n del nombre del paquete una barra ('/') seguido de la versi�n de la distribuci�n o su nombre en el archivo de Debian (stable, testing, unstable). <para> Cualquiera de estos dos m�todos de selecci�n puede instalar una versi�n anterior de los paquetes y debe ser usada con cuidado. <para> Finalmente, &apt-preferences; permite modificar las normas de selecci�n para paquetes individuales. <para> Si ning�n paquete coincide con la expresi�n que se ha dado y la expresi�n contiene un '.', '?' o un '*', entonces se asume que es una expresi�n regular de acuerdo con el est�ndar POSIX, y es aplicada a todos los nombres de paquetes de la base de datos. Cualquier coincidencia se instala (o desinstala). Tenga en cuenta que la comparaci�n se hace en subcadenas, de manera que 'lo.*' es v�lido para 'how-lo' y para 'lowest'. Si este no es el comportamiento deseado se debe anclar la expresi�n regular con un '^' o un '$', o bien crear una expresi�n regular m�s espec�fica. </VarListEntry> <VarListEntry><Term>remove</Term> <ListItem><Para> <literal/remove/ se comporta del mismo modo que <literal/install/ con la diferencia de que desinstala los paquetes en vez de instalarlos. Si un signo m�s precede al nombre del paquete (sin ning�n espacio en blanco entre los dos), el paquete en cuesti�n ser� instalado en vez de eliminado. </VarListEntry> <VarListEntry><Term>source</Term> <ListItem><Para> <literal/source/ hace que <command/apt-get/ descargue paquetes fuente. APT examinar� los paquetes disponibles para decidir que paquete fuente coger�. Entones descargar� en el directorio actual la versi�n m�s reciente del paquete fuente. Los paquetes fuente se obtienen de sitios distintos a los binarios, estos sitios se especifican mediante l�neas del tipo <literal/deb-src/ en el fichero &sources-list;. Esto puede provocar que la versi�n que descargar� del paquete fuente no coincida con la del paquete binario que tenga instalado o pueda instalar. Si se especifica el argumento --compile entonces el paquete se compilar� usando dpkg-buildpackage para producir un .deb binario, si se especifica el argumento --download-only entonces el paquete fuente no se desempaquetar�. <para> Una versi�n especifica de un paquete fuente puede requerirse poniendo un signo igual ('=') seguido de la versi�n a descargar despu�s del nombre del paquete. Es un mecanismo similar al que se usa con los paquetes binarios. Esto permite seleccionar exactamente el nombre y versi�n del paquete fuente, activando impl�citamente la opci�n <literal/APT::Get::Only-Source/. <para> Dese cuenta que los paquetes fuentes no se tratan como los binarios, s�lo existen en el directorio actual, es parecido a descargar los paquetes tar comprimidos con las fuentes. </VarListEntry> <VarListEntry><Term>build-dep</Term> <ListItem><Para> <literal/build-dep/ hace que apt-get instale/desinstale paquetes en un intento de satisfacer las dependencias de compilaci�n de un paquete fuente. Por el momento si hay varios paquetes que satisfacen la misma dependencia, apt-get elige uno aleatoriamente. </VarListEntry> <VarListEntry><Term>check</Term> <ListItem><Para> <literal/check/ es una herramienta de diagn�stico. Actualiza la cach� de paquetes (/var/cache/apt/pkgcache.bin), vuelve a crear un nuevo �rbol de dependencias y busca dependencias imposibles de resolver. </VarListEntry> <VarListEntry><Term>clean</Term> <ListItem><Para> <literal/clean/ borra totalmente el repositorio local que contiene los ficheros .deb descargados. Borra todo excepto el fichero de bloqueo de los directorios <filename>&cachedir;/archives/</> y <filename>&cachedir;/archives/partial/</>. Cuando APT se usa como un m�todo de &dselect;, <literal/clean/ se ejecuta autom�ticamente. Si usted no usa dselect es probable que desee ejecutar <literal/apt-get clean/ de vez en cuando para liberar algo de espacio en disco. </VarListEntry> <VarListEntry><Term>autoclean</Term> <ListItem><Para> Al igual que <literal/clean/, <literal/autoclean/ borra el repositorio local de paquetes descargados. La diferencia reside en que s�lo borrar� aquellos paquetes que ya no pueden ser descargados, o son claramente inservibles. Esto permite mantener la cach� durante largos periodos de tiempo sin que aumente su tama�o sin control. Si la opci�n de configuraci�n <literal/APT::Clean-Installed/ est� desactivada impedir� que se borren paquetes instalados. </VarListEntry> </VariableList> </RefSect1> <RefSect1><Title>Opciones</> &apt-cmdblurb; <VariableList> <VarListEntry><term><option/-d/</><term><option/--download-only/</> <ListItem><Para> S�lo descarga los ficheros con los paquetes, no los desempaqueta ni los instala. Opci�n de Configuraci�n: <literal/APT::Get::Download-Only/. </VarListEntry> <VarListEntry><term><option/-f/</><term><option/--fix-broken/</> <ListItem><Para> Intenta arreglar un sistema con dependencias actualmente rotas. Esta opci�n usada conjuntamente con install/remove, puede omitir cualquier paquete para permitir a APT deducir una posible soluci�n. Cualquier paquete especificado debe de corregir totalmente el problema. La opci�n es a veces necesaria cuando se ejecuta apt por primera vez. APT no permite que existan dependencias de paquetes rotas en un sistema. Es posible que la estructura de dependencias de un sistema est� tan deteriorada que requiera una intervenci�n manual (usualmente ejecutar &dselect; o <command/dpkg --remove/ para desinstalar alguno de los paquetes que crean el conflicto). El uso de esta opci�n junto con <option/-m/ puede producir un error en algunas situaciones. Opci�n de Configuraci�n: <literal/APT::Get::Fix-Broken/. </VarListEntry> <VarListEntry><term><option/-m/</><term><option/--ignore-missing/</> <term><option/--fix-missing/</> <ListItem><Para> No tiene en cuenta los paquetes que no se hayan podido descargar o que despu�s de la descarga se encuentren da�ados, estos paquetes se tratan como no modificables y se contin�a con el resto. Usar esta opci�n junto con <option/-f/ puede producir un error en algunas situaciones. Si un paquete se selecciona para su normal instalaci�n (particularmente si se hace mediante la l�nea de �rdenes) y no puede ser descargado, ser� tratado como no modificable. Opci�n de Configuraci�n: <literal/APT::Get::Fix-Missing/. </VarListEntry> <VarListEntry><term><option/--no-download/</> <ListItem><Para> Deshabilita la descarga de paquetes. Usada junto con <option/--ignore-missing/ es la mejor manera de forzar a APT a usar solo los .debs que ya se han descargado con anterioridad. Opci�n de Configuraci�n: <literal/APT::Get::Download/. </VarListEntry> <VarListEntry><term><option/-q/</><term><option/--quiet/</> <ListItem><Para> Silencioso. Produce una salida adecuada para un registro, omitiendo los indicadores de progreso. Si se especifican m�s q's (hasta un m�ximo de 2) se conseguir� una salida m�s silenciosa. Tambi�n es posible usar <option/-q=#/ para seleccionar el nivel de silenciosidad, no teniendo en cuenta el fichero de configuraci�n. Dese cuenta que un nivel silencioso de 2 implica <option/-y/, por lo tanto nunca se deber� usar -qq sin a�adir un modificador para que no realice ninguna acci�n como -d, --print-uris o -s para evitar que APT realice algo que usted no espera. Opci�n de Configuraci�n: <literal/quiet/. </VarListEntry> <VarListEntry><term><option/-s/</> <term><option/--simulate/</> <term><option/--just-print/</> <term><option/--dry-run/</> <term><option/--recon/</> <term><option/--no-act/</> <ListItem><Para> No realiza ninguna acci�n; simula lo que hubiese ocurrido, pero sin hacer cambios reales en el sistema. Opci�n de Configuraci�n: <literal/APT::Get::Simulate/. <para> La simulaci�n muestra por pantalla una serie de l�neas, cada una de las cuales representa una operaci�n de dpkg, configurar (Conf), desinstalar (Remv), o desempaquetar (Inst). Un par de corchetes indican paquetes con dependencias rotas, si no hay nada entre ellos significa que no hay ning�n problema (poco probable). </VarListEntry> <VarListEntry><term><option/-y/</><term><option/--yes/</> <term><option/--assume-yes/</> <ListItem><Para> Asume una respuesta afirmativa a todas las preguntas, de esta forma apt-get se ejecuta sin necesidad de intervenci�n posterior para tomar decisiones. <literal/apt-get/ terminar� sin hacer nada si se produjese una situaci�n no deseada, como cambiar un paquete puesto en hold (un paquete puesto en hold es un paquete que no debe de ser modificado) o desinstalar un paquete esencial. Opci�n de Configuraci�n: <literal/APT::Get::Assume-Yes/. </VarListEntry> <VarListEntry><term><option/-u/</><term><option/--show-upgraded/</> <ListItem><Para> Muestra los paquetes que se van a actualizar. Opci�n de Configuraci�n: <literal/APT::Get::Show-Upgraded/. </VarListEntry> <VarListEntry><term><option/-V/</><term><option/--verbose-versions/</> <ListItem><Para> Muestra la versi�n completa para los paquetes actualizados e instalados. Opci�n de configuraci�n: <literal/APT::Get::Show-Versions/. </VarListEntry> <VarListEntry><term><option/-b/</><term><option/--compile/</> <term><option/--build/</> <ListItem><Para> Descarga las fuentes y luego las compila. Opci�n de Configuraci�n: <literal/APT::Get::Compile/. </VarListEntry> <VarListEntry><term><option/--ignore-hold/</> <ListItem><Para> No respeta los paquetes retenidos. Esto puede ser interesante junto con <literal/dist-upgrade/ para no tener en cuenta un gran n�mero de paquetes en hold. Opci�n de Configuraci�n: <literal/APT::Ignore-Hold/. </VarListEntry> <VarListEntry><term><option/--no-upgrade/</> <ListItem><Para> No actualiza los paquetes. Cuando se usa juntamente con <literal/install/, <literal/no-upgrade/ evita que se actualicen los paquetes listados en la l�nea de �rdenes si ya est�n previamente instalados. Opci�n de Configuraci�n: <literal/APT::Get::Upgrade/. </VarListEntry> <VarListEntry><term><option/--force-yes/</> <ListItem><Para> Supone una respuesta afirmativa a todas las preguntas. �sta es una opci�n peligrosa que har� que apt-get contin�e incluso si va a realizar algo potencialmente peligros. No se debe usar excepto en situaciones muy especiales. �<literal/force-yes/ puede destruir su sistema! Opci�n de Configuraci�n: <literal/APT::Get::force-yes/. </VarListEntry> <VarListEntry><term><option/--print-uris/</> <ListItem><Para> Muestra las URIs de los ficheros a instalar en vez de descargarlos. Cada URI tiene la direcci�n de donde se obtendr� el paquete, el fichero de destino, su tama�o y la suma de control md5 esperada. Dese cuenta que el nombre de fichero no siempre coincide con el nombre de fichero en el sitio remoto. Esto tambi�n funciona con las ordenes <literal/source/ y <literal/update/. Cuando se usa con la orden <literal/update/, no se incluyen ni la suma de control MD5 ni el tama�o, y es tarea del usuario descomprimir cualquier fichero comprimido. Opci�n de Configuraci�n: <literal/APT::Get::Print-URIs/. </VarListEntry> <VarListEntry><term><option/--purge/</> <ListItem><Para> Borra los archivos de configuraci�n de todos los paquetes que sean desinstalados. Se mostrar� un asterisco '*' a continuaci�n de los paquetes que se encuentren en esta situaci�n. Opci�n de Configuraci�n: <literal/APT::Get::Purge/. </VarListEntry> <VarListEntry><term><option/--reinstall/</> <ListItem><Para> Reinstala los paquetes ya instalados, incluso si son la �ltima versi�n disponible del paquete. Opci�n de Configuraci�n: <literal/APT::Get::ReInstall/. </VarListEntry> <VarListEntry><term><option/--list-cleanup/</> <ListItem><Para> Esta opci�n est� activada por omisi�n, si quiere desactivarla use <literal/--no-list-cleanup/. Cuando est� activada <command/apt-get/ administra autom�ticamente los contenidos de <filename>&statedir;/lists</> para asegurarse de que se borran los ficheros obsoletos. La �nica raz�n para desactivarla es un cambio frecuente en la lista de repositorios que usa apt-get. Opci�n de Configuraci�n: <literal/APT::Get::List-Cleanup/. </VarListEntry> <VarListEntry><term><option/-t/</> <term><option/--target-release/</> <term><option/--default-release/</> <ListItem><Para> Esta opci�n permite tener un control sobre la versi�n de la distribuci�n desde la cual se instalan los paquetes de manera sencilla, creando un pin de 990 usando la cadena de caracteres proporcionada que hace referencia a la distribuci�n. Algunos ejemplos comunes pueden ser <option>-t '2.1*'</> o <option>-t unstable</>. Opci�n de configuraci�n: <literal/APT::Default-Release/. Vea adem�s la p�gina del manual de &apt-preferences;. </VarListEntry> <VarListEntry><term><option/--trivial-only/</> <ListItem><Para> S�lo realiza acciones consideradas triviales. Esta opci�n est� relacionada con <option/--assume-yes/, donde <option/--assume-yes/ responder� afirmativamente a cualquier pregunta, <option/--trivial-only/ responder� negativamente. Opci�n de configuraci�n: <literal/APT::Get::Trivial-Only/. </VarListEntry> <VarListEntry><term><option/--no-remove/</> <ListItem><Para> Si alg�n paquete va a ser desinstalado apt-get termina inmediatamente. Opci�n de Configuraci�n: <literal/APT::Get::Remove/ </VarListEntry> <VarListEntry><term><option/--only-source/</> <ListItem><Para> S�lo tiene sentido para la orden <literal/source/. Indica que los nombres de paquetes fuente dados no deben ser tratados a trav�s de la tabla de binarios. Esto significa que si se especifica esta opci�n, la orden <literal/source/ s�lo aceptar� como argumentos nombres de paquetes fuente, en vez de aceptar nombres de paquetes binarios y luego buscar el nombre del paquete fuente correspondiente. Opci�n de Configuraci�n: <literal/APT::Get::Only-Source/ </VarListEntry> <VarListEntry><term><option/--diff-only/</><term><option/--tar-only/</> <ListItem><Para> Descarga s�lo el fichero diff o tar del archivo fuente. Opciones de Configuraci�n: <literal/APT::Get::Diff-Only/ y <literal/APT::Get::Tar-Only/ </VarListEntry> <VarListEntry><term><option/--arch-only/</> <ListItem><Para> Procesa s�lo las dependencias de construcci�n dependientes de la arquitectura. Opci�n de configuraci�n: <literal/APT::Get::Arch-Only/ </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>/etc/apt/apt.conf</></term> <ListItem><Para> Fichero de configuraci�n de APT. Opci�n de Configuraci�n: <literal/Dir::Etc::Main/. </VarListEntry> <VarListEntry><term><filename>/etc/apt/apt.conf.d/</></term> <ListItem><Para> Directorio con fragmentos de ficheros de configuraci�n APT. Opci�n de Configuraci�n: <literal/Dir::Etc::Parts/. </VarListEntry> <VarListEntry><term><filename>/etc/apt/preferences</></term> <ListItem><Para> Fichero de configuraci�n que contiene preferencias sobre versiones de paquetes, por ejemplo, puede especificar que un cierto paquete se descargue de un sitio diferente, o de una distribuci�n con una versi�n diferente. Opci�n de Configuraci�n: <literal/Dir::Etc::Preferences/. </VarListEntry> <VarListEntry><term><filename>&cachedir;/archives/</></term> <ListItem><Para> Directorio donde se guardan los paquetes obtenidos. Opci�n de Configuraci�n: <literal/Dir::Cache::Archives/. </VarListEntry> <VarListEntry><term><filename>&cachedir;/archives/partial/</></term> <ListItem><Para> Directorio donde se guardan los ficheros en tr�nsito. Opci�n de Configuraci�n: <literal/Dir::Cache::Archives/ (Implica partial). </VarListEntry> <VarListEntry><term><filename>&statedir;/lists/</></term> <ListItem><Para> Directorio donde se almacena informaci�n de estado por cada sitio especificado en &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/ (Implica partial). </VarListEntry> </variablelist> </RefSect1> <RefSect1><Title>Vea adem�s</> <para> &apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, &apt-config;, la gu�a de usuario de APT en &docdir;, &apt-preferences;, el C�mo de APT. </RefSect1> <RefSect1><Title>Diagn�sticos</> <para> <command/apt-get/ devuelve cero en operaciones satisfactorias, 100 en caso de error. </RefSect1> &manbugs; &manauthor; <refsect1> <title>TRADUCTOR</title> <para> Traducci�n de Rub�n Porras Campo <debian-l10n-spanish@lists.debian.org> </para> </refsect1> </refentry>