Linux Certif

Toute la documentation sur la certification Linux LPI

dpkg

NOMBRE

dpkg - Gestor de paquetes Debian de medio nivel

SINOPSIS

dpkg [opciones] acci�n

AVISO

El prop�sito de este manual es que los usuarios entiendan las opciones de llamada de dpkg y los estados en los que puede estar un paquete con algo m�s de precisi�n que la dada por dpkg --help.

No deber�an usarlo los encargados de paquetes para comprender el proceso de instalaci�n. Las descripciones de lo que hace este programa al instalar y desinstalar simplemente no son apropiadas.

DESCRIPCI�N

dpkg es una herramienta de nivel medio para instalar, construir, borrar y gestionar los paquetes de Debian GNU/Linux. Se llama con par�metros desde l�nea de �rdenes, especificando una acci�n y cero o m�s opciones. La acci�n dice a dpkg qu� hacer y las opciones controlan de alguna manera su comportamiento.

Tambi�n se puede usar dkpg como interfaz a dpkg-deb. Si aqu�l se encuentra alguna de las opciones de �ste, se limita a llamarlo con esas mismas opciones. La lista de opciones de dpkg-deb es:

     -b, --build,
     -c, --contents,
     -I, --info,
     -f, --field,
     -e, --control,
     -x, --extract,
     -X, --vextract, and
     --fsys-tarfile.
 

Lea dpkg-deb(1) si desea m�s informaci�n sobre estas acciones.

Nota: La interfaz de dpkg principal y m�s sencilla de usar es dselect(8). Tambi�n hay otras, como las basadas en apt(8).

INFORMACI�N SOBRE PAQUETES

Hay bastante informaci�n �til sobre los paquetes disponibles accesible a trav�s de dpkg. Esta informaci�n se divide en tres clases: estados, estados de selecci�n e indicadores. Te�ricamente, estos valores se cambiar�n principalmente con dselect.

ESTADOS DE LOS PAQUETES

installed

Bien desempaquetado y configurado.

half-installed

Se inici� la instalaci�n del paquete, pero no se complet� por alguna raz�n.

not-installed

No est� instalado en el sistema.

unpacked

Descomprimido, pero no configurado.

half-configured

El paquete est� descomprimido y la configuraci�n se inici�, pero no se termin� por alguna raz�n.

config-files

S�lo quedan los ficheros de configuraci�n del paquete en el sistema.

ESTADOS DE SELECCI�N DE LOS PAQUETES

install

El paquete se ha seleccionado para instalarse.

deinstall

El paquete se ha seleccionado para desinstalarse (es decir, que queremos borrarlo todo excepto los ficheros de configuraci�n).

purge

El paquete se ha seleccionado para purgarse (es decir, que queremos borrarlo todo, incluso los ficheros de configuraci�n).

INDICADORES DE LOS PAQUETES

hold

Un paquete marcado como hold no es modificado por dpkg, a no ser que lo forcemos a hacerlo con la opci�n --force-hold.

reinst-required

Un paquete marcado como necesita-reinst est� roto y necesita reinstalarse. Estos paquetes no pueden borrarse, a no ser que se fuerce la acci�n con la opci�n --force-remove-reinstreq.

ACCIONES

dpkg -i | --install fichero_paquete...

Instala el paquete. Si se especifica la opci�n --recursive o -R, fichero_paquete debe ser un directorio.

La instalaci�n consiste en los siguientes pasos:
1. Se extraen los ficheros de control del paquete.
2. Si hay instalada otra versi�n del mismo paquete, se ejecuta el programa prerm del antiguo paquete.
3. Se ejecuta el programa preinst, si el paquete lo tiene.
4. Se desempaquetan los nuevos ficheros, y al mismo tiempo se hace una copia de seguridad de los antiguos, para que, si algo va mal, se puedan restaurar.
5. Si hab�a instalada otra versi�n del mismo paquete, se ejecuta el postrm del paquete antiguo. Tenga en cuenta que este programa se ejecuta despu�s del preinst del nuevo paquete, ya que los nuevos ficheros se escriben a la vez que se borran los antiguos.
6. Se configura el paquete. Si quiere informaci�n detallada sobre el proceso, vea --configure.

dpkg --unpack fichero_paquete ...

Desempaqueta el fichero, pero no lo configura. Si se dan las opciones --recursive o -R, fichero_paquete debe referirse a un directorio.

