|
|
@@ -1,843 +0,0 @@
|
|
|
-.\" Hey, Emacs! This is an -*- nroff -*- source file.
|
|
|
-.\" Authors: Ian Jackson
|
|
|
-.\" traduction de la version cvs 1.15
|
|
|
-.TH DPKG\-SOURCE 1 "Januari 2000" "Debian Project" "Utilitaires de Dpkg"
|
|
|
-.SH NOM
|
|
|
-dpkg\-source, dpkg\-gencontrol, dpkg\-shlibdeps, dpkg\-genchanges,
|
|
|
-dpkg\-buildpackage, dpkg\-distaddfile, dpkg\-parsechangelog
|
|
|
-\- Les outils de Debian pour les paquets source.
|
|
|
-.SH SYNOPSIS
|
|
|
-.B dpkg-source
|
|
|
-.BI "-x " fichier.dsc
|
|
|
-.br
|
|
|
-.B dpkg-source -b
|
|
|
-.RI [ options "] " répertoire " [" répertoire-d'origine |'']
|
|
|
-.br
|
|
|
-.B dpkg-gencontrol
|
|
|
-.RI [ options ]
|
|
|
-.br
|
|
|
-.B dpkg-shlibdeps
|
|
|
-.IR options
|
|
|
-.br
|
|
|
-.B dpkg-genchanges
|
|
|
-.RI [ options ]
|
|
|
-.br
|
|
|
-.B dpkg-buildpackage
|
|
|
-.RI [ options ]
|
|
|
-.br
|
|
|
-.B dpkg-distaddfile
|
|
|
-.RI [ options ] " fichier section priorité"
|
|
|
-.br
|
|
|
-.B dpkg-parsechangelog
|
|
|
-.RI [ options ]
|
|
|
-.SH DESCRIPTION
|
|
|
-.B dpkg-source
|
|
|
-empaquète ou dépaquète une archive source Debian.
|
|
|
-
|
|
|
-.B dpkg-gencontrol
|
|
|
-lit les information contenues dans une arborescence Debian dépaquetée et
|
|
|
-crée le fichier «\ control\ » d'un paquet binaire (par défaut, c'est
|
|
|
-le fichier debian/tmp/DEBIAN/control) ;
|
|
|
-il ajoute aussi une entrée pour ce paquet binaire dans
|
|
|
-.BR debian/files .
|
|
|
-
|
|
|
-.B dpkg-shlibdeps
|
|
|
-calcule, pour les exécutables nommés dans ses arguments, les dépendances
|
|
|
-envers les bibliothèques partagées. Ces dépendances sont ajoutées
|
|
|
-sous la forme
|
|
|
-.BI shlibs: dependencyfield
|
|
|
-.I dependencyfield
|
|
|
-est le nom du champ « dépendance » --
|
|
|
-dans le fichier
|
|
|
-.B debian/substvars
|
|
|
-qui indique les substitutions de variables. Toute autre variable après
|
|
|
-.I shlibs:
|
|
|
-est supprimée du fichier.
|
|
|
-.B dpkg-shlibdeps
|
|
|
-lit les informations concernant les dépendances envers les bibliothèques
|
|
|
-partagées dans les fichiers suivants :
|
|
|
-.BR debian/shlibs.local,
|
|
|
-.BR /etc/dpkg/shlibs.override,
|
|
|
-le fichier
|
|
|
-.B shlibs,
|
|
|
-(fichier du paquet contenant un fichier qui, selon
|
|
|
-.B objdump,
|
|
|
-satisfait au système de dépendance envers les bibliothèques) ou bien
|
|
|
-.BR /etc/dpkg/shlibs.default.
|
|
|
-Le premier trouvé est utilisé. Voyez le
|
|
|
-.I Debian packaging manual
|
|
|
-pour des détails sur le format des fichiers qui traitent des dépendances
|
|
|
-envers les bibliothèques partagées.
|
|
|
-
|
|
|
-.B dpkg-genchanges
|
|
|
-lit les informations à la fois dans une arborescence debian dépaquetée et déjà
|
|
|
-construite et sur les fichiers qui ont été crées ; puis il crée un fichier de
|
|
|
-contrôle pour la mise en place dans l'archive Debian ( c'est le fichier
|
|
|
-.RB .changes " )."
|
|
|
-
|
|
|
-.B dpkg-buildpackage
|
|
|
-est un script de contrôle qui peut faciliter la construction automatique d'un
|
|
|
-paquet.
|
|
|
-
|
|
|
-.B dpkg-distaddfile
|
|
|
-ajoute une entrée pour un fichier dans
|
|
|
-.BR debian/files.
|
|
|
-
|
|
|
-.B dpkg-parsechangelog
|
|
|
-lit et fait l'analyse du fichier «\ changelog\ » d'une arborescence source
|
|
|
-dépaquetée et affiche les informations qu'il contient sur la sortie
|
|
|
-standard et sous une forme lisible par la machine.
|
|
|
-
|
|
|
-Aucune de ces commandes ne permet la combinaison de plusieurs options en une
|
|
|
-seule et elles ne permettent pas d'indiquer la valeur d'une option dans un
|
|
|
-argument séparé.
|
|
|
-.SH LES OPTIONS COMMUNES
|
|
|
-Beaucoup de ces programmes partagent les options qui sont décrites ici ;
|
|
|
-on décrit en même temps les programmes qui les acceptent.
|
|
|
-.TP
|
|
|
-.BI -h
|
|
|
-Affiche la version du programme et un message d'aide qui
|
|
|
-comprend un résumé des options acceptées. Tous les outils pour les paquets
|
|
|
-source comprennent cette option.
|
|
|
-.TP
|
|
|
-.BI -v version
|
|
|
-Avec
|
|
|
-.BR dpkg-buildpackage ", " dpkg-genchanges " et " dpkg-parsechangelog
|
|
|
-cette option force l'utilisation des informations contenues dans le fichier
|
|
|
-«\ changelog\ » et qui concernent toutes les versions strictement plus
|
|
|
-récentes que
|
|
|
-.I version
|
|
|
-(qui doit apparaître dans le fichier «\ changelog\ »).
|
|
|
-
|
|
|
-Avec
|
|
|
-.BR dpkg-gencontrol,
|
|
|
-cette option donne le numéro de version du paquet binaire qui sera crée.
|
|
|
-.TP
|
|
|
-.BI -C description-des-changements
|
|
|
-Lit la description des changements dans le fichier
|
|
|
-.I description-des-changements
|
|
|
-plutôt que dans le fichier
|
|
|
-«\ changelog\ » de l'arborescence source.
|
|
|
-.BR dpkg-buildpackage " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -m adresse-du-responsable
|
|
|
-Utilise
|
|
|
-.I adresse-du-responsable
|
|
|
-comme nom et adresse électronique du responsable de paquet pour cette mise en
|
|
|
-place, plutôt que d'utiliser les informations contenues dans le fichier
|
|
|
-«\ control\ » de l'arborescence source.
|
|
|
-.BR dpkg-buildpackage " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -e adresse-du-responsable
|
|
|
-Utilise
|
|
|
-.I adresse-du-responsable
|
|
|
-comme nom et adresse électronique du responsable de paquet pour cette mise en
|
|
|
-place, plutôt que d'utiliser les informations contenues dans le fichier
|
|
|
-«\ changelog\ » de l'arborescence source.
|
|
|
-.BR dpkg-buildpackage " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BR -si ", " -sa ", " -sd
|
|
|
-Ces options contrôlent si l'archive source originale est incluse
|
|
|
-dans l'installation produite par
|
|
|
-.BR dpkg-buildpackage " et " dpkg-genchanges
|
|
|
-quand on construit un paquet source (i.e., les options
|
|
|
-.BR -b " or " -B
|
|
|
-ne sont pas utilisées).
|
|
|
-
|
|
|
-Par défaut, ou quand l'option
|
|
|
-.B -si
|
|
|
-est indiquée, les sources originales sont incluses si le numéro de version
|
|
|
-se termine par
|
|
|
-.BR -0 " ou " -1,
|
|
|
-i.e., si la partie « révision Debian » du numéro de version est égal à
|
|
|
-.BR 0 " ou " 1.
|
|
|
-
|
|
|
-L'option
|
|
|
-.B -sa
|
|
|
-force l'inclusion des sources originales ;
|
|
|
-l'option
|
|
|
-.B -sd
|
|
|
-force leur exclusion et inclut seulement le « diff ».
|
|
|
-.TP
|
|
|
-.BI -V nom = valeur
|
|
|
-Fixe la valeur d'une variable de substitution.
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-Voyez ci-dessous pour une discussion sur la valeur de substitution.
|
|
|
-.TP
|
|
|
-.BI -T fichier/substvars
|
|
|
-Lit (ou, écrit, pour
|
|
|
-.BR dpkg-shlibdeps),
|
|
|
-les variables de substitution dans le fichier
|
|
|
-.IR fichier/substvars ;
|
|
|
-Par défaut c'est le fichier
|
|
|
-.BR debian/substvars.
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol ", " dpkg-shlibdeps " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -D champ = valeur
|
|
|
-Remplace ou ajoute en sortie un champ dans le fichier de contrôle.
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -U champ
|
|
|
-Supprime en sortie un champ dans le fichier de contrôle.
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " and " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BR -b | -B | -S
|
|
|
-Avec
|
|
|
-.BR dpkg-genchanges " et " dpkg-buildpackage
|
|
|
-les options
|
|
|
-.BR -b " et " -B
|
|
|
-indiquent qu'on veut seulement construire un paquet binaire.
|
|
|
-L'option
|
|
|
-.B -b
|
|
|
-indique qu'aucun fichier source n'est à construire ou à distribuer, et
|
|
|
-l'option
|
|
|
-.B -B
|
|
|
-indique en plus qu'aucun fichier, appartenant à un paquet binaire ne dépendant
|
|
|
-pas d'une architecture, n'est à distribuer.
|
|
|
-L'option
|
|
|
-.B -S
|
|
|
-indique que seul le source doit être installé et qu'on a pas besoin de
|
|
|
-construire un paquet binaire. Seul
|
|
|
-.BR dpkg-buildpackage
|
|
|
-se sert des options
|
|
|
-.BR -b " et " -B ;
|
|
|
-.B dpkg-genchanges
|
|
|
-crée seulement un fichier
|
|
|
-.B .changes
|
|
|
-pour tous les fichiers produits par la cible
|
|
|
-.B binary-*
|
|
|
-du paquet qui est construit.
|
|
|
-
|
|
|
-L'option
|
|
|
-.B -b
|
|
|
-indique à
|
|
|
-.B dpkg-source
|
|
|
-de construire un paquet source (plutôt que d'en extraire un) --
|
|
|
-voyez ci-dessous.
|
|
|
-.TP
|
|
|
-.BI -c fichier/control
|
|
|
-indique le principal fichier de contrôle des sources où trouver des
|
|
|
-renseignements. Par défaut, c'est le fichier
|
|
|
-.BR debian/control .
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -l fichier/changelog
|
|
|
-indique le fichier d'enregistrement des changements où trouver des
|
|
|
-renseignements. Par défaut, c'est le fichier
|
|
|
-.BR debian/changelog.
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -f fichier/liste-des-fichiers
|
|
|
-lit ou écrit la liste des fichiers qui doivent être mis en place dans le
|
|
|
-fichier
|
|
|
-.I fichier/liste-des-fichiers,
|
|
|
-plutôt que dans le fichier
|
|
|
-.BR debian/files.
|
|
|
-.BR dpkg-gencontrol ", " dpkg-genchanges " et " dpkg-distaddfile
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -F format-du-changelog
|
|
|
-donne le format du fichier changelog. Par défaut, c'est une ligne spéciale,
|
|
|
-près de la fin du fichier, qui l'indique (voyez le Debian packaging manual) ;
|
|
|
-sinon, on utilise le format classique
|
|
|
-.BR debian,
|
|
|
-décrit dans le
|
|
|
-.IR "Debian packaging manual".
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " et " dpkg-genchanges
|
|
|
-acceptent cette option.
|
|
|
-.TP
|
|
|
-.BI -W
|
|
|
-Cette option transforme certaines erreurs en avertissements. Seul dpkg-source
|
|
|
-l'utilise, mais
|
|
|
-.BR dpkg-buildpackage
|
|
|
-la reconnait et la transmet à
|
|
|
-.BR dpkg-source "."
|
|
|
-.TP
|
|
|
-.BI -E
|
|
|
-Cette option annule une précédente option
|
|
|
-.BR -W "."
|
|
|
-Elle n'est actuellement comprise que par
|
|
|
-.BR dpkg-buildpackage " et " dpkg-source "."
|
|
|
-.SH LES OPTIONS DE DPKG-SOURCE
|
|
|
-Quand on fournit les options communes
|
|
|
-.BR -c " et " -l
|
|
|
-avec des chemins relatifs, on considère qu'ils sont relatifs au répertoire
|
|
|
-le plus élevé de l'arborescence source.
|
|
|
-.TP
|
|
|
-.B -x
|
|
|
-Cette option sert à extraire un paquet source. On doit donner un seul argument
|
|
|
-sans option : le nom du fichier de contrôle des sources Debian
|
|
|
-.RB ( .dsc ).
|
|
|
-Aucune option n'est utile avec
|
|
|
-.BR "dpkg-source -x".
|
|
|
-.B dpkg-source
|
|
|
-lit, dans le fichier de contrôle, les noms des fichiers qui composent le
|
|
|
-paquet source ; il suppose qu'ils sont dans le même répertoire que le
|
|
|
-fichier
|
|
|
-.BR .dsc.
|
|
|
-
|
|
|
-Les fichiers extraits du paquet auront le même système de propriété et de
|
|
|
-permission que s'ils avaient été simplement crées -- les répertoires et
|
|
|
-les fichiers exécutables auront un système de permission égal à 0777 et
|
|
|
-les simples fichiers, 0666 ; ces deux systèmes étant modifiés par le
|
|
|
-masque de celui qui fait l'extraction ; Si le répertoire parent est
|
|
|
-« setgid », les répertoires extraits le seront aussi et tous les fichiers
|
|
|
-et répertoires hériteront du système de propriété de ce groupe.
|
|
|
-.TP
|
|
|
-.B -b
|
|
|
-Construire : empaqueter une arborescence. Un ou deux arguments, sans options,
|
|
|
-seront fournis. Le premier représente le nom du répertoire qui contient
|
|
|
-l'arborescence non empaquetée. Si l'on donne un second argument, ce sera le
|
|
|
-nom du répertoire source original ou bien le nom du fichier «\ tar\ » ou bien
|
|
|
-une chaîne vide si le paquet est «\ debian pure souche\ » et n'a donc pas de
|
|
|
-fichiers «\ diffs\ » concernant sa «\ debianisation\ ». S'il n'y a pas de
|
|
|
-second argument, et selon les autres arguments donnés,
|
|
|
-.B dpkg-source
|
|
|
-cherche le fichier « tar » des sources originelles
|
|
|
-.IB paquet _ version-originelle .orig.tar.gz
|
|
|
-ou bien le répertoire source originel
|
|
|
-.IB répertoire .orig
|
|
|
-ou bien une chaîne vide (pas de source originel, et donc pas de « diffs »).
|
|
|
-.TP
|
|
|
-.B -i[<regexp>]
|
|
|
-On peut donner une expression régulière Perl correspondant aux fichiers
|
|
|
-d'une liste qui doivent être filtrés pour le « diff ».
|
|
|
-(Cette liste est créée par une commande « find ».) L'option \fB-i\fR toute
|
|
|
-seule filtre les sous-répertoires CVS, RCS et libtool .deps et tous les
|
|
|
-fichiers qu'ils contiennent, aussi bien les fichiers de sauvegarde
|
|
|
-terminés par un « ~ » que ceux crées par une interruption de l'éditeur JOE.
|
|
|
-
|
|
|
-C'est très utile pour supprimer les fichiers superflus qui sont inclus dans
|
|
|
-le .diff.gz (p.ex., «\ debian/BUGS_TODO/*\ » ou «\ debian/RCS/*,v\ »). Quand
|
|
|
-on suit avec un CVS distant un paquet que l'on maintient, et qu'on a pas la
|
|
|
-possibilité d'enregistrer les fichiers debian de contrôle ou d'étiqueter
|
|
|
-\fIcvs-buildpackage(1)\fR, il faut faire un «\ checkout/update\ »
|
|
|
-supplémentaire dans un répertoire tenu vierge pour créer le fichier
|
|
|
-.orig.tar.gz. Les fichiers «\ CVS/Entries\ » de ce répertoire contiennent des
|
|
|
-dates qui diffèrent de celles du répertoire de travail ; cela provoque indûment
|
|
|
-leur inclusion dans chaque .diff.gz crée, à moins d'utiliser l'option
|
|
|
-\fB-i\fR.
|
|
|
-.TP
|
|
|
-.BR -sa , -sp , -su , -sk , -sA , -sP , -sU , -sK , -ss " avec " -b
|
|
|
-Quand on spécifie
|
|
|
-.BR -sk " ou " -sp,
|
|
|
-.B dpkg-source
|
|
|
-s'attend à ce que le source originel soit un fichier «\ tar\ » ; par défaut
|
|
|
-c'est le fichier
|
|
|
-.IB paquet _ version-originelle .orig.tar.gz\fR.
|
|
|
-Il le laisse en place en tant que fichier «\ tar\ » ou le copie dans le
|
|
|
-répertoire en cours s'il n'y est pas déjà.
|
|
|
-Quand on utilise
|
|
|
-.B -sp
|
|
|
-au lieu de
|
|
|
-.B -sk,
|
|
|
-il le supprime ensuite.
|
|
|
-
|
|
|
-Quand on spécifie
|
|
|
-.BR -su " ou " -sr,
|
|
|
-le source originel est attendu comme un répertoire ; par défaut c'est le
|
|
|
-répertoire
|
|
|
-.IB paquet - version-originelle .orig
|
|
|
-et
|
|
|
-.B dpkg-source
|
|
|
-crée une nouvelle archive du source originel.
|
|
|
-Quand on utilise
|
|
|
-.B -sr,
|
|
|
-.B dpkg-source
|
|
|
-supprime ce répertoire après usage.
|
|
|
-
|
|
|
-Quand on utilise
|
|
|
-.B -ss,
|
|
|
-.B dpkg-source
|
|
|
-s'attend à ce que le source originel soit disponible à la fois comme un
|
|
|
-répertoire et comme un fichier «\ tar\ ». Il se sert du répertoire pour créer
|
|
|
-le «\ diff\ », mais se sert du fichier «\ tar\ » pour créer le fichier
|
|
|
-.BR .dsc.
|
|
|
-On doit faire attention avec cette option -- Si le répertoire et le
|
|
|
-fichier «\ tar\ » ne correspondent pas, une mauvaise archive source en
|
|
|
-résulte.
|
|
|
-
|
|
|
-Quand on utilise
|
|
|
-.B -sn,
|
|
|
-.B dpkg-source
|
|
|
-ne cherche pas de source originel, et ne crée pas de «\ diff\ ».
|
|
|
-Le second argument, s'il existe, doit être une chaîne vide. Cela sert pour
|
|
|
-les paquets Debian pure souche qui n'ont pas un source originel distinct et
|
|
|
-donc, pas de fichier «\ diff\ » de debianisation.
|
|
|
-
|
|
|
-Quand on utilise
|
|
|
-.BR -sa " ou " -sA,
|
|
|
-.B dpkg-source
|
|
|
-cherche un source originel soit sous forme de fichier «\ tar\ », soit sous
|
|
|
-forme de répertoire -- le deuxième argument, s'il existe, ou bien une chaîne
|
|
|
-vide (cela revient à utiliser l'option
|
|
|
-.BR -sn).
|
|
|
-Quand un fichier «\ tar\ » existe, il est dépaqueté et
|
|
|
-.B dpkg-source
|
|
|
-crée un fichier «\ diff\ » ; ensuite il supprime le fichier «\ tar\ » (cela
|
|
|
-revient à utiliser l'option
|
|
|
-.BR -sp) ;
|
|
|
-quand un répertoire est trouvé, il est dépaqueté et
|
|
|
-.B dpkg-source
|
|
|
-crée le source originel et supprime ensuite ce répertoire (cela revient
|
|
|
-à utiliser l'option
|
|
|
-.BR -sr) ;
|
|
|
-Quand ni l'un ni l'autre n'est trouvé,
|
|
|
-.B dpkg-source
|
|
|
-suppose que le paquet ne possède pas de fichier «\ diff\ » de debianisation,
|
|
|
-mais seulement une simple archive source (cela revient à utiliser l'option
|
|
|
-.BR -sn).
|
|
|
-Quand les deux sont trouvés,
|
|
|
-.B dpkg-source
|
|
|
-ignore le répertoire, et le remplace si l'option
|
|
|
-.B -sA
|
|
|
-a été spécifiée (cela revient à utiliser l'option
|
|
|
-.BR -sP) ;
|
|
|
-ou bien il provoque une erreur quand l'option
|
|
|
-.B -sa
|
|
|
-a été spécifiée.
|
|
|
-L'option par défaut est
|
|
|
-.B -sA.
|
|
|
-
|
|
|
-Les options
|
|
|
-.BR -sa ", " -sp ", " -sk ", " -su " et " -sr
|
|
|
-ne remplacent pas les fichiers «\ tar\ » ou les répertoires existants. Pour
|
|
|
-cela, il faut utiliser les options
|
|
|
-.BR -sA ", " -sP ", " -sK ", " -sU " et " -sR.
|
|
|
-.TP
|
|
|
-.BR -sp , -su , -sn " avec " -x
|
|
|
-Dans tous ces cas, l'arborescence existante d'un source originel est supprimée.
|
|
|
-
|
|
|
-Quand on utilise l'option
|
|
|
-.B -sp
|
|
|
-lors d'une extraction, le source originel (s'il existe) est laissé en tant
|
|
|
-que fichier «\ tar\ ». S'il n'est pas déjà dans le répertoire en cours ou
|
|
|
-si ce répertoire contient un fichier différent, le fichier «\ tar\ » est
|
|
|
-copié dans ce répertoire. C'est le comportement par défaut.
|
|
|
-
|
|
|
-L'option
|
|
|
-.B -su
|
|
|
-dépaquète une arborescence source originelle.
|
|
|
-
|
|
|
-L'option
|
|
|
-.B -sn
|
|
|
-assure que le source originel ne sera ni copié dans le répertoire en cours,
|
|
|
-ni dépaqueté. Une arborescence source originelle présente dans le répertoire
|
|
|
-en cours est toujours supprimée.
|
|
|
-.SH LES OPTIONS POUR DPKG-GENCONTROL
|
|
|
-.B dpkg-gencontrol
|
|
|
-ne prend pas d'argument sans options.
|
|
|
-.TP
|
|
|
-.BI -p paquet
|
|
|
-cette option produit les informations concernant le paquet binaire
|
|
|
-.IR paquet.
|
|
|
-Si le fichier de contrôle des sources liste un seul paquet binaire, on peut
|
|
|
-omettre cette option ; sinon c'est indispensable d'indiquer le paquet pour
|
|
|
-lequel on veut produire les informations.
|
|
|
-.TP
|
|
|
-.BI -n nom-de-fichier
|
|
|
-Le nom du paquet est
|
|
|
-.I nom-de-fichier
|
|
|
-au lieu de l'habituel : paquet_version_arch.deb.
|
|
|
-.TP
|
|
|
-.BR -is ", " -ip ", " -isp
|
|
|
-ces options incluent, dans le fichier de contrôle du paquet binaire, les champs
|
|
|
-.BR Section " et " Priority
|
|
|
-qui concernent ce paquet et qui se trouvent dans le fichier principal de
|
|
|
-contrôle des sources. Habituellement on ne met pas ces informations là
|
|
|
-mais dans le fichier
|
|
|
-.B .changes.
|
|
|
-L'option
|
|
|
-.B -isp
|
|
|
-inclue les deux champs,
|
|
|
-.BR -is " seulement le champ " Section " et " -ip " seulement le champ " Priority .
|
|
|
-.TP
|
|
|
-.BI -P rep-de-construction-du-paquet
|
|
|
-Cette option indique à
|
|
|
-.B dpkg-source
|
|
|
-que le répertoire de construction du paquet est
|
|
|
-.I rep-de-construction-du-paquet
|
|
|
-au lieu de
|
|
|
-.BR debian/tmp.
|
|
|
-Cette valeur sert à trouver la valeur par défaut de la variable de
|
|
|
-substitution
|
|
|
-.B Installed-Size
|
|
|
-et celle du champ correspondant dans le fichier de contrôle (on utilise la
|
|
|
-commande
|
|
|
-.BR du ) ;
|
|
|
-elle donne aussi l'emplacement par défaut pour le fichier de sortie.
|
|
|
-.TP
|
|
|
-.B -O
|
|
|
-Cette option provoque l'affichage du fichier de contrôle sur la sortie
|
|
|
-standard au lieu de
|
|
|
-.B debian/tmp/DEBIAN/control
|
|
|
-(ou
|
|
|
-.IB rep-de-construction-du-paquet /DEBIAN/control
|
|
|
-si l'option
|
|
|
-.B -P
|
|
|
-a été utilisée).
|
|
|
-.SH LES OPTIONS POUR DPKG-SHLIBDEPS
|
|
|
-.B dpkg-shlibdeps
|
|
|
-interprète des arguments sans option comme des commandes
|
|
|
-exécutables, comme si on avait simplement donné
|
|
|
-.BI -e exécutable\fR.
|
|
|
-.TP
|
|
|
-.BI -e exécutable
|
|
|
-Cette option inclue les bonnes dépendances envers les bibliothèques partagées
|
|
|
-que demande
|
|
|
-.IR exécutable.
|
|
|
-.TP
|
|
|
-.BI -d champ-dépendance
|
|
|
-Cette option ajoute les dépendances destinées au champ « dépendance » du
|
|
|
-fichier de contrôle
|
|
|
-.IR champ-dépendance.
|
|
|
-(Les dépendances pour ce champ sont dans la variable
|
|
|
-.BI shlibs: champ-dépendance\fR.)
|
|
|
-
|
|
|
-L'option
|
|
|
-.BI -d champ-dépendance
|
|
|
-concerne tous les exécutables qui suivent l'option, jusqu'à la prochaine option
|
|
|
-.BI -d champ-dépendance\fR.
|
|
|
-Par défaut,
|
|
|
-.I champ-dépendance
|
|
|
-vaut
|
|
|
-.BR Depends .
|
|
|
-
|
|
|
-Quand, dans plusieurs champs reconnus ayant trait aux dépendances comme
|
|
|
-les champs
|
|
|
-.BR Pre-Depends ", " Depends ", " Recommends ", " Enhances " ou " Suggests,
|
|
|
-apparaît la même entrée (ou bien un ensemble d'alternatives)
|
|
|
-.B dpkg-shlibdeps
|
|
|
-supprime automatiquement les dépendances dans tous les champs sauf celui qui
|
|
|
-représente les dépendances les plus importantes.
|
|
|
-.TP
|
|
|
-.BI -p préfixe-pour-le-nom-des-variables
|
|
|
-Les variables de substitution commenceront par
|
|
|
-.IB préfixe-pour-le-nom-des-variables :
|
|
|
-au lieu de
|
|
|
-.BR shlib: .
|
|
|
-De même, toute variable de substitution commençant par
|
|
|
-.IB préfixe-pour-le-nom-des-variables :
|
|
|
-(au lieu de
|
|
|
-.BR shlib: )
|
|
|
-sont enlevés du fichier de substitution des variables.
|
|
|
-.TP
|
|
|
-.BI -L fichier-local-shlibs
|
|
|
-.B dpkg-shlibs
|
|
|
-lira les information de remplacement concernant les dépendances envers les
|
|
|
-bibliothèques partagées dans
|
|
|
-.I fichier-local-shlibs
|
|
|
-au lieu de
|
|
|
-.BR debian/shlibs.local .
|
|
|
-.TP
|
|
|
-.B -O
|
|
|
-Les définitions des variables de substitution seront affichées sur la sortie
|
|
|
-standard, plutôt qu'ajoutées dans le fichier de substitution des variables qui
|
|
|
-est par défaut
|
|
|
-.RB debian/substvars.
|
|
|
-.SH LES OPTIONS DE DPKG-GENCHANGES
|
|
|
-.B dpkg-genchanges
|
|
|
-ne prend pas d'argument sans options.
|
|
|
-.TP
|
|
|
-.BI -u répertoire-des-fichiers-à-installer
|
|
|
-Cherche les fichiers à installer dans
|
|
|
-.I répertoire-des-fichiers-à-installer
|
|
|
-plutôt que dans
|
|
|
-.B ..
|
|
|
-.RB ( dpkg-genchanges
|
|
|
-doit trouver ces fichiers de manière à mettre leurs tailles et leurs sommes de
|
|
|
-contrôle dans le fichier
|
|
|
-.B .changes.)
|
|
|
-.TP
|
|
|
-.B -q
|
|
|
-.B dpkg-genchanges
|
|
|
-affiche habituellement des messages d'information sur la sortie d'erreur
|
|
|
-standard ; par exemple, combien de fichiers source du paquet sont en cours
|
|
|
-d'installation.
|
|
|
-.B -q
|
|
|
-supprime ces messages.
|
|
|
-.SH LES OPTIONS DE DPKG-BUILDPACKAGE
|
|
|
-.B dpkg-buildpackage
|
|
|
-ne prend pas d'arguments sans options.
|
|
|
-.TP
|
|
|
-.BI -k key-id
|
|
|
-Précise un « key-ID » pour la signature des paquets.
|
|
|
-.TP
|
|
|
-.BI -r commande-pour-obtenir-privilèges-de-root
|
|
|
-Quand
|
|
|
-.B dpkg-buildpackage
|
|
|
-doit exécuter une partie du processus de construction en tant que root,
|
|
|
-il préfixe la commande exécutée par
|
|
|
-.I commande-pour-obtenir-privilèges-de-root
|
|
|
-si elle existe.
|
|
|
-.I commande-pour-obtenir-privilèges-de-root
|
|
|
-sera le nom d'un programme présent dans le
|
|
|
-.B PATH
|
|
|
-et ce programme prend comme argument le nom de la commande réelle à
|
|
|
-exécuter et les arguments qu'elle doit prendre.
|
|
|
-.I commande-pour-obtenir-privilèges-de-root
|
|
|
-ne contiendra pas d'espace ni aucun « métacaractère » du shell.
|
|
|
-.\" Que se passe-t-il si elle contient des espaces ? (hs)
|
|
|
-.I commande-pour-obtenir-privilèges-de-root
|
|
|
-est classiquement
|
|
|
-.BR sudo ", " super " ou " really .
|
|
|
-.B su
|
|
|
-ne va pas, puisque ce programme demande une option
|
|
|
-.B -c
|
|
|
-pour exécuter une commande ; et même alors il ne peut qu'appeler le shell
|
|
|
-de l'utilisateur au lieu de passer directement les arguments à la commande
|
|
|
-qui doit être exécutée.
|
|
|
-.TP
|
|
|
-.BI -p commande-de-signature
|
|
|
-Quand
|
|
|
-.B dpkg-buildpackage
|
|
|
-doit exécuter GPG ou PGP pour signer un fichier source de contrôle
|
|
|
-.RB ( .dsc )
|
|
|
-ou un fichier
|
|
|
-.B .changes,
|
|
|
-il exécute
|
|
|
-.I commande-de-signature
|
|
|
-(en examinant le
|
|
|
-.B PATH
|
|
|
-si nécessaire) au lieu de
|
|
|
-.BR pgp .
|
|
|
-.I commande-de-signature
|
|
|
-obtient tous les arguments qu'aurait obtenu
|
|
|
-.B pgp.
|
|
|
-Si
|
|
|
-.I commande-de-signature
|
|
|
-veut recevoir ses arguments à la manière GPG plutôt qu'à la manière PGP,
|
|
|
-on choisira l'option
|
|
|
-.B -sgpg.
|
|
|
-.I commande-de-signature
|
|
|
-ne contiendra pas d'espace ni aucun «\ métacaractère\ » du shell.
|
|
|
-.TP
|
|
|
-.B -tc
|
|
|
-Nettoyage de l'arborescence (en utilisant
|
|
|
-.I commande-pour-obtenir-privilèges-de-root
|
|
|
-.BR "debian/rules clean" )
|
|
|
-après la construction du paquet.
|
|
|
-.TP
|
|
|
-.BR -us ", " -uc
|
|
|
-Ne pas signer, respectivement, soit le paquet source, soit le fichier
|
|
|
-«\ .changes\ ».
|
|
|
-.TP
|
|
|
-.BI -a architecture
|
|
|
-Précise l'architecture Debian pour laquelle on construit. L'architecture de la
|
|
|
-machine sur laquelle on construit est automatiquement déterminée ; c'est aussi
|
|
|
-l'architecture par défaut de la machine hôte.
|
|
|
-.TP
|
|
|
-.B -i[<regexp>]
|
|
|
-chaîne passée telle quelle à
|
|
|
-.BR dpkg-source.
|
|
|
-.TP
|
|
|
-.B -D
|
|
|
-Vérifier les dépendances de constructions et les conflits ; se termine en cas
|
|
|
-de problèmes.
|
|
|
-.TP
|
|
|
-.B -d
|
|
|
-Ne pas vérifier les dépendances de constructions et les conflits.
|
|
|
-.TP
|
|
|
-.B -nc
|
|
|
-Ne pas nettoyer l'arborescence source (imlies -b)
|
|
|
-.TP
|
|
|
-.SH LES ARGUMENTS DE DPKG-DISTADDFILE
|
|
|
-.B dpkg-distaddfile
|
|
|
-ne prend pas d'option particulière. Il prend trois arguments sans options,
|
|
|
-à savoir le nom du fichier, la section et la priorité, pour le fichier
|
|
|
-.B .changes.
|
|
|
-
|
|
|
-Le nom du fichier sera indiqué relativement au répertoire dans lequel
|
|
|
-.B dpkg-genchanges
|
|
|
-s'attend à trouver les fichiers, habituellement
|
|
|
-.BR .. ,
|
|
|
-plutôt que relativement au répertoire dans lequel est exécuté
|
|
|
-.B dpkg-distaddfile.
|
|
|
-.SH LES ARGUMENTS DE DPKG-PARSECHANGELOG
|
|
|
-.B dpkg-parsechangelog
|
|
|
-ne prend ni d'option particulière ni d'argument sans options.
|
|
|
-.SH LA SUBSTITUTION DE VARIABLE
|
|
|
-Avant que
|
|
|
-.BR dpkg-source ", " dpkg-gencontrol " et " dpkg-genchanges
|
|
|
-n'écrivent leurs informations de contrôle (dans le fichier source de contrôle
|
|
|
-.B .dsc
|
|
|
-pour
|
|
|
-.B dpkg-source
|
|
|
-et sur la sortie standard pour
|
|
|
-.BR dpkg-gencontrol " et " dpkg-genchanges),
|
|
|
-ils accomplissent quelques substitutions de variable dans le fichier de
|
|
|
-sortie.
|
|
|
-
|
|
|
-Une substitution de variable est de la forme :
|
|
|
-.BI ${ variable-name }\fR.
|
|
|
-Les noms de variable consistent en caractères alphanumériques, traits d'union
|
|
|
-et «\ deux points\ » ; ils commencent par une lettre ou un chiffre.
|
|
|
-La substitution se fait répétitivement jusqu'à ce qu'il n'en reste aucune à
|
|
|
-faire ; le texte entier du champ après la substitution est réexaminé pour
|
|
|
-chercher d'autres substitutions.
|
|
|
-
|
|
|
-Quand toutes les substitutions ont été faites, chaque occurrence de la
|
|
|
-chaîne
|
|
|
-.B ${}
|
|
|
-(laquelle n'est pas une substitution autorisée) est remplacée par un signe
|
|
|
-.B $.
|
|
|
-
|
|
|
-On peut définir les variables en utilisant l'option commune
|
|
|
-.B -V.
|
|
|
-On peut aussi se servir du fichier
|
|
|
-.B debian/substvars
|
|
|
-(ou tout autre fichier avec l'option
|
|
|
-.B -T).
|
|
|
-Ce fichier est composé de lignes de la forme suivante :
|
|
|
-.IB name = value\fR.
|
|
|
-Les espaces résiduels sur chaque ligne, les lignes vides et les lignes qui
|
|
|
-commencent par un symbole
|
|
|
-.B #
|
|
|
-sont ignorés.
|
|
|
-
|
|
|
-En outre, les variables standards suivantes sont disponibles :
|
|
|
-.TP
|
|
|
-.BI Arch
|
|
|
-L'architecture pour laquelle on construit (tirée de
|
|
|
-.BR "dpkg \-\-print-architecture" ).
|
|
|
-.TP
|
|
|
-.B Source-Version
|
|
|
-La version du paquet source (tirée du fichier changelog).
|
|
|
-.TP
|
|
|
-.B Installed-Size
|
|
|
-La taille de tous les fichiers installés du paquet. Cette valeur est copiée
|
|
|
-dans le champ adéquat du fichier « control » ; Quand on fixe cette variable,
|
|
|
-cela modifie la valeur de ce champ. Quand elle est indéterminée,
|
|
|
-.B dpkg-gencontrol
|
|
|
-use de la commande
|
|
|
-.B du -k debian/tmp
|
|
|
-pour trouver une valeur par défaut.
|
|
|
-.TP
|
|
|
-.B Extra-Size
|
|
|
-L'espace disque supplémentaire utilisé pour l'installation du paquet.
|
|
|
-Quand on fixe cette variable, on ajoute sa valeur à la valeur de la variable
|
|
|
-.B Installed-Size
|
|
|
-(qu'elle soit définie explicitement ou calculée par défaut) avant que la
|
|
|
-variable
|
|
|
-.B Installed-Size
|
|
|
-ne soit copiée dans le champ du fichier «\ control\ ».
|
|
|
-.TP
|
|
|
-.BI F: fieldname
|
|
|
-La valeur du champ
|
|
|
-.IR fieldname
|
|
|
-affiché en sortie et qui doit être classiquement en majuscules. Quand on
|
|
|
-fixe ces variables,
|
|
|
-cela ne prend effet que là où elles sont effectivement développées.
|
|
|
-.TP
|
|
|
-.B Format
|
|
|
-La version du format du fichier
|
|
|
-.B .changes
|
|
|
-produite par la version des scripts construisant le source. Quand on
|
|
|
-détermine cette variable, le contenu du champ
|
|
|
-.B Format
|
|
|
-dans le fichier
|
|
|
-.B .changes
|
|
|
-est aussi modifié.
|
|
|
-.TP
|
|
|
-.BR Newline ", " Space ", " Tab
|
|
|
-Ces variables contiennent chacune le caractère correspondant.
|
|
|
-.TP
|
|
|
-.BI shlibs: dependencyfield
|
|
|
-Les variables déterminées de cette façon sont produites par
|
|
|
-.B dpkg-shlibdeps
|
|
|
-- voyez plus haut.
|
|
|
-.LP
|
|
|
-Quand une variable est référencée mais n'est pas définie, cela produit
|
|
|
-un avertissement et une valeur nulle est assumée.
|
|
|
-.SH FICHIERS
|
|
|
-.TP
|
|
|
-.B debian/control
|
|
|
-Le principal fichier d'information sur les sources ; il donne des
|
|
|
-renseignements qui ne dépendent pas d'une version concernant le paquet
|
|
|
-source et les paquets binaires qui peuvent être créés.
|
|
|
-.TP
|
|
|
-.B debian/changelog
|
|
|
-Le fichier d'enregistrement des modifications ; on s'en sert pour connaître
|
|
|
-les informations qui dépendent d'une version du paquet source, par exemple
|
|
|
-l'urgence ou la distribution d'une installation sur le serveur, les
|
|
|
-modifications faites depuis telle édition et le numéro de la version source
|
|
|
-lui-même.
|
|
|
-.TP
|
|
|
-.B debian/files
|
|
|
-la liste des fichiers créés qui seront installés sur le serveur.
|
|
|
-.B dpkg-gencontrol
|
|
|
-ajoute les noms présumés des fichiers des paquets binaires à partir des
|
|
|
-fichiers « control » qu'il crée ; pour ajouter d'autres fichiers on peut se
|
|
|
-servir de
|
|
|
-.B dpkg-distaddfile.
|
|
|
-.B dpkg-genchanges
|
|
|
-lit dans ce fichier les données nécessaires à la création du fichier
|
|
|
-.B .changes.
|
|
|
-
|
|
|
-.TP
|
|
|
-.B debian/substvars
|
|
|
-La liste des variables de substitution et leurs valeurs.
|
|
|
-.TP
|
|
|
-.B debian/shlibs.local
|
|
|
-Fichier particulier à un paquet remplaçant les informations qui concernent les
|
|
|
-dépendances envers des bibliothèques partagées.
|
|
|
-.TP
|
|
|
-.B /etc/dpkg/shlibs.override
|
|
|
-Fichier système remplaçant les informations qui concernent les dépendances
|
|
|
-envers des bibliothèques partagées.
|
|
|
-.TP
|
|
|
-.B /etc/dpkg/shlibs.default
|
|
|
-Fichier système par défaut concernant les informations de dépendances envers
|
|
|
-des bibliothèques partagées.
|
|
|
-.SH BOGUES
|
|
|
-Le moment où a lieu le remplacement d'un champ par rapport à certaines
|
|
|
-déterminations de champ affiché sur la sortie standard est plutôt embrouillé.
|
|
|
-.\" et cette phrase aussi !
|
|
|
-
|
|
|
-On opère deux fois la substitution de variable sur les entrées d'un paquet
|
|
|
-binaire dans le fichier
|
|
|
-.B debian/files.
|
|
|
-Cela ne devrait pas poser de problèmes puisque
|
|
|
-.BR $ ", " { " et " }
|
|
|
-ne sont pas permis dans les noms de paquets et les numéros de version.
|
|
|
-
|
|
|
-On devrait pouvoir mettre des espaces et des métacaractères du shell dans les
|
|
|
-arguments initiaux de
|
|
|
-.IR commande-pour-obtenir-privilèges-de-root " et " commande-de-signature .
|
|
|
-.SH VOIR AUSSI
|
|
|
-.IR "Debian packaging manual" ,
|
|
|
-.br
|
|
|
-.IR "Debian policy manual" ,
|
|
|
-.br
|
|
|
-.BR dpkg\-deb (1),
|
|
|
-.BR dpkg (8),
|
|
|
-.BR dselect (8),
|
|
|
-.BR gpg (1),
|
|
|
-.BR pgp (1).
|
|
|
-.SH AUTEUR
|
|
|
-Ces outils et cette page de manuel ont été écrits par Ian Jackson.
|
|
|
-.SH COPYRIGHT
|
|
|
-Copyright (C) 1995-1996 Ian Jackson
|
|
|
-.br
|
|
|
-Copyright (C) 2000 Wichert Akkerman
|
|
|
-.br
|
|
|
-Ce sont des logiciels libres ; voyez la «\ GNU General Public Licence\ »
|
|
|
-version 2 ou supérieure pour le copyright. Il n'y a
|
|
|
-.B pas
|
|
|
-de garantie. Voyez
|
|
|
-.B /usr/share/doc/dpkg/copyright
|
|
|
-et
|
|
|
-.B /usr/share/common-licenses/GPL
|
|
|
-pour des précisions.
|
|
|
-.SH TRADUCTION
|
|
|
-Philippe Batailler, Février 2001.
|
Wichert Akkerman