SINOPSIS

apt-get [-asqdyfmubV] [-o=config_string] [-c=config_file] [-t=target_release] [-a=architecture] {update | upgrade | dselect-upgrade | dist-upgrade | install pkg [{=pkg_version_number | /target_release}]... | remove pkg... | purge pkg... | source pkg [{=pkg_version_number | /target_release}]... | build-dep pkg [{=pkg_version_number | /target_release}]... | download pkg [{=pkg_version_number | /target_release}]... | check | clean | autoclean | autoremove | {-v | --version} | {-h | --help}}

DESCRIPCIÓN

apt-get

is the command-line tool for handling packages, and may be considered the user's "back-end" to other tools using the APT library. Several "front-end" interfaces exist, such as aptitude(8), synaptic(8) and wajig(1).

A menos que se use la opción -h o --help, una de las siguientes órdenes debe estar presente.

update

update se usa para sincronizar el índice de paquetes desde sus fuentes. Los índices de paquetes disponibles se obtienen de los lugares especificados en /etc/apt/sources.list. Por ejemplo, cuando se usa un archivo de Debian, esta orden descarga y analiza los ficheros Packages.gz, de tal forma que la información acerca de los nuevos paquetes pasa a estar disponible. Siempre se debe realizar un update antes de un upgrade o un dist-upgrade. Tenga en cuenta que el indicador de progreso será incorrecto, ya que se desconoce de antemano el tamaño de los archivos de paquete.

upgrade

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 /etc/apt/sources.list. Los paquetes instalados con una nueva versión disponible se descargan y actualizan, y bajo ninguna circunstancia se desinstalarán paquetes, o se instalarán paquetes nuevos. Las nuevas versiones de programas instalados que no se puedan actualizar sin cambiar el estado de instalación de otros paquetes no se instalarán, manteniéndose la versión actual. Debe realizar un update antes para que apt-get sepa que hay nuevas versiones disponibles.

dist-upgrade

dist-upgrade, además de realizar las acciones de upgrade, trata inteligentemente los cambios de dependencias debidos a las nuevas versiones de paquetes. apt-get tiene un sistema «inteligente» de resolución de conflictos, y si es necesario tratará de actualizar los paquetes más importantes a costa de los menos importantes. Por ello, puede que la orden dist-upgrade elimine algunos paquetes. El fichero /etc/apt/sources.list contiene una lista de sitios desde los que descargar los ficheros de paquetes. También puede consultar apt_preferences(5) si quiere invalidar este comportamiento para paquetes individuales.

dselect-upgrade

dselect-upgrade se usa junto al tradicional administrador de paquetes de Debian, dselect(1). dselect-upgrade registra los cambios que haya hecho dselect(1) al campo Status (estado) de los paquetes disponibles y realiza las acciones necesarias para que los cambios se lleven a cabo (por ejemplo, borrar paquetes antiguos e instalar las nuevas versiones).

install

install instala o actualiza los paquetes que siguen a la palabra «install». Cada paquete es un nombre de paquete, y no el nombre completo del fichero del paquete (por ejemplo, en un sistema Debian GNU/Linux, el argumento sería apt-utils, y no apt-utils_1.1~exp8_amd64.deb). Se obtendrán e instalarán todos los paquetes necesarios por los paquetes especificados para la instalación. El fichero /etc/apt/sources.list se utiliza para ubicar los paquetes. Si se antepone un guión al nombre del paquete (sin ningún espacio) el paquete se desinstalará en vez de instalar. De forma similar, el signo de suma se puede usar para especificar que un paquete se debe instalar. Estas últimas características se pueden usar para invalidar las decisiones tomadas por el sistema de resolución de conflictos de apt-get.

Puede seleccionar una versión especifica de un paquete poniendo a continuación del nombre del paquete un símbolo igual («=») seguido de la versión deseada. Esto provocará que se localice y seleccione esa versión para su instalación. Alternativamente se puede seleccionar una distribución específica poniendo a continuación del nombre del paquete una barra («/») seguida de la versión de la distribución o su nombre en el archivo de Debian (stable, testing, unstable).

Cualquiera de estos dos métodos de selección puede instalar una versión anterior de los paquetes y se debe utilizar con precaución.

