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.