.\" Hey, EMACS: -*- nroff -*- .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH COWPOKE 1 "28 avril 2008" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: .\" .nh disable hyphenation .\" .hy enable hyphenation .\" .ad l left justify .\" .ad b justify to both left and right margins .\" .nf disable filling .\" .fi enable filling .\" .br insert line break .\" .sp insert n+1 empty lines .\" for manpage-specific macros, see man(7) .SH NOM cowpoke \- Construire un paquet source Debian dans une instance de cowbuilder distante .SH SYNOPSIS \fBcowpoke\fP [\fIoptions\fP]\fI paquet.dsc\fP .SH DESCRIPTION Envoyer un paquet source Debian à un hôte \fBcowbuilder\fP et construire le paquet. Le paquet résultant peut également être signé et envoyé dans une file d'attente. .SH OPTIONS Les options suivantes sont disponibles\ : .TP \fB\-\-arch=\fP\fIarchitecture\fP Indiquer la ou les architectures Debian pour lesquelles le paquet doit être construit. Une liste d'architectures séparées par des espaces peut être utilisée pour construire le paquet pour toutes ces architectures en une seule passe. Les noms d'architecture supportés sont ceux renvoyés par \fBdpkg\-architecture\fP(1) pour \fBDEB_BUILD_ARCH\fP. .TP \fB\-\-dist=\fP\fIdistribution\fP Indiquer la ou les distributions Debian pour lesquelles le paquet doit être construit. Une liste de distributions séparées par des espaces peut être utilisée pour construire le paquet pour toutes ces distributions en une seule passe. Des noms de code (comme \fBsid\fP ou \fBsqueeze\fP) ou des noms de distribution (comme \fBunstable\fP ou \fBexperimental\fP) peuvent être utilisés, mais vous devriez toujours utiliser un type de noms ou l'autre parce que c'est ce nom qui est utilisé pour les chemins de fichier et pour trouver les anciens paquets utilisés pour les rapports de comparaison. Utiliser des noms définis localement est maintenant aussi possible avec cette option, quand elle est utilisée conjointement à l’option \fBBASE_DIST\fP dans un fichier de configuration. Cela permet la maintenance et l’utilisation de chroots de construction configurés spécialement, afin par exemple de fournir les dépendances de paquet des archives de rétroportages ou d’un dépôt local, ou de définir des options de configuration non habituelles, sans polluer les chroots propres utilisés pour les constructions de paquet à destination des dépôts principaux. Consultez la description de \fBBASE_DIST\fP ci\-dessous. .TP \fB\-\-buildd=\fP\fIhôte\fP Indiquer l'hôte distant sur lequel se fera la construction. .TP \fB\-\-buildd\-user=\fP\fInom\fP Indiquer l'utilisateur distant à utiliser pour la construction. .TP \fB\-\-create\fP Créer la racine \fBcowbuilder\fP distante si elle n'existe pas encore. Si cette option n'est pas fournie, une distribution ou architecture (indiquées par \fB\-\-dist\fP ou \fB\-\-arch\fP) qui n'aurait pas de racine \fBcowbuilder\fP sera considérée comme une erreur. L’utilisateur indiqué par \fB\-\-buildd\-user\fP doit avoir le droit de créer \fBRESULT_DIR\fP sur l’hôte de construction, sinon un administrateur avec les droits nécessaires doit d’abord le créer et donner à cet utilisateur (ou à un groupe dont il fait partie) accès en écriture à ce répertoire, afin que cette option réussisse. .TP \fB\-\-return=\fP[\fIchemin\fP] Copier les fichiers résultant de la construction vers \fIchemin\fP. Si aucun \fIchemin\fP n'est indiqué, ils sont alors renvoyés vers le répertoire actuel. Le \fIchemin\fP donné doit exister, il ne sera pas créé. .TP \fB\-\-no\-return\fP Ne pas copier le résultat de la construction vers \fBRETURN_DIR\fP (écrase le chemin configuré dans les fichiers de configuration). .TP \fB\-\-dpkg\-opts=\fP\fI'opt1 opt2 ...'\fP Indiquer des options supplémentaires à fournir à \fBdpkg\-buildpackage\fP(1). les différentes options sont séparées par des espaces. Cela remplacera toute option fournie par la variable \fBDEBBUILDOPTS\fP du fichier \fIpbuilderrc\fP de la machine de construction. .TP \fB\-\-create\-opts=\fP\fI'option de cowbuilder'\fP Indiquer des arguments supplémentaires à passer directement à \fBcowbuilder\fP quand un chroot est créé (en utilisant l’option \fB\-\-create\fP précédente). Si plusieurs arguments doivent être passés, cette option devrait être indiquée séparément pour chacun. Par exemple, \fB\-\-create\-opts "\-\-othermirror" \-\-create\-opts "deb http:// \&..."\fP Cette option remplacera toutes les \fBCREATE_OPTS\fP indiquées pour un chroot dans les fichiers de configuration de \fBcowpoke\fP. .TP \fB\-\-update\-opts=\fP\fI'option de cowbuilder'\fP Indiquer des arguments supplémentaires à passer directement à \fBcowbuilder\fP si la base du chroot est mise à jour. Si plusieurs arguments doivent être passés, cette option devrait être indiquée séparément pour chacun. Cette option remplacera toutes les \fBUPDATE_OPTS\fP indiquées pour un chroot dans les fichiers de configuration de \fBcowpoke\fP. .TP \fB\-\-build\-opts=\fP\fI'option de cowbuilder'\fP Indiquer des arguments supplémentaires à passer directement à \fBcowbuilder\fP quand un paquet est construit. Si plusieurs arguments doivent être passés, cette option devrait être indiquée séparément pour chacun. Cette option remplacera toutes les \fBBUILD_OPTS\fP indiquées pour un chroot dans les fichiers de configuration de \fBcowpoke\fP. .TP \fB\-\-sign=\fP\fIidentifiant_clef\fP Indiquer la clef à utiliser pour signer les paquets. Cela remplacera toutes les \fBSIGN_KEYID\fP indiquées pour un chroot dans les fichiers de configuration de \fBcowpoke\fP. .TP \fB\-\-upload=\fP\fIfile\fP Indiquer la \fIfile\fP dput à utiliser pour envoyer les paquets signés. Cela remplacera toutes les \fBUPLOAD_QUEUE\fP indiquées pour un chroot dans les fichiers de configuration de \fBcowpoke\fP. .TP \fB\-\-help\fP Afficher un bref résumé des options disponibles et de la configuration en cours. .TP \fB\-\-version\fP Afficher les informations sur la version. .SH "OPTIONS DE CONFIGURATION" Quand \fBcowpoke\fP est exécuté, les options de configuration suivantes sont lues dans le fichier de configuration global, celui de l'utilisateur et du projet, s'ils sont présents. Les chemins peuvent être indiqués de façon absolue ou relative (les chemins étant alors relatifs au répertoire personnel de l'utilisateur \fBBUILDD_USER\fP). Les chemins étant généralement fournis entre guillemets, l'expansion des tildes ne sera \fBpas\fP réalisée. .SS "Valeurs globales par défaut" Elles s'appliquent à chaque \fIarch\fPitecture et \fIdist\fPribution lors d'un appel à cowpoke. .TP \fBBUILDD_HOST\fP L'adresse réseau ou le nom complètement qualifié (FQDN) de la machine de construction où \fBcowbuilder\fP est configuré. Elle peut être modifiée avec l'option en ligne de commande \fB\-\-buildd\fP. .TP \fBBUILDD_USER\fP Le nom de l'utilisateur, non privilégié, sur la machine de construction. Le nom par défaut est le nom de l'utilisateur local qui exécute \fBcowpoke\fP (ou le nom d'utilisateur précisé dans la configuration SSH pour \fBBUILDD_HOST\fP), et le nom fournit par la variable d'environnement peut être remplacé avec l'option \fB\-\-buildd\-user\fP en ligne de commande. .TP \fBBUILDD_ARCH\fP La ou les architectures Debian pour lesquelles il faut construire les paquets. Cela doit correspondre à la valeur de \fBDEB_BUILD_ARCH\fP du chroot de construction utilisé. La valeur par défaut est l'architecture de la machine sur laquelle \fBcowpoke\fP est exécutée, et l'architecture peut être remplacée avec l'option \fB\-\-arch\fP en ligne de commande. Une liste d'architectures séparées par des espaces (il peut être nécessaire de fournir le tout entre guillemets) peut être utilisée pour construire les paquets pour toutes ces architectures en une seule passe. .TP \fBBUILDD_DIST\fP La ou les distributions Debian pour lesquelles il faut construire les paquets. Une liste de distributions séparées par des espaces (il peut être nécessaire de fournir le tout entre guillemets) peut être utilisée pour construire les paquets pour toutes ces architectures en une seule passe. La ou les distributions peuvent être remplacées avec l'option \fB\-\-dist\fP en ligne de commande. .TP \fBINCOMING_DIR\fP Le chemin du répertoire sur la machine de construction où sont placés initialement les paquets source. Il doit être accessible en écriture par l'utilisateur \fBBUILDD_USER\fP. .TP \fBPBUILDER_BASE\fP La racine du système de fichiers pour tous les fichiers CoW et les fichiers résultats. Des sous\-répertoires spécifiques aux \fIarch\fPitectures et aux \fIdist\fPributions seront normalement créés sous cette racine. Le cache d'apt et les répertoires temporaires de construction se trouveront également sous ce chemin. .TP \fBSIGN_KEYID\fP Si cette option est activée, elle doit contenir l'identifiant de la clef GPG à fournir à \fBdebsign\fP(1) si les paquets doivent être signés sur la machine distante. Il vous sera demandé si vous souhaitez signer les paquets après que toutes les constructions sont finies. Si cette option n'est pas activée ou si elle contient une chaîne vide, aucune tentative de signature ne sera effectuée. Elle peut être remplacée de façon spécifique à une \fIarch\fPitecture et une \fIdist\fPribution avec l’option \fIarch\fP\fB_\fP\fIdist\fP\fB_SIGN_KEYID\fP décrite ci\-dessous, ou par invocation avec l’option \fB\-\-sign\fP en ligne de commande. .TP \fBUPLOAD_QUEUE\fP Si cette option est activée, elle doit contenir une indication d'hôte pour \fBdput\fP(1) qui sera utilisée pour envoyer les paquets après qu'ils ont été signés. Il vous sera demandé de confirmer si vous souhaitez envoyer les paquets après qu'ils ont été signés. Si cette option n'est pas activée ou si elle contient une chaîne vide, aucune tentative d'envoi ne sera effectuée. Si \fBSIGN_KEYID\fP n'est pas activée, cette option sera complètement ignorée. Elle peut être remplacée de façon spécifique à une \fIarch\fPitecture et une \fIdist\fPribution avec l’option \fIarch\fP\fB_\fP\fIdist\fP\fB_UPLOAD_QUEUE\fP décrite ci\-dessous, ou par invocation avec l’option \fB\-\-upload\fP en ligne de commande. .TP \fBBUILDD_ROOTCMD\fP La commande à utiliser pour obtenir les droits du superutilisateur sur la machine distante de construction. Si elle n'est pas définie, la commande par défaut est \fBsudo\fP(8). Elle n'est nécessaire que pour appeler \fBcowbuilder\fP et lui permettre d'entrer dans son chroot. Vous pouvez donc n'autoriser cet utilisateur à acquérir des droits supplémentaires que pour l'exécution de cette commande. La ligne suivante dans sudoers permettra d'appeler \fBcowbuilder\fP sans avoir à fournir de mot de passe\ : .TP \fB\& \&\fR .RS 1.5i utilisateur ALL = NOPASSWD: /usr/sbin/cowbuilder .RE .TP \fB\& \&\fR Autrement, vous pouvez utiliser SSH avec une clef ou tout autre mécanisme correspondant à votre politique locale. \fBsu \-c\fP n'est pas vraiment utilisable ici parce qu'il nécessite de placer des guillemets autour, contrairement aux autres. .TP \fBDEBOOTSTRAP\fP L'utilitaire à utiliser pour créer une nouvelle racine de construction. Les possibilités sont \fBdebootstrap\fP ou \fBcdebootstrap\fP. .TP \fBRETURN_DESTDIR\fP Si elle est définie, les fichiers de paquet issus de la construction seront copiés à l'endroit (local ou distant) configuré, une fois la construction terminée. Le chemin doit exister, il ne sera pas créé. Cette option n'est pas définie par défaut et peut être écrasée par \fB\-\-return\fP ou \fB\-\-no\-return\fP. .SS "Options spécifiques à des architectures ou distributions" Ce sont des variables de la forme $arch_$dist\fB_VAR\fP qui ne s'appliquent qu'à une cible de construction spécifique à une architecture et à une distribution. .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_RESULT_DIR\fP Le chemin du répertoire de la machine de construction où les paquets résultants (source et binaires) seront trouvés, et où les versions ultérieures des paquets ayant été précédemment construits pourront être trouvées. Si des anciens paquets sont trouvés, \fBdebdiff\fP sera utilisé pour comparer le nouveau paquet avec la version précédente une fois la construction finie, et le résultat se trouvera dans le journal de construction. Les fichiers du répertoire doivent être lisibles par \fBBUILDD_USER\fP pour les vérifications par \fBlintian\fP(1) et \fBdebdiff\fP(1) ainsi que pour les envois par \fBdput\fP(1). Si cette option n'est pas définie pour certaines combinaisons d'architectures et de distributions, alors le chemin par défaut sera \fI$PBUILDER_BASE/$arch/$dist/result\fP .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_BASE_PATH\fP Le répertoire ou les fichiers CoW maîtres se trouvent (ou là où ils sont créés si l'option en ligne de commande \fB\-\-create\fP est utilisée). Si cette option n'est pas définie pour une combinaison d'architecture et de distribution, alors le chemin par défaut est \fI$PBUILDER_BASE/$arch/$dist/base.cow\fP .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_BASE_DIST\fP Le nom de code à passer à l’option \fB\-\-distribution\fP de \fBcowbuilder\fP à la place de \fIdist\fP. C’est nécessaire quand \fIdist\fP est un nom localement significatif utilisé pour un chroot de construction configuré spécialement, comme par exemple «\ wheezy_backports\ », et non le nom de suite formel d’une \fIdist\fPribution connue de debootstrap. Cette option ne peut pas être remplacée en ligne de commande, puisqu’il n’y pas vraiment de raison de la modifier pour les appels individuels de \fBcowpoke\fP. Si cette option n’est pas indiquée pour une combinaison d’\fIarch\fPitecture et de \fIdist\fPribution, alors la \fIdist\fPribution est utilisée par défaut. .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_CREATE_OPTS\fP Un tableau bash contenant des options supplémentaires à passer directement à \fBcowbuilder\fP quand un chroot est créé (en utilisant l’option \fB\-\-create\fP). C’est pratique quand des options comme \fB\-\-othermirror\fP sont voulues pour créer des configurations spéciales de chroot, comme par exemple «\ wheezy_backports\ ». Par défaut il n’est pas défini. Toutes les valeurs définie dans ce tableaux seront ignorées si l’option \fB\-\-create\-opts\fP est passée en ligne de commande. Chaque élément de ce tableau correspond à un seul argument (dans le sens de ARGV) qui sera passé à \fBcowbuilder\fP. Cela permet à ces arguments, qui pourraient contenir des espaces, avoir des besoins de protection bizarre ou d’autres caractères spéciaux, de pas ne pas être déformés avant d’atteindre \fBcowbuilder\fP. Les tableaux bash sont initialisés un utilisant le format suivant\ : OPTS=( "arg1" "arg 2" "\-\-option" "valeur" "\-\-opt=val" "etc." ) .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_UPDATE_OPTS\fP Un tableau bash contenant des options supplémentaires à passer directement à \fBcowbuilder\fP à chaque fois que la base de ce chroot est mise à jour. Le comportement est similaire à l’option \fBCREATE_OPTS\fP précédente, à part qu’il est déclenché quand le chroot est mis à jour. .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_BUILD_OPTS\fP Un tableau bash contenant des options supplémentaires à passer directement à \fBcowbuilder\fP quand un paquet est construit. C’est pratique pour utiliser une option comme \fB\-\-twice\fP que cowpoke n’a pas besoin de gérer directement. Le comportement est sinon similaire à l’option \fBUPDATE_OPTS\fP précédente, à part qu’il est déclenché pendant la phase de construction par \fBcowbuilder\fP. .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_SIGN_KEYID\fP Un remplacement facultatif de l’option \fBSIGN_KEYID\fP globale, spécifique à une \fIarch\fPitecture et une \fIdist\fPribution. .TP \fIarch\fP\fB_\fP\fIdist\fP\fB_UPLOAD_QUEUE\fP Un remplacement facultatif de l’option \fBUPLOAD_QUEUE\fP globale, spécifique à une \fIarch\fPitecture et une \fIdist\fPribution. .SH "FICHIERS DE CONFIGURATION" .TP \fI/etc/cowpoke.conf\fP Options de configuration globales. Elles remplaceront les valeurs par défaut codées en dur. .TP \fI~/.cowpoke\fP Options de configuration de l'utilisateur. Elles remplaceront les valeurs des options de configuration globales. .TP \&\fI.cowpoke\fP Options de configuration du projet. Elles remplaceront les valeurs des options de configuration globale ou de l'utilisateur si \fBcowpoke\fP est appelé depuis le répertoire où se trouve le fichier. Si la variable d'environnement \fBCOWPOKE_CONF\fP est définie, elle indique un fichier de configuration supplémentaire qui remplacera tous les autres. Les options utilisées explicitement sur la ligne de commande remplacent les options provenant des fichiers de configuration. .SH "CONFIGURATION DE COWBUILDER" Il n'y a rien de particulier à faire pour configurer une instance de \fBcowbuilder\fP pour qu'elle puisse être utilisée avec \fBcowpoke\fP. Créez\-la simplement telle que vous en avez besoin avec «\ \fBcowbuilder \-\-create\fP\ » en suivant la documentation de \fBcowbuilder\fP, puis configurez \fBcowpoke\fP avec les informations sur l'utilisateur, l'architecture et le chemin nécessaire pour y accéder sur les machines où vous souhaitez l'appeler (ou configurez \fBcowpoke\fP avec les informations sur le chemin, l'architecture et la distribution et fournissez lui l'option \fB\-\-create\fP lors du premier appel). L'hôte de construction sur lequel \fBcowbuilder\fP tourne n'a pas besoin que \fBcowpoke\fP soit installé localement. La machine de construction doit avoir les paquets \fBlintian\fP et \fBdevscripts\fP installés pour les vérifications en fin de construction. Une fois la construction finie, un journal et les résultats des tests automatiques seront enregistrés dans \fBINCOMING_DIR\fP. Si vous souhaitez envoyer des paquets signés, \fBdput\fP(1) devra également être installé sur la machine de construction et devra être configuré pour utiliser l'alias \fIhôte\fP indiqué par \fBUPLOAD_QUEUE\fP. Si \fBrsync\fP(1) est disponible à la fois sur la machine locale et la machine de construction, alors il peut être utilisé pour transférer le paquet source (cela permet d'économiser quelques échanges de \fIorig.tar.*\fP lors de la construction des révisions Debian suivantes). L'utilisateur qui exécute \fBcowpoke\fP doit avoir un accès SSH à la machine de construction en tant que \fBBUILDD_USER\fP. Cet utilisateur doit pouvoir exécuter \fBcowbuilder\fP en tant que superutilisateur en utilisant \fBBUILDD_ROOTCMD\fP. Les clefs pour les signatures n'ont pas nécessairement à être installées sur la machine de construction (et elles seront ignorées si elles le sont). Si un paquet est signé, les clefs seront nécessaires sur la machine qui exécute \fBcowpoke\fP. Quand \fBcowpoke\fP est appelé, il cherche d'abord à mettre à jour l'image \fBcowbuilder\fP si cela n'a pas déjà été fait le même jour. Cette vérification se base sur la présence d'un fichier \fIcowbuilder\-$arch\-$dist\-update\-log\-$date\fP dans le répertoire \fBINCOMING_DIR\fP. Vous pouvez déplacer, renommer ou toucher ce fichier si vous souhaitez que l'image soit mise à jour plus ou moins souvent. Son contenu liste les sorties de \fBcowbuilder\fP pendant la mise à jour (ou la création) de la racine de construction. .SH NOTES Puisque cowbuilder crée un chroot, et qu'il faut pour cela être superutilisateur, \fBcowpoke\fP nécessite également certains des droits du superutilisateur. Et toutes les horreurs qui peuvent arriver à cause de ça pourront vous arriver un jour. \fBcowbuilder\fP est connu pour avoir accidentellement écrasé des systèmes de fichiers montés avec l'option «\ bind\ » en dehors de son chroot, et pire encore peut arriver. Soyez prudents, conservez des sauvegardes de ce que vous ne souhaitez pas perdre sur vos machines de construction et utilisez \fBcowpoke\fP pour isoler tous ces problèmes sur une machine qui n'est pas votre machine de développement avec vos quelques heures de travail non committé. .SH "VOIR AUSSI" \fBcowbuilder\fP(1), \fBpbuilder\fP(1), \fBssh\-agent\fP(1), \fBsudoers\fP(5) .SH AUTEUR \fBcowpoke\fP a été écrit par Ron <\fIron@debian.org\fP>. .SH TRADUCTION Ce document est une traduction, maintenue à l'aide de l'outil po4a <\fIhttps://po4a.alioth.debian.org/\fR> par l'équipe de traduction francophone du projet Debian. Nicolas François, Guillaume Delacour, Cyril Brulebois, Thomas Huriaux et David Prévot ont réalisé cette traduction. L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. Veuillez signaler toute erreur de traduction en écrivant à .nh <\fIdebian\-l10n\-french@lists.debian.org\fR> .hy ou par un rapport de bogue sur le paquet devscripts. La version anglaise la plus à jour de ce document est toujours consultable en ajoutant l'option «\ \fB\-L\ C\fR\ » à la commande \fBman\fR.