Esto también es el objetivo a usar si quiere actualizar uno o más paquetes instalados sin actualizar todos los paquetes del sistema. A diferencia del objetivo de «upgrade», que instala la versión más nueva de todos los paquetes instalados, «install» instalará la versión más nueva sólo de los paquetes especificados. Simplemente proporcione el nombre de los paquetes que quiere actualizar, y si una versión más nueva está disponible ésta (y sus dependencias, como se describió anteriormente) se descargarán e instalarán.

Por último, apt_preferences(5) permite modificar las normas de selección para paquetes individuales.

Si ningún paquete coincide con la expresión proporcionada 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 se aplica 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, debe anclar la expresión regular con un «^» o un «$», o bien crear una expresión regular más específica.

remove

remove se comporta del mismo modo que install con la diferencia de que elimina los paquetes en vez de instalarlos. Tenga en cuenta que al eliminar un paquete sus ficheros de configuración permanecen en el sistema. Si un signo de suma 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.

purge

purge es idéntico a remove, con la diferencia de que los paquetes se eliminarán y purgarán (se eliminará también cualquier fichero de configuración).

source

source hace que apt-get descargue los paquetes fuente. APT examinará los paquetes disponibles para decidir qué paquete fuente descargará. Entonces descargará la versión más reciente del paquete fuente en el directorio actual respetando la versión predeterminada, que se define en la opción APT::Default-Release, la opción -t o según el paquete con la sintaxis pkg/release, si es posible.

Los paquetes fuente se registran de forma separada de los paquetes binarios mediante líneas del tipo deb-src en el fichero sources.list(5). Esto significa que debe añadir una línea como ésta para cada repositorio del que quiera conseguir las fuentes. En caso contrario podría obtener una versión de fuentes distinta (demasiado antigua/reciente) o ninguna.

Si se especifica la opción --compile el paquete se compilará en un binario «.deb» utilizando dpkg-buildpackage para la arquitectura definida con la opción --host-architecture. Si se especifica --download-only el paquete fuente no se desempaquetará.

Puede obtener una versión especifica de un paquete fuente insertando un signo igual («=») seguido de la versión a descargar después del nombre del paquete, de forma similar al método 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 APT::Get::Only-Source.

Tenga en cuenta que los paquetes fuente no se instalan ni registran en la base de datos de dpkg como sí lo hacen los binarios. Sólo se descargan al directorio actual en la forma de archivos tar de fuentes.

build-dep

build-dep procova que apt-get instale/elimine paquetes para intentar satisfacer las dependencias de construcción de un paquete fuente. Por omisión, las dependencias se satisfacen para construir el paquete de forma nativa. También se puede definir la arquitectura anfitrión --host-architecture.

check

check es una herramienta de diagnóstico, actualiza la caché de paquetes y revisa la existencia de dependencias rotas.

download

download descarga el paquete binario introducido al directorio actual.

clean

clean clears out the local repository of retrieved package files. It removes everything but the lock file from /var/cache/apt/archives/ and /var/cache/apt/archives/partial/.

autoclean

Al igual que clean, autoclean borra el repositorio local de paquetes descargados. La diferencia reside en que sólo borrará aquellos paquetes que ya no se pueden descargar, o que son claramente inservibles. Esto permite mantener el almacén durante largos periodos de tiempo sin que aumente su tamaño descontroladamente. Si la opción de configuración APT::Clean-Installed está desactivada impedirá que se borren los paquetes instalados.

autoremove

autoremove desinstala paquetes que se instalaron automáticamente para satisfacer las dependencias de otros paquetes pero que ya no son necesarios.

changelog

changelog descarga un fichero de registro de cambios «changelog» de un paquete dado y lo muestra a través de sensible-pager. El nombre de servidor y el directorio base se define con la variable APT::Changelogs::Server (por ejemplo, m[blue]packages.debian.org/changelogsm[][1] para Debian o m[blue]changelogs.ubuntu.com/changelogsm[][2] para Ubuntu). Por omisión, muestra el fichero de registro de cambios de la versión instalada. Por otra parte, puede definir las mismas opciones que con la orden install.

OPCIONES

Todas las opciones de la línea de órdenes se pueden definir mediante el fichero de configuración, las descripciones indican la opción de la configuración a definir. Para opciones de tipo «boolean» puede invalidar el fichero de configuración utilizando algo como -f-,--no-f, -f=no u otras muchas variaciones.

--no-install-recommends

No considera los paquetes recomendados como dependencia al instalar. Opción de configuración: APT::Install-Recommends.

--install-suggests

Considera los paquetes sugeridos («Suggests») como una dependencia a instalar. Opción de configuración: APT::Install-Suggests.

