Ubuntu Manpage: apt-src - Gere les arborescences des paquets source debian.

NOM

       apt-src - Gere les arborescences des paquets source debian.

SYNOPSIS

       apt-src [options] commande

       apt-src [options] install|remove paquet1 [paquet2 ...]

       apt-src emplacement paquet

DESCRIPTION

apt-src est une interface en ligne de commande pour le telechargement, l'installation, la
mise a niveau et le suivi des paquets source debian. Ce programme peut etre execute aussi
bien par un utilisateur normal que par le superutilisateur (root).

A la difference des paquets binaires, les paquets source ne sont pas installes dans un
emplacement standard (canonique). En effet, ils sont X installes X en depaquetant leur
arborescence source dans le repertoire desire. Un paquet source peut etre installe
plusieurs fois, a des emplacements differents. Ce programme gere les paquets source
installes selon ce principe et fournit des outils de recherche pour vous aider a trouver
ou un paquet source est installe.

Une des commandes ci-dessous doit etre indiquee, sauf lors de l'utilisation des options -h
ou -help.

update
Met a jour les listes des paquets disponibles. Rigoureusement identique a X apt-
get update X. Ne peut etre executee, dans la configuration par defaut, que par le
superutilisateur.

install
Installe, dans le repertoire courant, le ou les paquets source indiques. Si le paquet
est deja installe dans le repertoire courant, une mise a niveau est tentee.

Cette commande accepte aussi bien les noms de paquets binaires que ceux des paquets
source. Comme avec X apt-get install X, vous pouvez prefixer le nom avec =version ou
/distribution (release) pour specifier la version du paquet ou la distribution
choisie.

Cette commande s'assurera que les dependances du paquet source sont satisfaites.

Avec l'option --location, le paquet source sera installe ou mis a niveau a
l'emplacement indique au lieu du repertoire courant.

Avec l'option --build tous les paquets nouvellement installes ou mis a jour seront
compiles.

upgrade
Met a jour tous les paquets source installes, sauf avec les options --location ou
--here (ici), ou seuls les paquets source situes dans le repertoire indique seront mis
a jour.

Avec l'option --patch (valeur par defaut), apt-src tentera de fabriquer une rustine
(patch) contenant tous les changements locaux apportes au paquet source puis
appliquera cette rustine a l'arborescence apres sa mise a jour. Ceci permet a vos
changements locaux d'etre preserves lors d'une mise a niveau du paquet. Il peut
arriver que cette methode ne fonctionne pas, vous devrez alors fusionner vos propres
modifications a la main.

Avec l'option --build tous les paquets nouvellement installes ou mis a jour seront
compiles.

remove
Supprime le ou les paquets source specifies. Les options --location ou --here (ici)
peuvent etre employees pour limiter la suppression des paquets au repertoire indique.

build
Construit la ou les sources specifiees. Si la source n'est pas encore installee, elle
le sera prealablement.

clean
Nettoie les arborescences du ou des paquets source specifies. Les options --location
ou --here (ici) peuvent etre employees pour ne nettoyer que les paquets du repertoire
indique.

import
Permet d'informer apt-src de l'existence d'une arborescence source prealablement
depaquetee. En plus du nom sous lequel elle doit etre importee, vous devez indiquer
l'emplacement de cette arborescence source (avec --location). Vous pouvez avoir besoin
de specifier la version de la source (avec --version). N'esperez pas que la commande
build fonctionne avec cette source, a moins qu'elle ne possede un repertoire debian/

list
Sans autre parametre, cette commande enumere tous les paquets source installes et
indique leur etat ainsi que le repertoire ou ils sont installes. Si le nom d'un paquet
est specifie, la commande affichera seulement les occurrences installees de ce paquet
source. Si les options --location ou --here sont employees, elles limiteront la liste
aux paquets du repertoire indique.

location
N'accepte qu'un seul parametre : Le nom du paquet source. Si le paquet est installe,
la commande renvoie le chemin de la racine de l'arborescence du paquet source.

Cette commande peut etre employee quand vous devez inclure des fichiers provenant d'un
autre paquet source, ou quelque chose comme ca. Par exemple :

apt-src location pkg

version
N'accepte qu'un seul parametre : le nom du paquet source. Si le paquet est installe,
sa version est retournee.

name
N'accepte qu'un seul parametre : le nom d'un paquet source (une expression rationnelle
peut etre utilisee). Renvoie le nom du paquet source installe, correspondant au
parametre specifie. (NdT : Utile en cas d'utilisation d'expression rationnelle.)

OPTIONS

Toutes les options en ligne de commande peuvent etre reglees par l'intermediaire du
fichier de configuration. Les descriptions indiquent l'option de configuration a regler.
Pour les options booleennes vous pouvez surcharger les valeurs par defaut du fichier en
employant quelque chose comme -f-, --no-f, -f=no ou d'autres variantes.

-h, --help
Affiche ce fichier d'aide.

-b, --build, --compile
Construit les paquets source apres les avoir installes ou mis a jour. Parametre de
configuration : APT::Src::Compile

-i, --installdebs
Installe les paquets apres avoir construit les sources. Implique l'usage de --build.
Parametre de configuration : APT::Src::InstallDebs

Notez que si des paquets multiples sont produits a partir d'un paquet source unique,
ils seront tous installes.

