.de Sh " Subsection heading .if t .Sp .ne 5

$1


Nom

.IX Header "NOM" apt-src - Gère les arborescences des paquets source debian.

Résumé

.IX Header "SYNOPSIS" &apt-src [options] commande

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

&apt-src emplacement paquet

Description

.IX Header "DESCRIPTION" apt-src est une interface en ligne de commande pour le téléchargement, l'installation, la mise à niveau et le suivi des paquets source debian. Ce programme peut être exécuté aussi bien par un utilisateur normal que par le superutilisateur (root).

À la différence des paquets binaires, les paquets source ne sont pas installés dans un emplacement standard (canonique). En effet, ils sont « installés » en dépaquetant leur arborescence source dans le répertoire désiré. Un paquet source peut être installé plusieurs fois, à des emplacements différents. Ce programme gère les paquets source installés selon ce principe et fournit des outils de recherche pour vous aider à trouver où un paquet source est installé.

Une des commandes ci-dessous doit être indiquée, sauf lors de l'utilisation des options -h ou -help.
"update" 4

.IX Item "update" Met à jour les listes des paquets disponibles. Rigoureusement identique à « apt-get update ». Ne peut être exécutée, dans la configuration par défaut, que par le superutilisateur.

"install" 4

.IX Item "install" Installe, dans le répertoire courant, le ou les paquets source indiqués. Si le paquet est déjà installé dans le répertoire courant, une mise à niveau est tentée. .Sp Cette commande accepte aussi bien les noms de paquets binaires que ceux des paquets source. Comme avec « apt-get install », vous pouvez préfixer le nom avec =version ou /distribution (release) pour spécifier la version du paquet ou la distribution choisie. .Sp Cette commande s'assurera que les dépendances du paquet source sont satisfaites. .Sp Avec l'option --location, le paquet source sera installé ou mis à niveau à l'emplacement indiqué au lieu du répertoire courant. .Sp Avec l'option --build tous les paquets nouvellement installés ou mis à jour seront compilés.

"upgrade" 4

.IX Item "upgrade" Met à jour tous les paquets source installés, sauf avec les options &--location ou --here (ici), où seuls les paquets source situés dans le répertoire indiqué seront mis à jour. .Sp Avec l'option --patch (valeur par défaut), apt-src tentera de fabriquer une rustine (patch) contenant tous les changements locaux apportés au paquet source puis appliquera cette rustine à l'arborescence après sa mise à jour. Ceci permet à vos changements locaux d'être préservés lors d'une mise à niveau du paquet. Il peut arriver que cette méthode ne fonctionne pas, vous devrez alors fusionner vos propres modifications à la main. .Sp Avec l'option --build tous les paquets nouvellement installés ou mis à jour seront compilés.

"remove" 4

.IX Item "remove" Supprime le ou les paquets source spécifiés. Les options --location ou &--here (ici) peuvent être employées pour limiter la suppression des paquets au répertoire indiqué.

"build" 4

.IX Item "build" Construit la ou les sources spécifiées. Si la source n'est pas encore installée, elle le sera préalablement.

"clean" 4

.IX Item "clean" Nettoie les arborescences du ou des paquets source spécifiés. Les options &--location ou --here (ici) peuvent être employées pour ne nettoyer que les paquets du répertoire indiqué.

"import" 4

.IX Item "import" Permet d'informer apt-src de l'existence d'une arborescence source préalablement dépaquetée. En plus du nom sous lequel elle doit être importée, vous devez indiquer l'emplacement de cette arborescence source (avec --location). Vous pouvez avoir besoin de spécifier la version de la source (avec --version). N'espérez pas que la commande build fonctionne avec cette source, à moins qu'elle ne possède un répertoire debian/

"list" 4

.IX Item "list" Sans autre paramètre, cette commande énumère tous les paquets source installés et indique leur état ainsi que le répertoire où ils sont installés. Si le nom d'un paquet est spécifié, la commande affichera seulement les occurrences installées de ce paquet source. Si les options &--location ou --here sont employées, elles limiteront la liste aux paquets du répertoire indiqué.

