Man page - apt-src(1)

Packages contains this manual

Available languages:

en fr es pt nl gl ro de

Manual

APT-SRC.FR

NOM
SYNOPSIS
DESCRIPTION
OPTIONS
REMARQUE SUR LES NOMS
ENVIRONNEMENT
EXEMPLES
FICHIERS
VOIR AUSSI
AUTEUR
TRADUCTION

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.