dpkg --configure paquete ... | -a | --pending

Vuelve a configurar un paquete que, al menos, est� desempaquetado. Si se dan las opciones -a o --pending en vez de paquete, se configuran todos los paquetes no configurados.

La configuraci�n consiste en los siguientes pasos:
1. Se desempaquetan los ficheros de configuraci�n, y al mismo tiempo se hace una copia de seguridad de los antiguos, para que puedan restaurarse si algo va mal.
2. Se ejecuta el programa postinst, si el paquete lo tiene.

dpkg -r | --remove | -P | --purge paquete ... | -a | --pending

Borra un paquete instalado. Las opciones -r y --remove lo borran todo excepto los ficheros de configuraci�n. Esto podr�a evitar tener que configurar de nuevo el paquete si se reinstala despu�s (los ficheros de configuraci�n son los listados en el fichero de control debian/conffiles). Si se usan las opciones -a y --pending en vez de un paquete, todos los que est�n al menos desempaquetados, pero marcados para borrar o purgar en /var/lib/dpkg/status, se borran o purgan respectivamente.

Borrar un paquete consiste de los siguientes pasos:
1. Ejecutar el programa prerm.
2. Borrar los ficheros instalados.
3. Ejecutar el programa postrm.

dpkg --update-avail | --merge-avail fichero-Packages

Actualiza la lista de paquetes disponibles de dpkg y dselect. Con la acci�n --merge-avail, la informaci�n antigua se combina con la informaci�n de fichero-Packages. El fichero-Packages que viene con Debian GNU/Linux se llama simplemente Packages. El programa dpkg guarda la lista de paquetes disponibles en /var/lib/dpkg/available.

Una orden m�s simple que permite obtener y actualizar el fichero available de una tirada es dselect update.

dpkg -A | --record-avail fichero_paquete ...

Actualiza la idea que tienen dpkg y dselect de qu� paquetes est�n disponibles, con informaci�n del paquete fichero_paquete. Si se usa --recursive o -R, fichero_paquete debe ser un directorio.

dpkg --forget-old-unavail

Olvida los paquetes no instalados ni disponibles.

dpkg --clear-avail

Borra la informaci�n sobre los paquetes disponibles.

dpkg -C | --audit

Busca paquetes que se hayan instalado s�lo parcialmente. El programa dpkg sugerir� qu� hacer con ellos para hacerlos funcionar.

dpkg --get-selections [patr�n...]

Muestra la lista de selecciones de paquetes en la salida est�ndar.

dpkg --set-selections

Establece las selecciones a unas determinadas, leyendo de la entrada est�ndar.

dpkg --yet-to-unpack

Busca los paquetes seleccionados para instalar, pero que por alguna raz�n todav�a no se han instalado.

dpkg --print-architecture

Imprime la arquitectura de destino (por ejemplo, �i386�). Esta opci�n usa a gcc.

dpkg --print-gnu-build-architecture

Imprime la versi�n GNU de la arquitectura de destino (por ejemplo, �i486�).

dpkg --print-installation-architecture

Imprime la arquitectura de origen de instalaci�n.

dpkg --compare-versions ver1 op ver2

Compara n�meros de versi�n, donde op es un operador binario. Devuelve �xito (cero) si la condici�n especificada se cumple, y fallo (resultado distinto de cero) si no. Hay dos grupos de operadores, que difieren en c�mo se comportan cuando les falta alguno de los operandos. Los primeros tratan la falta de versi�n como la versi�n m�s antigua posible: lt le eq ne ge gt. Los otros tratan la falta de versi�n como la m�s moderna posible: lt-nl le-nl ge-nl gt-nl. �stos se dan s�lo por compatibilidad con la sintaxis del fichero de control: < << <= = >= >> >.

dpkg --command-fd <n>

Acepta una serie de �rdenes en el fichero cuyo descriptor es <n>. Aviso: las opciones adicionales pasadas desde la l�nea de �rdenes y mediante este descriptor de fichero no se desactivan en las subsiguientes llamadas efectuadas en la misma ejecuci�n.

dpkg --help

Muestra las instrucciones de uso.

dpkg --force-help

Muestra la ayuda de las opciones --force-algo.

dpkg -Dh | --debug=help

Muestra la ayuda de las opciones de depuraci�n.

dpkg --licence | dpkg --license

Muestra la licencia e informaci�n sobre derechos de autor de dpkg.

dpkg --version