"location" 4

.IX Item "location" N'accepte qu'un seul paramètre : Le nom du paquet source. Si le paquet est installé, la commande renvoie le chemin de la racine de l'arborescence du paquet source. .Sp Cette commande peut être employée quand vous devez inclure des fichiers provenant d'un autre paquet source, ou quelque chose comme ça. Par exemple : .Sp &apt-src location pkg

"version" 4

.IX Item "version" N'accepte qu'un seul paramètre : le nom du paquet source. Si le paquet est installé, sa version est retournée.

"name" 4

.IX Item "name" N'accepte qu'un seul paramètre : le nom d'un paquet source (une expression rationnelle peut être utilisée). Renvoie le nom du paquet source installé, correspondant au paramètre spécifié. (NdT : Utile en cas d'utilisation d'expression rationnelle.)

Options

.IX Header "OPTIONS" Toutes les options en ligne de commande peuvent être réglées par l'intermédiaire du fichier de configuration. Les descriptions indiquent l'option de configuration à régler. Pour les options booléennes vous pouvez surcharger les valeurs par défaut du fichier en employant quelque chose comme -f-, --no-f, -f=no ou d'autres variantes.
"-h, --help" 4

.IX Item "-h, --help" Affiche ce fichier d'aide.

"-b, --build, --compile" 4

.IX Item "-b, --build, --compile" Construit les paquets source après les avoir installés ou mis à jour. Paramètre de configuration : APT::Src::Compile

"-i, --installdebs" 4

.IX Item "-i, --installdebs" Installe les paquets après avoir construit les sources. Implique l'usage de &--build. Paramètre de configuration : APT::Src::InstallDebs .Sp Notez que si des paquets multiples sont produits à partir d'un paquet source unique, ils seront tous installés.

"-p, --patch" 4

.IX Item "-p, --patch" Tente de réimplanter les changements locaux dans la nouvelle arborescence après la mise à jour. Cette option est prise par défaut. Employer --no-p pour ignorer cette action. Paramètre de configuration : APT::Src::Patch

"-l, --location" 4

.IX Item "-l, --location" Spécifie un répertoire. Limite l'action aux paquets du répertoire spécifié. Paramètre de configuration : APT::Src::Location

"-c, --cwd, --here" 4

.IX Item "-c, --cwd, --here" Limite l'action aux paquets du répertoire courant. Paramètre de configuration : APT::Src::Here

"--upstream-version" 4

.IX Item "--upstream-version" Utilisable seulement avec la commande version. Permet de ne pas afficher le numéro de version debian de la version du paquet.

"-k, --keep-built" 4

.IX Item "-k, --keep-built" Conserve les .debs et les autres fichiers construits, après leur installation, lors de l'usage de l'option --installdebs. Paramètre de configuration : APT::Src::KeepBuilt

"-n, --no-delete-source" 4

.IX Item "-n, --no-delete-source" Conserve les fichiers source lors de la desinstallation d'un paquet source. Paramètre de configuration : APT::Src:NoDeleteSource

"--version" 4

.IX Item "--version" Spécifie une version de l'arborescence de la source. À utiliser avec la commande d'importation.

"-q, --quiet" 4

.IX Item "-q, --quiet" Redirige toutes les sorties vers /dev/null à moins qu'une commande ne fonctionne pas comme prévu. Paramètre de configuration : APT::Src::Quiet

"-t, --trace" 4

.IX Item "-t, --trace" Affiche chaque commande telle qu'elle est lancée. Paramètre de configuration : APT::Src::Trace

En plus des options ci-dessus, il existe quelques éléments de configuration moins utilisés. Ils ne peuvent être indiqués que dans les fichiers de configuration /etc/apt/apt.conf et ~/.apt-src/config Il s'agit de :
"APT::Src::BuildCommand" 4

