apt-src(1) gestiona arboles de paquetes fuentes de Debian

SINOPSIS

apt-src [opciones] orden

apt-src [opciones] install|remove paq1 [paq2 ...]

apt-src localizacion paq

DESCRIPCION

apt-src es una interfaz de linea de ordenes 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 canonico. En lugar de esto, se ``instalan'' desempaquetando el arbol 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 busqueda para encontrar donde fue instalado un determinado paquete.

A menos que se proporcione la opcion -h o --help se debe de proporcionar una de los siguientes ordenes.

update
Actualiza la lista de paquetes disponibles. Identico que apt-get update, debe ejecutarse como superusuario en su configuracion predeterminada.
install
Instala los paquetes fuentes nombrados en el directorio actual. Si un paquete ya esta instalado en el directorio actual, intentara actualizarlo.

Esta orden aceptara el nombre de paquetes binarios o paquetes fuentes. Igual que con apt-get install, puede usar como prefijo del nombre =version o /distribucion para especificar la version que quiere instalar o de que distribucion desea obtenerla.

Se asegurara de que las dependencias de construccion del paquete se satisfacen.

Si se proporciona la opcion --location, el paquete fuente se instalara o actualizara en el lugar indicado en vez de en el directorio actual.

Si se proporciona la opcion --build, se compilara cada paquete instalado o actualizado.

upgrade
Actualiza todos los paquetes fuentes instalados, o, si se proporcionan las opciones --location o --here, solo se actualizaran los paquetes fuentes del directorio especificado.

Si se proporciona la opcion --patch (por omision), apt-src intentara generar un parche que contenga todos los cambios locales hechos al paquete fuente, y los aplicara al arbol actualizado. Esto permite que los cambios locales se preserven a traves de las actualizaciones de los paquetes, pero es posible que no siempre funcione, en estos casos debera combinar los cambios usted mismo.

Si se proporciona la opcion --build, se compilara cada paquete instalado o actualizado.

remove
Elimina los paquetes fuentes nombrados. Se pueden usar las opciones --location y --here para eliminar solo los paquetes de un directorio determinado.
build
Construye las fuentes especificadas. Si el paquete fuente no esta instalado, se instalara primero.
clean
Limpia el arbol de los paquetes fuentes listados. Se pueden usar las opciones --location y --here para limpiar solo los paquetes de un determinado directorio.
import
Use esta opcion para hacerle saber a apt-src acerca de un paquete fuente ya desempaquetado. Despues del nombre bajo el que sera importado debe especificar la localizacion del arbol con las fuentes (con --location), y puede especificar la version (con --version). No espere que la orden build funcione en estas fuentes, a menos que tengan un directorio debian/.
list
Sin ningun otro parametro, listara todos los paquetes fuentes instalados, su estado, y el directorio donde fueron instalados. Si se proporciona el nombre de un paquete, mostrara solo los ejemplares instalados de ese paquete fuente. Si se usan las opciones --location o --here, limitaran la lista de paquetes a los instalados en el directorio especificado.
location
Solo acepta un parametro, el nombre del paquete fuente. Si el paquete esta instalado, devolvera el directorio raiz del arbol 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
Solo acepta un parametro, el nombre del paquete fuente. Si el paquete esta instalado devuelve la version del paquete.
name
Solo acepta un parametro, 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 linea de ordenes pueden incluirse en el fichero de configuracion. Las descripciones indican la opcion 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 despues de instalarlos o actualizarlos. Opcion de configuracion: APT::Src::Compile.
-i, --installdebs
Instala los paquetes despues de construirlos. Implica --build. Opcion de configuracion: APT::Src::InstallDebs

Note que si un paquete fuente genera varios binarios, todos se instalaran.

-p, --patch
Trata de parchear los cambios locales en el nuevo arbol despues de actualizar. Habilitado por omision, use --no-p para deshabilitarlo. Opcion de configuracion: APT::Src::Patch.
-l, --location
Especifica un directorio, solo opera en paquetes en ese directorio. Opcion de configuracion: APT::Src::Location.
-c, --cwd, --here
Solo operan sobre paquetes en el directorio actual. Opcion de configuracion: APT::Src::Here.
--upstream-version
Solo tiene utilidad con la orden version, hace que omita la version de Debian de la salida de la version del paquete.
-k, --keep-built
No borra los .debs y otros ficheros contruidos despues de instalarlos con la opcion --installdebs. Opcion de configuracion: APT::Src::KeepBuilt
-n, --no-delete-source
No borra los ficheros fuentes cuando se elimine el paquete fuente. Opcion de configuracion: APT::Src:NoDeleteSource
--version
Especifica una version del arbol 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. Opcion de configuracion: APT::Src::Quiet
-t, --trace
Muestra todas las ordenes que ejecuta. Opcion de configuracion: APT::Src::Trace

Ademas de las opciones anteriores, algunas opciones de configuracion menos usadas solo pueden especificarse en los ficheros de configuracion, /etc/apt/apt.conf y ~/.apt-src/config. Estas son:

APT::Src::BuildCommand
La orden a usar para construir el arbol. Se ejecuta en el arbol a construir, por omision es ``dpkg-buildpackage -b -us -uc'', con ``-rfakeroot'' an~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 construccion. ``sudo'' es una buena eleccion, es el comportamiento predeterminado. Si quiere usar ``su'', necesitara establecerlo a ``su -c''.
APT::Src::BuildDeps
Controla si apt-src se asegura de que las dependencias de construccion de un paquete se satisfacen al instalar o actualizar el paquete. Por omision esta habilitado, si lo deshabilita, es posible que los paquetes no se puedan construir debido a la falta de las dependencias de contruccion.

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 esten 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 version 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 arbol 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 este 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 modulos del nucleo que necesite saber si esta siendo construido por apt-src, y si es asi 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 donde descarga los paquetes.
~/.apt-src/status
El fichero de estado de apt-src, contiene los paquetes instalados.
/etc/apt/apt.conf
Fichero de configuracion global de apt-src (y apt).
~/.apt-src/config
Fichero de configuracion de apt-src para cada usuario.

VEASE ADEMAS

apt-get(8), sources.list(5), dpkg-source(1)

AUTOR

Copyright 2002 Joey Hess <[email protected]>

Esto es software libre; lea la Licencia Publica General de GNU version 2 o posterior para las condiciones de copia. NO hay ninguna garantia.

TRADUCTOR

Traduccion de Ruben Porras Campo <[email protected]>