-d, --download-only

Sólo descarga los ficheros de los paquetes, no los desempaqueta ni los instala. Opción de configuración: APT::Get::Download-Only.

-f, --fix-broken

Fix; attempt to correct a system with broken dependencies in place. This option, when used with install/remove, can omit any packages to permit APT to deduce a likely solution. If packages are specified, these have to completely correct the problem. The option is sometimes necessary when running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention (which usually means using dpkg --remove to eliminate some of the offending packages). Use of this option together with -m may produce an error in some situations. Configuration Item: APT::Get::Fix-Broken.

-m, --ignore-missing, --fix-missing

Ignora paquetes faltantes. Si no se pueden descargar paquetes, o estos no superan la prueba de integridad tras la descarga (ficheros de paquete corruptos), se retienen y se continúa con el resto. Si se utiliza esta opción con -f puede provocar un error en algunos casos. Si un paquete se selecciona para su instalación (particularmente si se hace mediante la línea de órdenes) y no se puede descargar, se le retendrá silenciosamente. Opción de configuración: APT::Get::Fix-Missing.

--no-download

Deshabilita la descarga de paquetes. Si se utiliza junto --ignore-missing ofrece la mejor manera de forzar a APT a utilizar sólo los ficheros «.deb» descargados con anterioridad. Opción de configuración: APT::Get::Download.

-q, --quiet

Produce una salida adecuada para su registro, omitiendo los indicadores de progreso. Si se especifican más «q» (hasta un máximo de 2) se conseguirá una salida más silenciosa. También es posible usar -q=# para seleccionar el nivel de silencio, omitiendo el fichero de configuración. Tenga en cuenta que un nivel silencioso 2 implica -y; por ello, no se debe utilizar «-qq» sin añadir un modificador de acción nula como «-d», «--print-uris» o «-s» para evitar que APT realice algo que usted no espera. Opción de configuración: quiet.

-s, --simulate, --just-print, --dry-run, --recon, --no-act

No realiza ninguna acción, simula lo que hubiese ocurrido pero sin hacer cambios reales en el sistema. Opción de configuración: APT::Get::Simulate.

Las simulaciones de ejecución realizadas por un usuario desactivan el bloqueo de forma automática (Debug::NoLocking), y si se define la opción APT::Get::Show-User-Simulation-Note (activa de forma predefinida) se muestra un aviso que indica que solo es una simulación. Las ejecuciones realizadas como usuario «root» no activan «NoLocking» o el aviso. Los administradores deben ser conscientes de sus acciones sin avisos de apt-get.

Las simulaciones de ejecución muestran un conjunto de líneas, y cada una representa una acción de dpkg: configuración (Conf), eliminación (Remv) o desempaquetado (Inst). Los corchetes indican paquetes rotos, y corchetes vacíos indican relaciones de rotura sin consecuencias (poco frecuente).

-y, --yes, --assume-yes

Supone una respuesta afirmativa a todas las preguntas, de esta forma apt-get se ejecuta sin necesidad de intervención posterior para tomar decisiones. apt-get terminará sin hacer nada de producirse una situación no deseada, como cambiar un paquete retenido, instalar un paquete sin autenticar o desinstalar un paquete esencial. Opción de configuración: APT::Get::Assume-Yes.

--assume-no

Supone «no» a todas las consultas. Opción de configuración: APT::Get::Assume-No.

-u, --show-upgraded

Muestra los paquetes que se van a actualizar. Opción de configuración: APT::Get::Show-Upgraded.

-V, --verbose-versions

Muestra las versiones completas para los paquetes actualizados e instalados. Opción de configuración: APT::Get::Show-Versions.

-a, --host-architecture

This option controls the architecture packages are built for by apt-get source --compile and how cross-builddependencies are satisfied. By default is it not set which means that the host architecture is the same as the build architecture (which is defined by APT::Architecture). Configuration Item: APT::Get::Host-Architecture.

-P, --build-profiles

This option controls the activated build profiles for which a source package is built by apt-get source --compile and how build dependencies are satisfied. By default no build profile is active. More than one build profile can be activated at a time by concatenating them with a comma. Configuration Item: APT::Build-Profiles.

-b, --compile, --build

Descarga los paquetes fuente y luego los compila. Opción de configuración: APT::Get::Compile.

--ignore-hold