Muestra la versi�n de dpkg.

dpkg-deb-actions

Ver dpkg-dev(1) para m�s informaci�n sobre las siguientes acciones.

 dpkg -b | --build directorio [fichero]
     Construye un paquete Debian GNU/Linux.
 dpkg -c | --contents fichero
     Muestra el contenidos de un paquete Debian GNU/Linux.
 dpkg -e | --control fichero [directorio]
     Extrae la informaci�n de control de un paquete.
 dpkg -x | --extract fichero directorio
     Extrae los ficheros contenidos en el paquete.
 dpkg -f | --field  fichero [campo-control] ...
     Muestra el/los campo(s) de control de un paquete.
 dpkg --fsys-tarfile fichero
     Muestra el fichero tar contenido en el paquete Debian.
 dpkg -I | --info fichero [fichero-control]
     Muestra informaci�n sobre el paquete.
 dpkg -X | --vextract fichero directorio
     Extrae y muestra los nombres de ficheros contenidos en un paquete.
 

dpkg-query-actions

Vea dpkg-query(1) para m�s informaci�n sobre las siguientes acciones:

 
 dpkg -l | --list patr�n-nombre-paquete ...
     Lista los paquetes cuyo nombre encaja en el patr�n dado.
 dpkg -s | --status nombre-paquete ...
     Informa del estado del paquete especificado.
 dpkg -L | --listfiles paquete ...
     Lista los ficheros instalados en el sistema, que pertenecen a paquete.
 dpkg -S | --search patr�n-b�squeda-ficheros ...
     Busca un fichero en los paquetes instalados.
 dpkg -p | --print-avail paquete ...
     Imprime informaci�n sobre el paquete, sacada de /var/lib/dpkg/available.
 

OPCIONES

