Provided by: apt_1.0.1ubuntu2.24_amd64 
NOMBRE
apt-get - Herramienta de gestión de paquetes APT -- interfaz para la línea de órdenes
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.0.1ubuntu2.24_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,
packages.debian.org/changelogs[1] para Debian o changelogs.ubuntu.com/changelogs[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.
--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:
DpkgPM::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)
VÉASE TAMBIÉN
apt-cache(8), apt-cdrom(8), dpkg(1), sources.list(5), apt.conf(5), apt-config(8), apt-
secure(8), The APT User's guide in /usr/share/doc/apt-doc/, apt_preferences(5), the APT
Howto.
DIAGNÓSTICOS
apt-get devuelve cero si no hay ningún error, y el valor 100 en caso de error.
BUGS
Página 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).
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