Ignora los paquetes retenidos. Esto hace que apt-get ignore toda retención impuesta a un paquete. Esto puede ser útil junto a dist-upgrade para invalidar un gran número de paquetes retenidos de manera no deseada. Opción de configuración: APT::Ignore-Hold.

--with-new-pkgs

Allow installing new packages when used in conjunction with upgrade. This is useful if the update of a installed package requires new dependencies to be installed. Instead of holding the package back upgrade will upgrade the package and install the new dependencies. Note that upgrade with this option will never remove packages, only allow adding new ones. Configuration Item: APT::Get::Upgrade-Allow-New.

--no-upgrade

No actualiza los paquetes. Cuando se usa junto a install, no-upgrade, impide que se actualicen los paquetes definidos en la línea de órdenes si ya están instalados. Opción de configuración: APT::Get::Upgrade.

--only-upgrade

No instala paquetes nuevos. Cuando se usa junto a install, only-upgrade solo actualiza los paquetes definidos en la línea de órdenes que ya están instalados, e ignora las órdenes de instalación de paquetes nuevos. Opción de configuración: APT::Get::Only-Upgrade.

--force-yes

Supone una respuesta afirmativa a todas las preguntas. Ésta es una opción peligrosa que hará que apt continúe sin preguntar incluso si se va a realizar algo potencialmente peligroso. No se debe usar excepto en situaciones muy especiales. ¡Utilizar force-yes puede destruir su sistema! Opción de configuración: APT::Get::force-yes.

--print-uris

Muestra los URI de los ficheros a instalar en vez de descargarlos. Cada URI contiene la dirección de dónde se obtendrá el paquete, el fichero de destino, su tamaño y la suma de control MD5 esperada. Tenga en cuenta que el nombre de fichero no siempre coincide con el nombre del fichero en el sitio remoto. Esto también funciona con las órdenes source y update. Cuando se usa con la orden update no se incluyen ni el resumen MD5 ni el tamaño, y es tarea del usuario descomprimir cualquier fichero comprimido. Opción de configuración: APT::Get::Print-URIs.

--purge

Utiliza «purge» (purgar) en lugar de «remove» para todo aquello que se desinstale. Un asterisco («*») aparecerá a continuación de los paquetes que se vayan a purgar. remove --purge es equivalente a la orden purge. Opción de configuración: APT::Get::Purge.

--reinstall

Reinstala los paquetes ya instalados, incluso si son la última versión disponible del paquete. Opción de configuración: APT::Get::ReInstall.

--list-cleanup

Esta opción está activada de forma predeterminada, si quiere desactivarla utilice --no-list-cleanup. Cuando está activada apt-get administra automáticamente los contenidos de /var/lib/apt/lists para asegurarse de que se borran los ficheros obsoletos. La única razón para desactivarla es si realiza frecuentemente cambios en la lista de fuentes. Opción de configuración: APT::Get::List-Cleanup.

-t, --target-release, --default-release

Esta opción controla la entrada predeterminada del motor de directrices, creando un anclaje («pin») con una prioridad 990 usando la cadena de caracteres de la distribución especificada. Esto invalida la configuración general de /etc/apt/preferences. Aquellos paquetes con un anclaje específico no se verán afectados por el valor de esta opción. Resumiendo, esta opción le da control sobre la distribución de la que se obtienen los paquetes. Algunos ejemplos comunes pueden ser -t '2.1*' o -t unstable o -t sid. Opción de configuración: APT::Default-Release. Consulte también la página del manual de apt_preferences(5).

--trivial-only

Sólo realiza acciones consideradas «triviales». Esta opción está relacionada con --assume-yes, de modo que donde --assume-yes responde afirmativamente a cualquier pregunta, --trivial-only responderá negativamente. Opción de configuración: APT::Get::Trivial-Only.

--no-remove

Si se va a desinstalar algún paquete, apt-get terminará inmediatamente sin preguntar. Opción de configuración: APT::Get::Remove

--auto-remove

Si la orden es install o remove, esta opción realiza el funcionamiento de autoremove, eliminando dependencias en desuso. Opción de configuración: APT::Get::AutomaticRemove.

--only-source

Sólo tiene sentido para las órdenes source y build-dep. Indica que los nombres de paquetes fuente proporcionados no se deben tratar a través de la tabla de binarios. Esto significa que si se especifica esta opción, estas órdenes sólo aceptarán como argumento nombres de paquetes fuente, en vez de aceptar nombres de paquetes binarios, para luego buscar el nombre del paquete fuente correspondiente. Opción de configuración: APT::Get::Only-Source