Todas las opciones pueden especificarse tanto en l�nea de �rdenes como en el fichero de configuraci�n de dpkg, /etc/dpkg/dpkg.cfg. Cada l�nea de este fichero es bien una opci�n (exactamente la misma que la de l�nea de �rdenes, pero sin los guiones al principio) o bien un comentario (si empieza con #).

--abort-after=n�mero

Cambiar despu�s de cu�ntos errores abortar� dpkg. El valor por omisi�n es 50.

-B|--auto-deconfigure

Cuando se borra un paquete, hay posibilidades de que otro dependa de �l. Especificar esta opci�n producir� la desconfiguraci�n autom�tica del paquete que depend�a del borrado.

-Doctal | --debug=octal

Activar el modo de depuraci�n. El par�metro octal se forma uniendo los valores de la siguiente lista mediante la operaci�n or a nivel de bits (tenga en cuenta que estos valores podr�an cambiar en futuras versiones). -Dh o --debug=help muestran estos valores.

 n�mero  descripci�n
    1   Informaci�n de progreso generalmente �til
    2   Invocaci�n y estado de los scripts del paquete
   10   Salida por cada fichero procesado
  100   Mucha salida por cada fichero procesado
   20   Salida por cada conffile
  200   Mucha salida por cada conffile
   40   Dependencias y conflictos
  400   Mucha salida sobre dependencias y conflictos
 1000   Parrafadas sobre el directorio dpkg/info
 2000   Monta�as de parrafadas (perjudica la salud)

--force-cosas | --no-force-cosas | --refuse-cosas

Fuerza o rehusa (no-force y refuse significan lo mismo) a hacer ciertas cosas. El par�metro cosas es una lista de cosas especificadas abajo, separada por comas. La opci�n --force-help muestra un mensaje que las describe. Las cosas marcadas con (*) se fuerzan por omisi�n.

Aviso: Estas opciones est�n pensadas mayormente para que las usen expertos. Usarlas sin total conocimiento de sus efectos podr�an hacer que su sistema dejara de funcionar.
all: Activa (o desactiva) todas las opciones de forzar.
auto-select(*): Selecciona paquetes para instalarlos, y quita la selecci�n a paquetes para borrarlos.
downgrade(*): Instala un paquete, incluso si hay una versi�n m�s nueva ya instalada.

Aviso: actualmente dpkg no comprueba de ninguna manera las dependencias al desactualizar y por lo tanto no avisar� si se rompe alguna dependencia de otro paquete. Una situaci�n as� podr�a tener efectos laterales graves; desactualizar componentes esenciales del sistema incluso podr�a inutilizar su sistema completo. �selo con cuidado.

configure-any: Configura tambi�n todo lo desempaquetado y no configurado sobre lo que depende el paquete.
hold: Procesa los paquetes incluso si est�n marcados como �hold� (mantener).
remove-reinstreq: Borra un paquete, incluso si est� roto y marcado como de reinstalaci�n requerida. Esto podr�a causar, por ejemplo, que algunas partes del paquete quedaran en el sistema, pero dpkg se olvidara de ellas.
remove-essential: Borra, incluso si el paquete se considera esencial. Los paquetes esenciales contienen sobre todo �rdenes de Unix muy b�sicas. Borrarlos podr�a hacer que el sistema dejara de funcionar en absoluto, as� que use esta opci�n con cuidado.
depends: Convierte todos los problemas de dependencias en avisos.
depends-version: No tiene en cuenta las versiones al comprobar dependencias.
conflicts: Instala, incluso si est� en conflicto con otro paquete. Esta opci�n es peligrosa, dado que generalmente sobreescribir� algunos ficheros.
confmiss: Siempre instala un fichero de configuraci�n perdido. Es peligroso porque no guarda los cambios (el borrado) hechos al fichero.
confnew: Si se ha modificado un fichero de configuraci�n, instalar siempre la nueva versi�n sin preguntar, a menos que se especifique tambi�n la opci�n --force-confdef, en cuyo caso se toma la acci�n por omisi�n.
confold: Si se ha modificado un fichero de configuraci�n, mantener siempre la versi�n existente sin preguntar, a menos que tambi�n se especifique la opci�n --force-confdef, en cuyo caso se toma la acci�n por omisi�n.
confdef: Si se ha modificado un fichero de configuraci�n, elegir siempre la opci�n por omisi�n. Si no la hay, parar� y preguntar� al usuario a no ser que se usen tambi�n las opciones --force-confnew o --force-confold, en cuyo caso se usar� esta opci�n para tomar la decisi�n final.
overwrite: Sobreescribe un fichero de un paquete con otro fichero.
overwrite-dir: Sobreescribe un directorio de un paquete con otro fichero.
overwrite-diverted: Sobreescribe una versi�n desviada de un fichero con una no desviada.
architecture: Procesar incluso si los paquetes no son de la arquitectura adecuada.
bad-path: PATH no contiene algunos programas importantes, as� que es bastante posible que haya problemas.
not-root: Intentar la (des)instalaci�n incluso si no se es root.
bad-verify: Instala un paquete incluso si falla la comprobaci�n de autenticidad.

--ignore-depends=paquete,...

Ignora la comprobaci�n de dependencias para los paquetes especificados (realmente, se hacen las comprobaciones, pero se imprimen avisos en vez de abortar el proceso).

--new | --old

elige el formato de paquetes nuevo o antiguo. Es una opci�n de dpkg-deb(1).

--nocheck

No lee ni comprueba el contenido del fichero de control mientras se construye el paquete. Es una opci�n de dpkg-deb(1).

--no-act | --dry-run | --simulate

Hace todo lo que se supone que debe hacer, pero no realiza ning�n cambio. Se utiliza para ver qu� ocurrir�a con las opciones elegidas sin llegar a cambiar nada.

Aseg�rese de dar la opci�n --no-act antes del par�metro de acci�n, o podr�a acabar con resultados no deseados. P.ej.: dpkg --purge foo --no-act primero purgar� el paquete foo y luego intentar� purgar el paquete --no-act, �aunque probablemente usted esperara que no hiciera nada!).

-R | --recursive

Act�a recursivamente sobre todos los ficheros que coincidan con el patr�n *.deb que se encuentren en el directorio especificado y todos sus subdirectorios. Puede usarse con las opciones -i, -A, --install, --unpack y --avail.

-G

No instala un paquete del que hay ya instalada una versi�n m�s nueva. Es lo mismo que --refuse-downgrade.

--root=dir | --admindir=dir | --instdir=dir

Cambia los directorios por omisi�n. El valor predeterminado para el directorio admindir es /var/lib/dpkg y contiene muchos ficheros con informaci�n sobre el estado de los paquetes instalados y desinstalados, etc. El valor por omisi�n de instdir es / y se refiere al directorio donde se instalar�n los paquetes. Tambi�n es el directorio pasado a chroot(2) antes de ejecutar los programas de instalaci�n de paquete, lo que significa que �stos ver�n instdir como directorio ra�z. Cambiar root cambia a su vez instdir a dir y admindir a dir/var/lib/dpkg.

