Provided by:
apt_0.8.16~exp12ubuntu10_i386 
NAME
apt-get - Herramienta de gestion de paquetes APT -- interfaz para la
linea de ordenes
SYNOPSIS
apt-get [-sqdyfmubV] [-o= config_string ] [-c= config_file ]
[-t= target_release] [-a= default_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... | check | clean | autoclean | autoremove |
{-v | --version} | {-h | --help}}
DESCRIPCI'oN
apt-get es la herramienta para la gestion de paquetes desde la linea de
ordenes, y se puede considerar el sistema de <<bajo nivel>> de otras
herramientas de usuario que usan la biblioteca de APT. Existen varias
interfaces de <<alto nivel>>, tales como dselect(1), aptitude(8),
synaptic(8) y wajig(1).
A menos que se use la opcion -h o --help, una de las siguientes ordenes
debe estar presente.
update
update se usa para sincronizar el indice de paquetes desde sus
fuentes. Los indices 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 informacion 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 sera incorrecto, ya que se desconoce
de antemano el tamano de los archivos de paquete.
upgrade
upgrade se usa para instalar la version mas 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 version disponible se descargan y actualizan, y bajo
ninguna circunstancia se desinstalaran paquetes, o se instalaran
paquetes nuevos. Las nuevas versiones de programas instalados que
no se puedan actualizar sin cambiar el estado de instalacion de
otros paquetes no se instalaran, manteniendose la version actual.
Debe realizar un update antes para que apt-get sepa que hay nuevas
versiones disponibles.
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).
dist-upgrade
dist-upgrade, ademas 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
resolucion de conflictos, y si es necesario tratara de actualizar
los paquetes mas importantes a costa de los menos importantes. El
fichero /etc/apt/sources.list contiene la lista de sitios desde los
que descargar los ficheros de paquetes. Tambien puede consultar
apt_preferences(5) si quiere invalidar este comportamiento para
paquetes individuales.
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 seria libc6, no libc6_1.9.6-2.deb). Se
obtendran e instalaran todos los paquetes necesarios por los
paquetes especificados para la instalacion. El fichero
/etc/apt/sources.list se usa para ubicar los paquetes. Si antepone
un guion al nombre del paquete (sin ningun espacio) el paquete se
desinstalara en vez de instalar. De forma similar, el signo de suma
se puede usar para especificar que un paquete se debe instalar.
Estas ultimas caracteristicas se pueden usar para invalidar las
decisiones tomadas por el sistema de resolucion de conflictos de
apt-get.
Puede seleccionar una version especifica de un paquete poniendo a
continuacion del nombre del paquete un simbolo igual (<<=>>)
seguido de la version deseada. Esto provocara que se localice y
seleccione esa version para su instalacion. Alternativamente se
puede seleccionar una distribucion especifica poniendo a
continuacion del nombre del paquete una barra (<</>>) seguida de la
version de la distribucion o su nombre en el archivo de Debian
(stable, testing, unstable).
Cualquiera de estos dos metodos de seleccion puede instalar una
version anterior de los paquetes y se debe usar con cuidado.
Esto tambien es el objetivo a usar si quiere actualizar uno o mas
paquetes instalados sin actualizar todos los paquetes del sistema.
A diferencia del objetivo de <<upgrade>>, que instala la version
mas nueva de todos los paquetes instalados, <<install>> instalara
la version mas nueva solo de los paquetes especificados.
Simplemente proporcione el nombre de los paquetes que quiere
actualizar, y si una version mas nueva esta disponible esta (y sus
dependencias, como se describio anteriormente) se descargaran e
instalaran.
Por ultimo, apt_preferences(5) permite modificar las normas de
seleccion para paquetes individuales.
Si ningun paquete coincide con la expresion proporcionada y la
expresion contiene un <<.>>, <<?>> o un <<*>>, entonces se asume
que es una expresion regular de acuerdo con el estandar 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 comparacion se hace en subcadenas, de manera que <<lo.*>> es
valido para <<how-lo>> y para <<lowest>>. Si este no es el
comportamiento deseado, debe anclar la expresion regular con un
<<^>> o un <<$>>, o bien crear una expresion regular mas
especifica.
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 configuracion se quedan en
el sistema. Si un signo de suma precede al nombre del paquete (sin
ningun espacio en blanco entre los dos), el paquete en cuestion
sera instalado en vez de eliminado.
purge
purge es identico a remove, con la diferencia de que los paquetes
se eliminaran y purgaran (se eliminara tambien cualquier fichero de
configuracion).
source
source hace que apt-get descargue los paquetes fuente. APT
examinara los paquetes disponibles para decidir que paquete fuente
descargara. Entonces descargara la version mas reciente del paquete
fuente en el directorio actual respetando la version
predeterminada, que se define en la opcion APT::Default-Release, la
opcion -t o segun el paquete con la sintaxis pkg/release, si es
posible.
Los paquetes fuente se registran de forma separada a los paquetes
binarios mediante lineas del tipo deb-src en el fichero
sources.list(5). Esto significa que tendra que anadir una linea
como esa para cada repositorio del que quiera conseguir las
fuentes. Si no hace esto obtendra una version de fuentes distinta
(mas nueva, vieja o ninguna) de la que tiene instalada o de la que
podria instalar.
If the --compile option is specified then the package will be
compiled to a binary .deb using dpkg-buildpackage for the
architecture as defined by the --host-architecture option. If
--download-only is specified then the source package will not be
unpacked.
Puede obtener una version especifica de un paquete fuente
insertando un signo igual (<<=>>) seguido de la version a descargar
despues del nombre del paquete, de forma similar al metodo que se
usa con los paquetes binarios. Esto permite seleccionar exactamente
el nombre y version del paquete fuente, activando implicitamente la
opcion APT::Get::Only-Source.
Tenga en cuenta que los paquetes fuentes no se tratan como los
binarios, solo existen en el directorio actual y es parecido a
descargar los paquetes tar comprimidos con las fuentes.
build-dep
build-dep causes apt-get to install/remove packages in an attempt
to satisfy the build dependencies for a source package. By default
the dependencies are satisfied to build the package natively. If
desired a host-architecture can be specified with the
--host-architecture option instead.
check
check es una herramienta de diagnostico, actualiza la cache de
paquetes y revisa la existencia de dependencias rotas.
download
download will download the given binary package into the current
directory.
clean
clean borra totalmente el repositorio local que contiene los
ficheros de los paquetes descargados. Borra todo excepto el fichero
de bloqueo de los directorios /var/cache/apt/archives/ y
/var/cache/apt/archives/partial/. Cuando APT se usa como un metodo
de dselect(1), clean se ejecuta automaticamente. Si no usa dselect
es probable que desee ejecutar apt-get clean de vez en cuando para
liberar algo de espacio en disco.
autoclean
Al igual que clean, autoclean borra el repositorio local de
paquetes descargados. La diferencia reside en que solo borrara
aquellos paquetes que ya no se pueden descargar, o que son
claramente inservibles. Esto permite mantener el almacen durante
largos periodos de tiempo sin que aumente su tamano
descontroladamente. Si la opcion de configuracion
APT::Clean-Installed esta desactivada impedira que se borren los
paquetes instalados.
autoremove
autoremove is used to remove packages that were automatically
installed to satisfy dependencies for other packages and are now no
longer needed.
changelog
changelog downloads a package changelog and displays it through
sensible-pager. The server name and base directory is defined in
the APT::Changelogs::Server variable (e. g.
http://packages.debian.org/changelogs for Debian or
http://changelogs.ubuntu.com/changelogs for Ubuntu). By default it
displays the changelog for the version that is installed. However,
you can specify the same options as for the install command.
OPCIONES
Todas las opciones de la linea de ordenes se pueden definir mediante el
fichero de configuracion, las descripciones indican la opcion de la
configuracion a definir. Para opciones de tipo <<boolean>> puede
invalidar el fichero de configuracion utilizando algo como -f-,--no-f,
-f=no u otras muchas variaciones.
--no-install-recommends
No considera los paquetes recomendados como dependencia al
instalar. Opcion de configuracion: APT::Install-Recommends.
--install-suggests
Consider suggested packages as a dependency for installing.
Configuration Item: APT::Install-Suggests.
-d, --download-only
Solo descarga los ficheros de los paquetes, no los desempaqueta ni
los instala. Opcion de configuracion: APT::Get::Download-Only.
-f, --fix-broken
Intenta arreglar un sistema con dependencias actualmente rotas. Si
se usa esta opcion junto a <<install>>/<<remove>> se puede omitir
cualquier paquete para permitir a APT deducir una posible solucion.
Si se especifican problemas, deben corregir totalmente el problema.
La opcion, a veces, se necesita 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 este tan deteriorada que requiera una intervencion manual
(generalmente puede ejecutar dselect(1) o dpkg --remove para
desinstalar alguno de los paquetes que crean el conflicto). El uso
de esta opcion junto con -m puede producir un error en algunas
situaciones. Opcion de configuracion: APT::Get::Fix-Broken.
-m, --ignore-missing, --fix-missing
No tiene en cuenta los paquetes que no se hayan podido descargar o
que despues de la descarga se encuentren danados (ficheros de
paquete corruptos), estos paquetes se retienen y se continua con el
resto. Usar esta opcion junto con -f puede producir un error en
algunas situaciones. Si un paquete se selecciona para su
instalacion (particularmente si se hace mediante la linea de
ordenes) y no se puede descargar, se le retendra silenciosamente.
Opcion de configuracion: APT::Get::Fix-Missing.
--no-download
Deshabilita la descarga de paquetes. Usada junto con
--ignore-missing ofrece la mejor manera de forzar a APT a usar solo
los ficheros <<.deb>> descargados con anterioridad. Opcion de
configuracion: APT::Get::Download.
-q, --quiet
Produce una salida adecuada para su registro, omitiendo los
indicadores de progreso. Si se especifican mas <<q>> (hasta un
maximo de 2) se conseguira una salida mas silenciosa. Tambien es
posible usar -q=# para seleccionar el nivel de silencio, omitiendo
el fichero de configuracion. Tenga en cuenta que un nivel
silencioso de 2 implica -y, por lo tanto nunca se debera usar
<<-qq>> sin anadir un modificador para que no realice ninguna
accion como <<-d>>, <<--print-uris>> o <<-s>> para evitar que APT
realice algo que usted no espera. Opcion de configuracion: quiet.
-s, --simulate, --just-print, --dry-run, --recon, --no-act
No realiza ninguna accion, simula lo que hubiese ocurrido pero sin
hacer cambios reales en el sistema. Opcion de configuracion:
APT::Get::Simulate.
Si la simulacion se ejecuta como usuario desactivara el bloqueo
automatico (Debug::NoLocking). Si la opcion
APT::Get::Show-User-Simulation-Note esta activada (activa de forma
predeterminada) se mostrara un mensaje indicando que solo es una
simulacion. Ni se realizara <<NoLocking>> ni se mostrara el mensaje
si se ejecuta como administrador (<<root>>), ya que deberia saber
lo que esta haciendo sin mas avisos de apt-get).
La simulacion muestra en la pantalla una serie de lineas, cada una
de las cuales representa una operacion 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 ningun problema (poco probable).
-y, --yes, --assume-yes
Supone una respuesta afirmativa a todas las preguntas, de esta
forma apt-get se ejecuta sin necesidad de intervencion posterior
para tomar decisiones. apt-get terminara sin hacer nada de
producirse una situacion no deseada, como cambiar un paquete
retenido, instalar un paquete sin autenticar o desinstalar un
paquete esencial. Opcion de configuracion: APT::Get::Assume-Yes.
--assume-no
Automatic "no" to all prompts. Configuration Item:
APT::Get::Assume-No.
-u, --show-upgraded
Muestra los paquetes que se van a actualizar. Opcion de
configuracion: APT::Get::Show-Upgraded.
-V, --verbose-versions
Muestra las versiones completas para los paquetes actualizados e
instalados. Opcion de configuracion: 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
-b, --compile, --build
Descarga los paquetes fuente y luego los compila. Opcion de
configuracion: APT::Get::Compile.
--ignore-hold
Ignora los paquetes retenidos. Esto hace que apt-get ignore toda
retencion impuesta a un paquete. Esto puede ser util junto a
dist-upgrade para invalidar un gran numero de paquetes retenidos de
manera no deseada. Opcion de configuracion: APT::Ignore-Hold.
--no-upgrade
No actualiza los paquetes. Cuando se usa junto a install,
no-upgrade evita que se actualicen los paquetes listados en la
linea de ordenes si ya estan instalados. Opcion de configuracion:
APT::Get::Upgrade.
--only-upgrade
No instala paquetes nuevos. Cuando se usa junto a install,
only-upgrade evita que se actualicen los paquetes listados en la
linea de ordenes si no estan ya instalados. Opcion de
configuracion: APT::Get::Only-Upgrade.
--force-yes
Supone una respuesta afirmativa a todas las preguntas. Esta es una
opcion peligrosa que hara que apt continue sin preguntar incluso si
se va a realizar algo potencialmente peligroso. No se debe usar
excepto en situaciones muy especiales. iUsar force-yes puede
destruir su sistema! Opcion de configuracion: APT::Get::force-yes.
--print-uris
Muestra las URI de los ficheros a instalar en vez de descargarlos.
Cada URI contiene la direccion de donde se obtendra el paquete, el
fichero de destino, su tamano y el resumen MD5 esperado. Tenga en
cuenta que el nombre de fichero no siempre coincide con el nombre
del fichero en el sitio remoto. Esto tambien funciona con las
ordenes source y update. Cuando se usa con la orden update no se
incluyen ni el resumen MD5 ni el tamano, y es tarea del usuario
descomprimir cualquier fichero comprimido. Opcion de configuracion:
APT::Get::Print-URIs.
--purge
Usa <<purge>> (purgar) en lugar de <<remove>> para todo aquello que
se desinstale. Un asterisco (<<*>>) aparecera a continuacion de los
paquetes que se vayan a purgar. remove --purge es equivalente a la
orden purge. Opcion de configuracion: APT::Get::Purge.
--reinstall
Reinstala los paquetes ya instalados, incluso si son la ultima
version disponible del paquete. Opcion de configuracion:
APT::Get::ReInstall.
--list-cleanup
Esta opcion esta activada de forma predeterminada, si quiere
desactivarla use --no-list-cleanup. Cuando esta activada apt-get
administrara automaticamente los contenidos de /var/lib/apt/lists
para asegurarse de que se borran los ficheros obsoletos. La unica
razon para desactivarla es si realiza frecuentemente cambios en la
lista de fuentes. Opcion de configuracion: APT::Get::List-Cleanup.
-t, --target-release, --default-release
Esta opcion controla la entrada predeterminada del motor de
directrices, creando un anclaje (<<pin>>) con una prioridad 990
usando la cadena de caracteres de la distribucion especificada.
Esto invalida la configuracion general de /etc/apt/preferences.
Aquellos paquetes con un anclaje especifico no se veran afectados
por el valor de esta opcion. Resumiendo, esta opcion le da control
sobre la distribucion de la que se obtienen los paquetes. Algunos
ejemplos comunes pueden ser -t '2.1*' o -t unstable o -t sid.
Opcion de configuracion: APT::Default-Release. Vea tambien la
pagina del manual de apt_preferences(5).
--trivial-only
Solo realiza acciones consideradas <<triviales>>. Esta opcion esta
relacionada con --assume-yes de modo que donde --assume-yes
responde afirmativamente a cualquier pregunta, --trivial-only
respondera negativamente. Opcion de configuracion:
APT::Get::Trivial-Only.
--no-remove
Si se va a desinstalar algun paquete, apt-get terminara
inmediatamente sin preguntar. Opcion de configuracion:
APT::Get::Remove
--auto-remove
Si la orden es install o remove, esta opcion se ejecutara como
autoremove, eliminando los paquetes que son dependencia de otro,
pero que esten en desuso. Opcion de configuracion:
APT::Get::AutomaticRemove.
--only-source
Solo tiene sentido para las ordenes source y build-dep. Indica que
los nombres de paquetes fuente proporcionados no se deben tratar a
traves de la tabla de binarios. Esto significa que si se especifica
esta opcion, estas ordenes solo aceptaran como argumento nombres de
paquetes fuente, en vez de aceptar nombres de paquetes binarios,
para luego buscar el nombre del paquete fuente correspondiente.
Opcion de configuracion: APT::Get::Only-Source
--diff-only, --dsc-only, --tar-only
Descarga solo el fichero diff, dsc o tar del archivo de fuentes.
Opciones de configuracion: APT::Get::Diff-Only, APT::Get::Dsc-Only
y APT::Get::Tar-Only.
--arch-only
Procesa solo las dependencias de construccion dependientes de la
arquitectura. Opcion de configuracion: APT::Get::Arch-Only
--allow-unauthenticated
Ignora si los paquetes no se pueden autenticar, sin generar ningun
dialogo sobre ello. Esto es util para herramientas como pbuilder.
Opcion de configuracion: APT::Get::AllowUnauthenticated.
-h, --help
Muestra un mensaje corto sobre el uso.
-v, --version
Muestra la version del programa.
-c, --config-file
Fichero de configuracion: Especifica el fichero de configuracion a
usar. El programa leera el fichero de configuracion predeterminado
y, despues, este fichero de configuracion. Si necesita que ciertas
opciones de configuracion se definan antes que el analisis de los
de los ficheros de configuracion predeterminados, defina un fichero
con la variable de entorno APT_CONFIG. Consulte apt.conf(5) para
informacion sobre la sintaxis.
-o, --option
Define una opcion de configuracion: Esto definira una opcion
arbitraria de configuracion. 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 donde conseguir los paquetes. Opcion de
configuracion: Dir::Etc::SourceList.
/etc/apt/sources.list.d/
Fragmentos de fichero para las ubicaciones de donde descargar los
paquetes. Opcion de configuracion: Dir::Etc::SourceParts.
/etc/apt/apt.conf
Fichero de configuracion de APT. Opcion de configuracion:
Dir::Etc::Main.
/etc/apt/apt.conf.d/
Fragmentos del fichero de configuracion de APT. Opcion de
configuracion: Dir::Etc::Parts.
/etc/apt/preferences
Ficheros de preferencias de version. Aqui puede especificar el
anclaje ("pinning"), una preferencia para conseguir ciertos
paquetes a partir de una fuente diferente o de una version
diferente de una distribucion. Opcion de configuracion:
Dir::Etc::Preferences.
/etc/apt/preferences.d/
Fragmentos de fichero para las preferencias de la version. Opcion
de configuracion: Dir::Etc::PreferencesParts.
/var/cache/apt/archives/
Area de almacenamiento para los ficheros de paquetes descargados.
Opcion de configuracion: Dir::Cache::Archives.
/var/cache/apt/archives/partial/
Area de almacenamiento para los ficheros de paquete en transito.
Opcion de configuracion: Dir::Cache::Archives (parcialmente
implicito).
/var/lib/apt/lists/
Area de almacenamiento para la informacion del estado de cada
fuente de paquetes especificado en sources.list(5) Opcion de
configuracion: Dir::State::Lists.
/var/lib/apt/lists/partial/
Area de almacenamiento para la informacion del estado en transito.
Opcion de configuracion: Dir::State::Lists (parcialmente
implicito).
V'eASE TAMBI'eN
apt-cache(8), apt-cdrom(8), dpkg(1), dselect(1), sources.list(5),
apt.conf(5), apt-config(8), apt-secure(8), la guia de usuario de APT en
/usr/share/doc/apt-doc/, apt_preferences(5), el Como de APT.
DIAGN'oSTICOS
apt-get devuelve cero si no hay ningun error, y el valor 100 en caso de
error.
AUTORES ORIGINALES
Jason Gunthorpe
AUTORES ACTUALES
Equipo de APT
P'agina de QA[3]
BUGS
P'agina de errores de APT[4]. Si quiere informar de un error en APT,
consulte /usr/share/doc/debian/bug-reporting.txt o use la orden
reportbug(1).
TRADUCCI'ON
La traduccion al espanol la realizaron Ismael Fanlo, Carlos Mestre,
Rudy Godoy, Gustavo Saldumbide, Javier Fernandez-Sanguino y Ruben
Porras Campo entre los anos 2003 y 2004. La traduccion fue actualizada
por Francisco Javier Cuadrado y Omar Campagne Polaino entre los anos
2009 y 2010.
Tenga en cuenta que este documento puede contener secciones sin
traducir. Esto es intencionado para evitar perder contenido cuando la
traduccion no esta actualizada con respecto al documento original.
AUTHORS
Jason Gunthorpe
Equipo de APT
NOTES
1. http://packages.debian.org/changelogs
2. http://changelogs.ubuntu.com/changelogs
3. Pagina de QA
http://packages.qa.debian.org/a/apt.html
4. Pagina de errores de APT
http://bugs.debian.org/src:apt