NOME¶

apt-src - xestión de árbores de paquetes fonte de debian

SINOPSE¶

apt-src [opcións] ordes

apt-src [opcións] install|remove paquete1 [paquete2 ...]

apt-src location pkg

DESCRICIÓN¶

apt-src é unha interface por liña de ordes para descargar, instalar, actualizar e controlar os paquetes fonte de debian. Pode executarse coma usuario normal ou administrador.

Os paquetes fonte non se instalan nunha única ruta, ao contrario cos paquetes binarios. «Instálanse» desempaquetando a estrutura de cartafoles nun directorio, que pode estar en calquera ruta. Un mesmo paquete fonte pode instalarse varias veces, en distintos lugares. Este programa xestiona os paquetes fonte instalados deste xeito, e prové ferramentas para consultar e atopar onde se instalaron os paquetes fonte.

Se non se indican as opcións -h ou --help, deberase empregar algunha das opcións abaixo descritas.

update

Actualizar a listaxe de paquetes. Equivalente a apt-get update, e precisa de permisos de administrador na configuración predeterminada.

install

Instalar o paquete ou paquetes fonte mencionados no directorio actual. Se xa existe, intentará actualizalo.

Esta orde acepta nomes de paquetes binarios ou fonte. Igual ca apt-get install, pódese engadir =versión-do-paquete ou /versión-de-debian antes do nome para especificar que versión do paquete fonte escoller.

Tamén encargarse de cumprir coas dependencias de compilación do paquete fonte.

Se se engade a opción --location o paquete fonte instalarase no lugar indicado, no canto do directorio actual.

Se se engade a opción --build, compilarase calquera paquete instalado ou actualizado.

upgrade

Actualiza todos os paquetes fonte instalados, ou, se se empregar as opción --location ou --here, só actualizar os paquetes do directorio indicado.

Se se engade a opción --patch (por omisión), apt-src intentará xerar un parche cos cambios locais, e aplicará estes cambios ao código actualizado. Isto permite preservar os cambios locais tras actualizar os paquetes, inda que nalgúns casos pode que se precise xuntar os cambios a man.

Se se engade a opción --build, compilarase calquera paquete instalado ou actualizado.

remove

Elimina o paquete ou paquetes fonte indicados. Pódense empregar as opcións --location e --here para só eliminar os paquetes do directorio especificado.

build

Compila as fontes indicadas. Instalará o paquete axeitado se non se fixo xa.

clean

Limpa os directorios do paquete ou paquetes indicados. Pódense engadir as opcións --location e --here para só limpar os paquetes dun directorio específico.

import

Esta opción permite indicarlle a apt-src a existencia dunha fonte sen empaquetar. Ademais do nome baixo o que importala, deberase engadir a ruta do código (con --location), e pode precisarse indicar a versión da fonte (con --version). A orde build pode que non funcione se a fonte non contén un directorio debian/.

list

Sen máis parámetros, amosa unha listaxe dos paquetes fonte instalados, o seu estado e onde se instalaron. Se se engade o nome dun paquete, só amosará as instancias instaladas dese paquete. Se se engaden as opcións --location ou --here, só amosarán os paquetes no directorio indicado.

location

Toma coma único parámetro o nome dun paquete fonte. Se se instalou o paquete, devolverá a ruta na que se atopa.

Esta orde pode ser útil ao incluír ficheiros doutro paquete fonte. Por exemplo:

 -I`apt-src location paquete`
    

version

Toma como único parámetro o nome dun paquete fonte. Se se instalou o paquete devolverá a versión que está instalada.

name

Toma como único parámetro o nome (acepta tamén expresións regulares) dun paquete fonte. Devolve o nome do paquete fonte instalado coincidente, se existe.

OPCIÓNS¶

Todas as opcións poden engadirse ao ficheiro de configuración. As descricións indican as opcións a engadir. Para opcións booleanas pódense sobrescribir no ficheiro predeterminado empregando a sintaxe -f, --no-f, -f=no ou variacións.

-h, --help

Amosa o texto de axuda.

-b, --build, --compile

Compila os paquetes fonte tras instalalos ou actualizalos. Configúrase mediante: APT::Src::Compile.

-i, --installdebs

Instala os paquetes tras compilar as fontes. Implica --build. Configúrase mediante: APT::Src::InstallDebs.

