Ubuntu Manpage: apt-src – Gestion des arborescences de paquets source debian.

NOM

       apt-src – Gestion des arborescences de 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 téléchargement, l'installation, la mise à niveau
et le suivi des paquets source de 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
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
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
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.

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.

Cette commande s'assurera que les dépendances du paquet source sont satisfaites.

Avec l'option --location, le paquet source sera installé ou mis à niveau à l'emplacement indiqué au
lieu du répertoire courant.

Avec l'option --build tous les paquets nouvellement installés ou mis à niveau seront compilés.

upgrade
Met à niveau 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.

Avec l'option --patch (option 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 à niveau. Cela permet à vos changements locaux d'être préservés lors d'une mise à
niveau de paquet. Il peut arriver que cette méthode ne fonctionne pas, vous devrez alors fusionner
vos propres modifications à la main.

Avec l'option --build tous les paquets nouvellement installés ou mis à niveau seront compilés.

remove
Supprime le ou les paquets source spécifiés. Les options --location ou --here peuvent être employées
pour limiter la suppression de paquets dans le répertoire indiqué.

build
Construit le ou les sources spécifiés. Si le source n'est pas encore installé, il le sera
préalablement.

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

import
Permet d'informer apt-src de l'existence d'une arborescence source non 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 du source (avec --version).
N'espérez pas que la commande build fonctionne avec ce source, à moins qu’il ne possède un répertoire
debian/

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
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.

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 :

-I`apt-src emplacement paquet`

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

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é, si cette
correspondance existe.

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
Affiche un message d'aide.

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

-i, --installdebs
Installe les paquets après avoir construit les sources. Implique l’utilisation de --build. Item de
configuration : APT::Src::InstallDebs

Notez que si plusieurs paquets sont produits à partir d'un paquet source unique, ils seront tous
installés.

-p, --patch
Tente de réimplanter les changements locaux dans la nouvelle arborescence après la mise à niveau.
Cette option est celle par défaut. Employer « --no-p » pour désactiver cette action. Item de
configuration : APT::Src::Patch

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

-c, --cwd, --here
Limite l'action aux paquets du répertoire actuel. Item de configuration : APT::Src::Here

--upstream-version
Utilisable seulement avec la commande version. Permet de ne pas afficher le numéro de version de
Debian dans le numéro de version du paquet.

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

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

--version
Spécifie une version de l'arborescence source. À utiliser avec la commande import.

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

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

En plus des options ci-dessus, il existe quelques items 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
Indique la commande à employer pour construire l’arborescence. Cette commande sera exécutée à partir
de l'arborescence à construire. Par défaut dpkg-buildpackage -b -us -uc avec « -rfakeroot » ajouté
pour les utilisateurs autres que le superutilisateur.

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

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

REMARQUE 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 comme partie de noms.

ENVIRONNEMENT

       Ce programme définit APT_SRC_BUILD lorsqu'il construit un paquet.

EXEMPLES

       Pour installer le paquet source mutt(1) dans /usr/src,  construire  le  paquet  et  installer  les  .debs
       résultants :

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

       Pour  suivre  les  changements du paquet source mutt(1) déjà installé et installer les debs à chaque fois
       qu'une nouvelle version est disponible :

         apt-src install -i mutt

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

         apt-src install toto
         cd version_toto
         patch <~/ma_rustine_toto
         apt-src build --installdebs toto

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

         apt-src install -i toto

       Pour   importer   l'arborescence   source  /usr/src/linux  que  vous  avez  dépaqueté  d’une  archive  de
       www.kernel.org (ou depuis un paquet des sources du  noyau)  dans  apt-src  pour  qu’il  puisse  en  tenir
       compte :

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

       Dans  le  fichier debian/rules d’un paquet du module du noyau qui a besoin de savoir s’il est construit à
       l’aide d’apt-src, et, si c’est le cas, définir les  variables  KVERS,  KSRC  et  KDREV  que  make-kpkg(1)
       définit habituellement :

         ifdef APT_SRC_BUILD
         KDREV=$(shell apt-src version noyau\(-source.\*\)\?)
         KSRC=$(shell apt-src emplacement noyau\(-source.\*\)\?)
         KVERS=$(shell apt-src nom noyau\(-source.\*\)\? | sed s/noyau-source-//)
         endif

FICHIERS

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

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

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

       ~/.apt-src/config
           Fichier de configuration propre à 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 Générale (GPL) de GNU
       pour les conditions de copie. Ce logiciel est fourni sans AUCUNE garantie.

TRADUCTION

       Valéry Perrin <valery.perrin.debian@free.fr>, 2004. Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>,
       2025.

       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 à l’aide de 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.

perl v5.40.1                                       2025-03-29                                     APT-SRC.FR(1p)