-O | --selected-only

Procesa s�lo los paquetes que se han elegido para la instalaci�n. La marca en s� la hacen dselect o dpkg, cuando se usa para gestionar paquetes. Por ejemplo, si se borra uno, se marcar� como elegido para desinstalar.

-E | --skip-same-version

Evita la instalaci�n de un paquete si es la misma versi�n que ya hay instalada.

--status-fd <n>

Env�a el estado del paquete al descriptor de fichero <n>. Puede usarse varias veces. Las actualizaciones de estado tienen la forma �status: <pkg>: <pkg qstate>�.

FICHEROS

/etc/dpkg/dpkg.cfg

Fichero de configuraci�n con las opciones por omisi�n.

Los otros ficheros listados abajo est�n en sus directorios por omisi�n. V�ase la opci�n --admindir para ver c�mo cambiar la ruta de estos ficheros.

/var/lib/dpkg/available

Lista de paquetes disponibles.

/var/lib/dpkg/status

Estado de los paquetes disponibles. Este fichero contiene informaci�n sobre si un paquete est� marcado para borrar o no, si est� instalado o no, etc. V�ase el apartado INFORMACI�N SOBRE PAQUETES para m�s informaci�n.

Los siguientes ficheros son componentes de un paquete binario. V�ase deb(5) para m�s informaci�n sobre �stos:

control

conffiles

preinst

postinst

prerm

postrm

VARIABLES DE ENTORNO

DPKG_NO_TSTP

Defina esta variable si prefiere que dpkg arranque en un int�rprete diferente en vez de suspenderse a s� mismo cuando vuelve temporalmente al int�rprete de �rdenes.

SHELL

El programa que ejecutar� dpkg cuando arranque el nuevo int�rprete.

COLUMNS

Especifica el n�mero de columnas que puede usar dpkg para mostrar la informaci�n. Por ahora s�lo la usa la opci�n -l.

EJEMPLOS

Para listar los paquetes con �vi� en su nombre:
dpkg -l '*vi*'

Para ver las entradas en /var/lib/dpkg/available de varios paquetes:
dpkg -p base-files login xfree86-common | pager

Para borrar un paquete instalado llamado �elvis�:
dpkg -r elvis

Para instalar un paquete, primero hay que encontrarlo en la colecci�n de paquetes que queramos. El fichero �available� muestra que el paquete �vim� est� en el apartado �editors�:
cd /cdrom/hamm/hamm/binary/editors dpkg -i vim_4.5-3.deb
(Nota: En estos casos suele usarse apt-get(8))

Para hacer una copia local de los estados de la selecci�n de paquetes:
dpkg --get-selections >mis_selecciones

Se podr�a copiar este fichero a otra m�quina e instalarlo all� con:
dpkg --set-selections <mis_selecciones
Tenga en cuenta que esto no instalar� ni borrar� nada, simplemente modificar� el estado de selecci�n de los paquetes escogidos. Necesitar� otra aplicaci�n para conseguir los paquetes e instalarlos. Por ejemplo, ejecute dselect y elija �Instalar�.

Por lo general, encontrar� que dselect(8) es una forma m�s c�moda de modificar los estados de selecci�n de los paquetes.

FUNCIONALIDAD ADICIONAL

Se puede ganar funcionalidad adicional instalando alguno de los siguientes paquetes: apt, aptitude and debsums.

V�ASE TAMBI�N

dselect(8), dpkg-deb(1), deb(5), deb-control(5), y dpkg-reconfigure(8).

FALLOS/RESTRICCIONES

dpkg no ordena inteligentemente los paquetes a la hora de instalarlos.
No hay ning�n sistema autom�tico de registro de actividades en dpkg.
Durante las actualizaciones, las relaciones de los paquetes que dependen de otros se podr�an desincronizar (p.ej.: las dependencias exactas de la versi�n de desarrollo de un paquete sobre el propio paquete).

Normalmente, la opci�n --no-act da menos informaci�n de la que necesita.
No hay informaci�n de estado para los paquetes virtuales.

AUTORES

 El programador original de dpkg fue Ian Jackson, y luego mucha gente fue
 mejor�ndolo. La lista completa est� en /usr/share/doc/dpkg/THANKS.gz.
 Traducci�n realizada por Esteban Manchado Vel�zquez (zoso@demiurgo.org).