Teña en mente que instalaranse todos os paquetes binarios xerados a partir do paquete fonte.

-p, --patch

Intentar parchear os cambios locais no novo código tras actualizar. Activado por omisión, use --no-p para desactivalo. Configúrase mediante: APT::Src::Patch.

-l, --location

Especifica o directorio no que operar. Configúrase mediante: APT::Src::Location.

-c, --cwd, --here

Só operar en paquetes no directorio actual Configúrase mediante: APT::Src::Here.

--upstream-version

Só funciona coa orde version. Omite a parte de debian do número de versión na saída.

-k, --keep-built

Non borrar os .deb e os resultados da compilación tras instalalos coa opción --installdebs. Configúrase mediante: APT::Src::KeepBuilt.

-n, --no-delete-source

Non borrar o código fonte tras eliminar o paquete fonte. Configúrase mediante: APT::Src::NoDeleteSource.

--version

Especifica a versión da fonte. Úsase coa orde import.

-q, --quiet

Manda toda a saída por pantalla a /dev/null, excepto se ocorreu algún fallo. Configúrase mediante: APT::Src::Quiet.

-t, --trace

Amosa cada orde segundo se executar. Configúrase mediante: APT::Src::Trace.

Ademais das opcións anteriores, hai algunhas opcións menos usadas que só se poden configurar en ficheiros, /etc/apt/apt.conf e ~/.apt-src/config. Son:

APT::Src::BuildCommand

A orde a usar para compilar o paquete. Execútase no directorio raíz, por omisión é "dpkg-buildpackage -b -us -uc", con "-rfakeroot" se o usuario non é administrador.

APT::Src::RootCommand

Que orde empregar se un usuario normal precisa de permisos elevados. Isto úsase, por exemplo, para satisfacer as dependencias de compilación. sudo(8), o valor por omisión, é unha boa opción. Para cambiar a su(1), hai que mudar esta opción a "su -c".

APT::Src::BuildDeps

Controla se apt-src controla que todas as dependencias de compilación estean presentes ao instalar ou actualizar. Verdadeiro por omisión. Se se desactiva pode que algúns paquetes non compilen por falta de dependencias.

AVISO SOBRE OS NOMES¶

Pódense usar indistintamente os nomes de paquetes binarios ou de paquetes fonte ao instalar novos paquetes fonte.

No resto de casos, ao tratar de paquetes instalados, hai que empregar os nomes dos paquetes fonte (isto pode mudar no futuro). Porén, tamén se poden usar expresións regulares para os nomes.

AMBIENTE¶

Este programa escribe APT_SRC_BUILD durante a compilación.

EXEMPLOS¶

Para instalar a fonte de mutt(1) en /usr/src, compilalo e instalar os paquetes resultantes:

  apt-src install --location=/usr/src -i mutt

Para controlar os cambios a este mutt(1) fonte instalado, e instalar o compilado cando salga unha nova versión:

  apt-src install -i mutt

Para instalar unha copia local do paquete foo, ao que se lle aplicará un parche local:

  apt-src install foo
  cd foo-version
  patch <~/meu-parche-de-foo
  apt-src build --installdebs foo

Para actualizar a copia local de foo, parcheala, compilar e instalar o resultado:

  apt-src install -i foo

Para importar o código en /usr/src/linux, obtido dun arquivo de www.kernel.org (ou do paquete kernel-source), para que apt-src o coñeza:

  apt-src import kernel --location=/usr/src/linux --version=2.4.18

No caso de ter un módulo do núcleo que precisa saber se se está a empregar apt-src, e nese caso darlle os valores axeitados a KVERS, KSRC e KDREV para make-kpkg(1), engadir o seguinte a debian/rules:

  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

FICHEIROS¶

/etc/apt/sources.list

Dende onde obter os paquetes

~/.apt-src/status

Ficheiro de estado de apt-src, listaxe de paquetes instalados.

/etc/apt/apt.conf

Ficheiro de configuración global de apt-src (and apt(8)).

~/.apt-src/config

Ficheiro de configuración local do usuario de apt-src.

VÉXASE TAMÉN¶

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

AUTOR¶

Creado por Joey Hess <joeyh@debian.org>, 2002

Este programa é libre. Para saber as condicións de redistribución, consulte a Licenza Pública Xeral de GNU, versión 2 ou posterior. Esta obra publícase sen ningún tipo de garantía.