-p, --patch
Tente de reimplanter les changements locaux dans la nouvelle arborescence apres la
mise a jour. Cette option est prise par defaut. Employer --no-p pour ignorer cette
action. Parametre de configuration : APT::Src::Patch

-l, --location
Specifie un repertoire. Limite l'action aux paquets du repertoire specifie. Parametre
de configuration : APT::Src::Location

-c, --cwd, --here
Limite l'action aux paquets du repertoire courant. Parametre de configuration :
APT::Src::Here

--upstream-version
Utilisable seulement avec la commande version. Permet de ne pas afficher le numero de
version debian de la version du paquet.

-k, --keep-built
Conserve les .debs et les autres fichiers construits, apres leur installation, lors de
l'usage de l'option --installdebs. Parametre de configuration : APT::Src::KeepBuilt

-n, --no-delete-source
Conserve les fichiers source lors de la desinstallation d'un paquet source. Parametre
de configuration : APT::Src:NoDeleteSource

--version
Specifie une version de l'arborescence de la source. A utiliser avec la commande
d'importation.

-q, --quiet
Redirige toutes les sorties vers /dev/null a moins qu'une commande ne fonctionne pas
comme prevu. Parametre de configuration : APT::Src::Quiet

-t, --trace
Affiche chaque commande telle qu'elle est lancee. Parametre de configuration :
APT::Src::Trace

En plus des options ci-dessus, il existe quelques elements de configuration moins
utilises. Ils ne peuvent etre indiques que dans les fichiers de configuration
/etc/apt/apt.conf et ~/.apt-src/config Il s'agit de :

APT::Src::BuildCommand
Indique la commande a employer pour construire le paquet. Cette commande sera executee
a partir de l'arborescence des sources. Par defaut X dpkg-buildpackage - b -us -uc X,
avec X -rfakeroot X ajoute pour les utilisateurs autres que le superutilisateur.

APT::Src::RootCommand
Indique la commande a employer si un utilisateur autre que le superutilisateur doit
devenir superutilisateur. Elle est employee pour, par exemple, satisfaire build-deps.
sudo, la valeur par defaut, est un choix judicieux. Si vous voulez employer su, vous
devez le faire sous la forme X su -c X.

APT::Src::BuildDeps
Demande a apt-src d'installer les dependances necessaires au paquet source lors de son
installation ou de sa mise a jour. Actif par defaut. Si vous desactivez cette option,
certains paquets peuvent ne pas etre construits en raison de dependances manquantes.

NOTE SUR LES NOMS

       Vous pouvez employer le nom du paquet binaire ou le nom du paquet source pour installer un
       nouveau paquet source.

       Par contre, pour travailler avec des paquets deja installes, vous devez, actuellement,
       employer les noms des paquets source. (Cela pourrait changer plus tard). Toutefois, vous
       pouvez employer des expressions rationnelles pour specifier les noms.

ENVIRONNEMENT

       Ce programme definit APT_SRC_BUILD lorsqu'il construit un paquet.

EXEMPLES

       Pour installer le paquet source X toto X dans /usr/src, construire le paquet et installer
       les .debs resultants :

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

       Pour suivre les changements du paquet source X toto X deja implante et installer les .debs
       a chaque fois qu'une nouvelle version est disponible :

         apt-src install -i toto

       Pour installer une copie locale du paquet foo, et appliquer une rustine (patch) locale :

         apt-src install foo
         cd foo-version
         patch <~/my-foo-patch
         apt-src build --installdebs foo

       Pour mettre a niveau votre copie locale de foo, conserver votre rustine (patch), puis
       construire et installer les nouveaux .debs :

         apt-src install -i foo

       Pour importer, dans apt-src, l'arborescence source que vous avez depaquetee, par un
       tarball, dans /usr/src/linux, depuis ftp.kernel.org (ou depuis un paquet du kernel-
       source). Cette commande a pour but de renseigner apt-src au sujet du paquet :

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

       Voici un exemple utilise pour le paquet d'un module noyau dont le script debian/rules
       cherche a determiner s'il est construit par apt-src, pour, dans ce cas, definir les
       variables KVERS, KSRC, et KDREV qui sont normalement fixees par 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

FICHIERS

       /etc/apt/sources.list
           Emplacement des archives du systeme de distribution de paquets.

       ~/.apt-src/status
           Fichier d'etat d'apt-src, qui liste les paquets installes.

       /etc/apt/apt.conf
           Fichier global de configuration pour apt-src (et apt).

       ~/.apt-src/config
           Fichier de configuration propre a l'utilisateur pour apt-src.

VOIR AUSSI

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

AUTEUR

       Copyright 2002 Joey Hess <joeyh@debian.org>

       Ceci est logiciel libre. Consultez la version 2 et suivantes de la Licence Publique
       Generale (GPL) de GNU pour les conditions de duplication. Ce logiciel est fourni sans
       AUCUNE garantie.

TRADUCTION

       Valery Perrin <valery.perrin.debian@free.fr> le 18 octobre 2004.

       L'equipe de traduction a fait le maximum pour realiser une adaptation francaise de
       qualite.

       La version anglaise la plus a jour de ce document est toujours consultable via la commande
       X man -L en apt-src X.

       N'hesitez pas a signaler a l'auteur ou au traducteur, selon le cas, toute erreur dans de
       cette page de manuel.