.IX Item "APT::Src::BuildCommand" Indique la commande à employer pour construire le paquet. Cette commande sera exécutée à partir de l'arborescence des sources. Par défaut « dpkg-buildpackage - b -us -uc », avec « -rfakeroot » ajouté pour les utilisateurs autres que le superutilisateur.

"APT::Src::RootCommand" 4

.IX Item "APT::Src::RootCommand" Indique la commande à employer si un utilisateur autre que le superutilisateur doit devenir superutilisateur. Elle est employée pour, par exemple, satisfaire build-deps. sudo, la valeur par défaut, est un choix judicieux. Si vous voulez employer su, vous devez le faire sous la forme « su -c ».

"APT::Src::BuildDeps" 4

.IX Item "APT::Src::BuildDeps" Demande à apt-src d'installer les dépendances nécessaires au paquet source lors de son installation ou de sa mise à jour. Actif par défaut. Si vous désactivez cette option, certains paquets peuvent ne pas être construits en raison de dépendances manquantes.

Nom

.IX Header "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 déjà installés, vous devez, actuellement, employer les noms des paquets source. (Cela pourrait changer plus tard). Toutefois, vous pouvez employer des expressions rationnelles pour spécifier les noms.

Environnement

.IX Header "ENVIRONNEMENT" Ce programme définit s-1APT_SRC_BUILDs0 lorsqu'il construit un paquet.

Exemples

.IX Header "EXEMPLES" Pour installer le paquet source « toto » dans /usr/src, construire le paquet et installer les .debs résultants :

.Vb 1 & apt-src install --location=/usr/src -i toto .Ve

Pour suivre les changements du paquet source « toto » déjà implanté et installer les .debs à chaque fois qu'une nouvelle version est disponible :

.Vb 1 & apt-src install -i toto .Ve

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

.Vb 4 & apt-src install foo & cd foo-version & patch <~/my-foo-patch & apt-src build --installdebs foo .Ve

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

.Vb 1 & apt-src install -i foo .Ve

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

.Vb 1 & apt-src import kernel --location=/usr/src/linux --version=2.4.18 .Ve

Voici un exemple utilisé pour le paquet d'un module noyau dont le script debian/rules cherche à déterminer s'il est construit par apt-src, pour, dans ce cas, définir les variables s-1KVERSs0, s-1KSRCs0, et s-1KDREVs0 qui sont normalement fixées par make-kpkg :

.Vb 5 & ifdef APT_SRC_BUILD & KDREV=$(shell apt-src version kernele(-source.e*e)e?) & KSRC=$(shell apt-src location kernele(-source.e*e)e?) & KVERS=$(shell apt-src name kernele(-source.e*e)e? | sed s/kernel-source-//) & endif .Ve

Fichiers

.IX Header "FICHIERS"
"/etc/apt/sources.list" 4

.IX Item "/etc/apt/sources.list" Emplacement des archives du système de distribution de paquets.

"~/.apt-src/status" 4

.IX Item "~/.apt-src/status" Fichier d'état d'apt-src, qui liste les paquets installés.

"/etc/apt/apt.conf" 4

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

"~/.apt-src/config" 4

.IX Item "~/.apt-src/config" Fichier de configuration propre à l'utilisateur pour apt-src.

Voir aussi

.IX Header "VOIR AUSSI" &apt-get(8), sources.list(5), dpkg-source(1)

Auteur

.IX Header "AUTEUR" Copyright 2002 Joey Hess <joeyh@debian.org>

Ceci est logiciel libre. Consultez la version 2 et suivantes de la Licence Publique Générale (s-1GPLs0) de s-1GNUs0 pour les conditions de duplication. Ce logiciel est fourni sans s-1AUCUNEs0 garantie.

Traduction

.IX Header "TRADUCTION" Valéry Perrin <valery.perrin.debian@free.fr> le 18 octobre 2004.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité.

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

N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans de cette page de manuel.