--diff-only, --dsc-only, --tar-only

Descarga sólo el fichero diff, dsc o tar del archivo de fuentes. Opciones de configuración: APT::Get::Diff-Only, APT::Get::Dsc-Only y APT::Get::Tar-Only.

--arch-only

Procesa sólo las dependencias de construcción dependientes de la arquitectura. Opción de configuración: APT::Get::Arch-Only

--allow-unauthenticated

Ignora si los paquetes no se pueden autenticar, sin generar ningún diálogo sobre ello. Esto es útil para herramientas como pbuilder. Opción de configuración: APT::Get::AllowUnauthenticated.

--no-allow-insecure-repositories

Forbid the update command to acquire unverifiable data from configured sources. Apt will fail at the update command for repositories without valid cryptographically signatures. Configuration Item: Acquire::AllowInsecureRepositories.

--show-progress

Show user friendly progress information in the terminal window when packages are installed, upgraded or removed. For a machine parsable version of this data see README.progress-reporting in the apt doc directory. Configuration Item: Dpkg::Progress and Dpkg::Progress-Fancy.

-h, --help

Muestra un mensaje corto sobre el uso.

-v, --version

Muestra la versión del programa.

-c, --config-file

Fichero de configuración: Especifica el fichero de configuración a usar. El programa leerá el fichero de configuración predeterminado y, después, este fichero de configuración. Si necesita que ciertas opciones de configuración se definan antes que el análisis de los de los ficheros de configuración predeterminados, defina un fichero con la variable de entorno APT_CONFIG. Consulte apt.conf(5) para información sobre la sintaxis.

-o, --option

Define una opción de configuración: Esto definirá una opción arbitraria de configuración. 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 dónde conseguir los paquetes. Opción de configuración: Dir::Etc::SourceList.

/etc/apt/sources.list.d/

Fragmentos de fichero para las ubicaciones de dónde descargar los paquetes. Opción de configuración: Dir::Etc::SourceParts.

/etc/apt/apt.conf

Fichero de configuración de APT. Opción de configuración: Dir::Etc::Main.

/etc/apt/apt.conf.d/

Fragmentos del fichero de configuración de APT. Opción de configuración: Dir::Etc::Parts.

/etc/apt/preferences

Ficheros de preferencias de versión. Aquí puede especificar el anclaje ("pinning"), una preferencia para conseguir ciertos paquetes a partir de una fuente diferente o de una versión diferente de una distribución. Opción de configuración: Dir::Etc::Preferences.

/etc/apt/preferences.d/

Fragmentos de fichero para las preferencias de la versión. Opción de configuración: Dir::Etc::PreferencesParts.

/var/cache/apt/archives/

Área de almacenamiento para los ficheros de paquetes descargados. Opción de configuración: Dir::Cache::Archives.

/var/cache/apt/archives/partial/

Área de almacenamiento para los ficheros de paquetes en tránsito. Opción de configuración: Dir::Cache::Archives (se añade partialde forma implícita)

/var/lib/apt/lists/

Área de almacenamiento para la información del estado de cada fuente de paquetes especificado en sources.list(5) Opción de configuración: Dir::State::Lists.

/var/lib/apt/lists/partial/

Área de almacenamiento para la información de estado en tránsito. Elemento de configuración: Dir::State::Lists (se añade partial de forma implícita)

DIAGNÓSTICOS

apt-get devuelve cero si no hay ningún error, y el valor 100 en caso de error.

TRADUCCIÓN

La traducción al español la realizaron Ismael Fanlo, Carlos Mestre, Rudy Godoy, Gustavo Saldumbide, Javier Fernández-Sanguino y Rubén Porras Campo entre los años 2003 y 2004. La traducción fue actualizada por Francisco Javier Cuadrado y Omar Campagne Polaino entre los años 2009 y 2012 .

Tenga en cuenta que este documento puede contener secciones sin traducir. Esto es intencionado para evitar perder contenido cuando la traducción no está actualizada con respecto al documento original.

AUTORES

Jason Gunthorpe

Equipo de APT

NOTAS

1.

packages.debian.org/changelogs

http://packages.debian.org/changelogs

2.

changelogs.ubuntu.com/changelogs

http://changelogs.ubuntu.com/changelogs

3.

Página de errores de APT

http://bugs.debian.org/src:apt