NOMBRE¶
apt-src - gestiona árboles de paquetes fuentes de Debian
SINOPSIS¶
apt-src [
opciones]
orden
apt-src [
opciones]
install|remove paq1 [paq2 ...]
apt-src localización paq
DESCRIPCIÓN¶
apt-src es una interfaz de línea de órdenes para descargar, instalar,
actualizar, y seguir los paquetes fuentes de Debian. Puede ejecutarse como
usuario normal o como superusuario.
A diferencia de los paquetes binarios, los paquetes fuentes no se instalan en un
lugar canónico. En lugar de esto, se "instalan" desempaquetando
el árbol de las fuentes en un directorio, el cual puede estar donde
desee. Un paquete fuente puede instalarse varias veces en diferentes lugares.
Este programa gestiona los paquetes fuentes instalados de este modo, y
proporciona facilidades de búsqueda para encontrar donde fue instalado un
determinado paquete.
A menos que se proporcione la opción -h o --help se debe de proporcionar
una de los siguientes órdenes.
- update
- Actualiza la lista de paquetes disponibles. Idéntico
que apt-get update, debe ejecutarse como superusuario en su
configuración predeterminada.
- install
- Instala los paquetes fuentes nombrados en el directorio
actual. Si un paquete ya está instalado en el directorio actual,
intentará actualizarlo.
Esta orden aceptará el nombre de paquetes binarios o paquetes fuentes.
Igual que con apt-get install, puede usar como prefijo del nombre
=versión o /distribución para especificar la versión que
quiere instalar o de que distribución desea obtenerla.
Se asegurará de que las dependencias de construcción del paquete
se satisfacen.
Si se proporciona la opción --location, el paquete fuente se
instalará o actualizará en el lugar indicado en vez de en el
directorio actual.
Si se proporciona la opción --build, se compilará cada paquete
instalado o actualizado.
- upgrade
- Actualiza todos los paquetes fuentes instalados, o, si se
proporcionan las opciones --location o --here, sólo se
actualizarán los paquetes fuentes del directorio especificado.
Si se proporciona la opción --patch (por omisión), apt-src
intentará generar un parche que contenga todos los cambios locales
hechos al paquete fuente, y los aplicará al árbol actualizado.
Esto permite que los cambios locales se preserven a través de las
actualizaciones de los paquetes, pero es posible que no siempre funcione,
en estos casos deberá combinar los cambios usted mismo.
Si se proporciona la opción --build, se compilará cada paquete
instalado o actualizado.
- remove
- Elimina los paquetes fuentes nombrados. Se pueden usar las
opciones --location y --here para eliminar sólo los paquetes de un
directorio determinado.
- build
- Construye las fuentes especificadas. Si el paquete fuente
no está instalado, se instalará primero.
- clean
- Limpia el árbol de los paquetes fuentes listados. Se
pueden usar las opciones --location y --here para limpiar sólo los
paquetes de un determinado directorio.
- import
- Use esta opción para hacerle saber a apt-src acerca de
un paquete fuente ya desempaquetado. Después del nombre bajo el que
será importado debe especificar la localización del árbol
con las fuentes (con --location), y puede especificar la versión (con
--version). No espere que la orden build funcione en estas fuentes, a
menos que tengan un directorio debian/.
- list
- Sin ningún otro parámetro, listará todos los
paquetes fuentes instalados, su estado, y el directorio donde fueron
instalados. Si se proporciona el nombre de un paquete, mostrará
sólo los ejemplares instalados de ese paquete fuente. Si se usan las
opciones --location o --here, limitarán la lista de paquetes a los
instalados en el directorio especificado.
- location
- Sólo acepta un parámetro, el nombre del paquete
fuente. Si el paquete está instalado, devolverá el directorio
raíz del árbol de las fuentes del paquete.
Esta orden puede usarse cuando necesite incluir ficheros de otro paquete
fuente, o algo por el estilo. Por ejemplo:
-I`apt-src location paquete`
- version
- Sólo acepta un parámetro, el nombre del paquete
fuente. Si el paquete está instalado devuelve la versión del
paquete.
- name
- Sólo acepta un parámetro, el nombre del paquete
fuente (puede especificarse con expresiones regulares). Devuelve el nombre
del paquete fuente que concuerde con el nombre, si es que hay alguno.
OPCIONES¶
Todas las opciones de la línea de órdenes pueden incluirse en el
fichero de configuración. Las descripciones indican la opción que es
necesario emplear. Para opciones booleanas puede modificar el comportamiento
usando algo como -f-,--no-f, -f=no o alguna que otra variante.
- -h, --help
- Muestra este texto de ayuda.
- -b, --build, --compile
- Construye los paquetes fuentes después de instalarlos
o actualizarlos. Opción de configuración:
APT::Src::Compile.
- -i, --installdebs
- Instala los paquetes después de construirlos. Implica
--build. Opción de configuración: APT::Src::InstallDebs
Note que si un paquete fuente genera varios binarios, todos se
instalarán.
- -p, --patch
- Trata de parchear los cambios locales en el nuevo
árbol después de actualizar. Habilitado por omisión, use
--no-p para deshabilitarlo. Opción de configuración:
APT::Src::Patch.
- -l, --location
- Especifica un directorio, sólo opera en paquetes en
ese directorio. Opción de configuración:
APT::Src::Location.
- -c, --cwd, --here
- Sólo operan sobre paquetes en el directorio actual.
Opción de configuración: APT::Src::Here.
- --upstream-version
- Sólo tiene utilidad con la orden version, hace que
omita la versión de Debian de la salida de la versión del
paquete.
- -k, --keep-built
- No borra los .debs y otros ficheros contruídos
después de instalarlos con la opción --installdebs. Opción
de configuración: APT::Src::KeepBuilt
- -n, --no-delete-source
- No borra los ficheros fuentes cuando se elimine el paquete
fuente. Opción de configuración: APT::Src:NoDeleteSource
- --version
- Especifica una versión del árbol de las fuentes.
Se usa junto con la orden import.
- -q, --quiet
- Dirije todo salida de la orden a /dev/null a menos que la
orden no se ejecute como era de esperar. Opción de
configuración: APT::Src::Quiet
- -t, --trace
- Muestra todas las órdenes que ejecuta. Opción de
configuración: APT::Src::Trace
Además de las opciones anteriores, algunas opciones de configuración
menos usadas sólo pueden especificarse en los ficheros de
configuración, /etc/apt/apt.conf y ~/.apt-src/config. Éstas son:
- APT::Src::BuildCommand
- La orden a usar para construir el árbol. Se ejecuta en
el árbol a construir, por omisión es "dpkg-buildpackage -b
-us -uc", con "-rfakeroot" añadido para los usuarios
distintos del superusuario.
- APT::Src::RootCommand
- La orden a usar si un usuario necesita convertirse en
superusuario. Se usa, por ejemplo, para satisfacer dependencias de
construcción. "sudo" es una buena elección, es el
comportamiento predeterminado. Si quiere usar "su",
necesitará establecerlo a "su -c".
- APT::Src::BuildDeps
- Controla si apt-src se asegura de que las dependencias de
construcción de un paquete se satisfacen al instalar o actualizar el
paquete. Por omisión está habilitado, si lo deshabilita, es
posible que los paquetes no se puedan construir debido a la falta de las
dependencias de contrucción.
NOTA SOBRE LOS NOMBRES¶
Puede usar el nombre del paquete binario o del paquete fuente cuando desee
instalar un nuevo paquete fuente.
El resto del tiempo, cuando los paquetes ya estén instalados, tiene que
usar el nombre del paquete fuente (es posible que esto cambie en un futuro).
Sin embargo, puede usar expresiones regulares como parte de los nombres.
ENTORNO¶
Este programa establece APT_SRC_BUILD cuando contruye un paquete.
EJEMPLOS¶
Para instalar las fuentes de pine en /usr/src, construirlo, e instalar los debs
resultantes:
apt-src install --location=/usr/src -i pine
Para seguir los cambios del paquete fuente pine, e instalar los debs cuando
halla una nueva versión disponible:
apt-src install -i pine
Para instalar una copia local del paquete tal, al que va a aplicar un parche
local:
apt-src install tal
cd tal-version
patch <~/mi-parche-para-tal
apt-src build --installdebs tal
Para actualizar su copia local de tal, manteniendo su parche, constuirlo, e
instalar los nuevos debs:
apt-src install -i tal
Para importar el árbol de fuentes en /usr/src/linux, que puede haber sido
desempaquetado de un tar de ftp.kernel.org (o desde el paquete kernel-source)
en apt-src, de forma que éste pase a saber de su existencia:
apt-src import kernel --location=/usr/src/linux --version=2.4.18
En un debian/rules de un paquete de módulos del núcleo que necesite
saber si está siendo construido por apt-src, y si es así establecer
las variables KVERS, KSRC. y KDREV que normalmente establece make-kpkg:
ifdef APT_SRC_BUILD
KDREV=$(shell apt-src version kernel\(-source.\*\)\?)
KSRC=$(shell apt-src location kernel\(-source.\*\)\?)
KVERS=$(shell apt-src name kernel\(-source.\*\)\? | sed s/kernel-source-//)
endif
FICHEROS¶
- /etc/apt/sources.list
- Contiene los lugares de dónde descarga los
paquetes.
- ~/.apt-src/status
- El fichero de estado de apt-src, contiene los paquetes
instalados.
- /etc/apt/apt.conf
- Fichero de configuración global de apt-src (y
apt).
- ~/.apt-src/config
- Fichero de configuración de apt-src para cada
usuario.
VÉASE ADEMÁS¶
apt-get(8),
sources.list(5),
dpkg-source(1)
AUTOR¶
Copyright 2002 Joey Hess <joeyh@debian.org>
Esto es software libre; lea la Licencia Pública General de GNU versión
2 o posterior para las condiciones de copia. NO hay ninguna garantía.
TRADUCTOR¶
Traducción de Rubén Porras Campo
<debian-l10n-spanish@lists.debian.org>