Provided by: devscripts_2.11.1ubuntu3_i386 bug

NOM

       cowpoke  -  Construire  un  paquet  source  Debian dans une instance de
       cowbuilder distante

SYNOPSIS

       cowpoke [options] paquet.dsc

DESCRIPTION

       Envoyer un paquet source Debian a un hote cowbuilder et  construire  le
       paquet.  Le  paquet  resultant peut egalement etre signe et envoye dans
       une file d'attente.

OPTIONS

       Les options suivantes sont disponibles :

       --arch=architecture
              Indiquer la ou  les  architectures  Debian  pour  lesquelles  le
              paquet  doit  etre construit. Une liste d'architectures separees
              par des espaces peut etre utilisee  pour  construire  le  paquet
              pour  toutes  ces  architectures  en  une  seule passe. Les noms
              d'architecture    supportes    sont    ceux     renvoyes     par
              dpkg-architecture(1) pour DEB_BUILD_ARCH.

       --dist=distribution
              Indiquer  la  ou  les  distributions  Debian  pour lesquelles le
              paquet doit etre construit. Une liste de distributions  separees
              par  des  espaces  peut  etre utilisee pour construire le paquet
              pour toutes ces distributions en une seule passe.  Des  noms  de
              code  (comme  sid ou squeeze) ou des noms de distribution (comme
              unstable ou  experimental)  peuvent  etre  utilises,  mais  vous
              devriez  toujours  utiliser un type de noms ou l'autre parce que
              c'est ce nom qui est utilise pour les chemins de fichier et pour
              trouver  les  anciens  paquets  utilises  pour  les  rapports de
              comparaison.

       --buildd=h^ote
              Indiquer l'hote distant sur lequel se fera la construction.

       --buildd-user=nom
              Indiquer l'utilisateur distant a utiliser pour la construction.

       --create
              Creer la racine cowbuilder distante si elle n'existe pas encore.
              Si   cette   option  n'est  pas  fournie,  une  distribution  ou
              architecture (indiquees par --dist ou --arch) qui  n'aurait  pas
              de racine cowbuilder sera consideree comme une erreur.

       --return=[chemin]
              Copier les fichiers resultant de la construction vers chemin. Si
              aucun chemin n'est indique, ils  sont  alors  renvoyes  vers  le
              repertoire  actuel. Le chemin donne doit exister, il ne sera pas
              cree.

       --no-return
              Ne pas copier le resultat de  la  construction  vers  RETURN_DIR
              (ecrase le chemin configure dans les fichiers de configuration).

       --dpkg-opts='opt1 opt2 ...'
              Indiquer    des    options    supplementaires    a   fournir   a
              dpkg-buildpackage(1). les differentes options sont separees  par
              des  espaces.  Cela  remplacera  toute  option  fournie  par  la
              variable DEBBUILDOPTS du fichier pbuilderrc  de  la  machine  de
              construction.

       --help Afficher  un  bref  resume  des  options  disponibles  et  de la
              configuration en cours.

       --version
              Afficher les informations sur la version.

OPTIONS DE CONFIGURATION

       Quand cowpoke est execute, les options de configuration suivantes  sont
       lues dans le fichier de configuration global, celui de l'utilisateur et
       du projet, s'ils sont presents. Les chemins peuvent  etre  indiques  de
       facon  absolue  ou  relative  (les  chemins  etant  alors  relatifs  au
       repertoire personnel de l'utilisateur BUILDD_USER). Les  chemins  etant
       generalement  fournis  entre guillemets, l'expansion des tildes ne sera
       pas realisee.

   Valeurs globales par d'efaut
       Elles s'appliquent a chaque  architecture  et  distribution  lors  d'un
       appel a cowpoke.

       BUILDD_HOST
              L'adresse  reseau  ou  le nom completement qualifie (FQDN) de la
              machine de construction ou cowbuilder est configure.  Elle  peut
              etre modifiee avec l'option en ligne de commande --buildd.

       BUILDD_USER
              Le  nom  de  l'utilisateur,  non  privilegie,  sur la machine de
              construction. Le nom par defaut  est  le  nom  de  l'utilisateur
              local  qui execute cowpoke (ou le nom d'utilisateur precise dans
              la configuration SSH pour BUILDD_HOST), et le nom fournit par la
              variable   d'environnement  peut  etre  remplace  avec  l'option
              --buildd-user en ligne de commande.

       BUILDD_ARCH
              La  ou  les  architectures  Debian  pour  lesquelles   il   faut
              construire  les  paquets.  Cela doit correspondre a la valeur de
              DEB_BUILD_ARCH du chroot de construction utilise. La valeur  par
              defaut est l'architecture de la machine sur laquelle cowpoke est
              executee, et l'architecture peut etre  remplacee  avec  l'option
              --arch  en ligne de commande. Une liste d'architectures separees
              par des espaces (il peut etre  necessaire  de  fournir  le  tout
              entre guillemets) peut etre utilisee pour construire les paquets
              pour toutes ces architectures en une seule passe.

       BUILDD_DIST
              La  ou  les  distributions  Debian  pour  lesquelles   il   faut
              construire  les paquets. Une liste de distributions separees par
              des espaces (il peut etre necessaire de fournir  le  tout  entre
              guillemets)  peut etre utilisee pour construire les paquets pour
              toutes  ces  architectures  en  une  seule  passe.  La  ou   les
              distributions  peuvent  etre  remplacees avec l'option --dist en
              ligne de commande.

       INCOMING_DIR
              Le chemin du repertoire sur la machine de construction  ou  sont
              places  initialement les paquets source. Il doit etre accessible
              en ecriture par l'utilisateur BUILDD_USER.

       PBUILDER_BASE
              La racine du systeme de fichiers pour tous les fichiers  COW  et
              les  fichiers  resultats.  Des  sous-repertoires specifiques aux
              architectures et aux distributions seront normalement crees sous
              cette  racine.  Le cache d'apt et les repertoires temporaires de
              construction se trouveront egalement sous ce chemin.

       SIGN_KEYID
              Si cette option est activee, elle doit contenir l'identifiant de
              la  clef  GPG a fournir a debsign(1) si les paquets doivent etre
              signes sur la machine distante. Il vous  sera  demande  si  vous
              souhaitez  signer les paquets apres que toutes les constructions
              sont finies. Si cette  option  n'est  pas  activee  ou  si  elle
              contient  une chaine vide, aucune tentative de signature ne sera
              effectuee.

       UPLOAD_QUEUE
              Si cette option est activee, elle doit contenir  une  indication
              d'hote  pour  dput(1) qui sera utilisee pour envoyer les paquets
              apres qu'ils ont ete signes. Il vous sera demande  de  confirmer
              si  vous  souhaitez  envoyer  les  paquets  apres qu'ils ont ete
              signes. Si cette option n'est pas activee ou  si  elle  contient
              une  chaine vide, aucune tentative d'envoi ne sera effectuee. Si
              SIGN_KEYID n'est pas activee,  cette  option  sera  completement
              ignoree.

       BUILDD_ROOTCMD
              La   commande   a   utiliser   pour   obtenir   les   droits  du
              superutilisateur sur la machine  distante  de  construction.  Si
              elle n'est pas definie, la commande par defaut est sudo(8). Elle
              n'est necessaire que pour appeler cowbuilder  et  lui  permettre
              d'entrer  dans  son  chroot.  Vous  pouvez  donc n'autoriser cet
              utilisateur a  acquerir  des  droits  supplementaires  que  pour
              l'execution  de  cette  commande. La ligne suivante dans sudoers
              permettra d'appeler cowbuilder sans avoir a fournir  de  mot  de
              passe :

                      utilisateur ALL = NOPASSWD: /usr/sbin/cowbuilder

              Autrement,  vous pouvez utiliser SSH avec une clef ou tout autre
              mecanisme correspondant a votre politique locale.  su  -c  n'est
              pas  vraiment utilisable ici parce qu'il necessite de placer des
              guillemets autour, contrairement aux autres.

       DEBOOTSTRAP
              L'utilitaire a  utiliser  pour  creer  une  nouvelle  racine  de
              construction. Les possibilites sont debootstrap ou cdebootstrap.

       RETURN_DESTDIR
              Si  elle  est  definie,  les  fichiers  de  paquet  issus  de la
              construction  seront  copies  a  l'endroit  (local  ou  distant)
              configure,  une  fois  la  construction terminee. Le chemin doit
              exister, il ne sera pas cree. Cette option n'est pas definie par
              defaut et peut etre ecrasee par --return ou --no-return.

   Options sp'ecifiques `a des architectures ou distributions
       Ce  sont  des variables de la forme $arch_$dist_VAR qui ne s'appliquent
       qu'a une cible de construction specifique a une architecture et  a  une
       distribution.

       arch_dist_RESULT_DIR
              Le  chemin  du  repertoire  de la machine de construction ou les
              paquets resultants (source et binaires) seront  trouves,  et  ou
              les  versions  ulterieures  des  paquets  ayant ete precedemment
              construits pourront etre trouvees. Si des anciens  paquets  sont
              trouves,  debdiff  sera  utilise pour comparer le nouveau paquet
              avec la version precedente une fois la construction finie, et le
              resultat  se  trouvera  dans  le  journal  de  construction. Les
              fichiers du repertoire doivent  etre  lisibles  par  BUILDD_USER
              pour  les  verifications  par lintian(1) et debdiff(1) ainsi que
              pour les envois par dput(1). Si cette option n'est  pas  definie
              pour certaines combinaisons d'architectures et de distributions,
              alors       le       chemin        par        defaut        sera
              $PBUILDER_BASE/$arch/$dist/result

       arch_dist_BASE_PATH
              Le  repertoire ou les fichiers COW maitres se trouvent (ou la ou
              ils sont crees si l'option en ligne  de  commande  --create  est
              utilisee).   Si   cette   option  n'est  pas  definie  pour  une
              combinaison d'architecture et de distribution, alors  le  chemin
              par defaut est $PBUILDER_BASE/$arch/$dist/base.cow

FICHIERS DE CONFIGURATION

       /etc/cowpoke.conf
              Options   de  configuration  globales.  Elles  remplaceront  les
              valeurs par defaut codees en dur.

       ~/.cowpoke
              Options de configuration de  l'utilisateur.  Elles  remplaceront
              les valeurs des options de configuration globales.

       .cowpoke
              Options  de  configuration  du  projet.  Elles  remplaceront les
              valeurs des options de configuration globale ou de l'utilisateur
              si  cowpoke  est  appele  depuis  le  repertoire ou se trouve le
              fichier.

              Si la variable d'environnement COWPOKE_CONF  est  definie,  elle
              indique   un   fichier   de   configuration  supplementaire  qui
              remplacera tous les autres. Les options utilisees  explicitement
              sur  la  ligne  de commande remplacent les options provenant des
              fichiers de configuration.

CONFIGURATION DE COWBUILDER

       Il n'y a rien de particulier a faire pour configurer  une  instance  de
       cowbuilder  pour  qu'elle  puisse  etre utilisee avec cowpoke. Creer la
       simplement telle que vous en avez besoin avec << cowbuilder --create >>
       en suivant la documentation de cowbuilder, puis configurez cowpoke avec
       les  informations  sur  l'utilisateur,  l'architecture  et  le   chemin
       necessaire  pour y acceder sur les machines ou vous souhaitez l'appeler
       (ou  configurez  cowpoke  avec  les   informations   sur   le   chemin,
       l'architecture  et  la distribution et fournissez lui l'option --create
       lors du premier appel). L'hote de construction  sur  lequel  cowbuilder
       tourne n'a pas besoin que cowpoke soit installe localement.

       La machine de construction doit avoir les paquets lintian et devscripts
       installes pour les verifications en fin de construction.  Une  fois  la
       construction  finie, un journal et les resultats des tests automatiques
       seront enregistres dans INCOMING_DIR. Si  vous  souhaitez  envoyer  des
       paquets signes, dput(1) devra egalement etre installe sur la machine de
       construction et devra etre configure pour utiliser l'alias h^ote indique
       par  UPLOAD_QUEUE.  Si rsync(1) est disponible a la fois sur la machine
       locale et la machine de construction, alors il peut etre  utilise  pour
       transferer le paquet source (cela permet d'economiser quelques echanges
       de orig.tar.* lors de la construction des revisions Debian suivantes).

       L'utilisateur qui execute cowpoke doit avoir un acces SSH a la  machine
       de  construction  en tant que BUILDD_USER. Cet utilisateur doit pouvoir
       executer  cowbuilder  en  tant  que   superutilisateur   en   utilisant
       BUILDD_ROOTCMD.  Les clefs pour les signatures n'ont pas necessairement
       a etre installees sur la  machine  de  construction  (et  elles  seront
       ignorees  si  elles  le sont). Si un paquet est signe, les clefs seront
       necessaires sur la machine qui execute cowpoke.

       Quand cowpoke est appele, il cherche d'abord a mettre  a  jour  l'image
       cowbuilder  si  cela  n'a  pas  deja  ete  fait  le  meme  jour.  Cette
       verification    se    base    sur    la    presence    d'un     fichier
       cowbuilder-$arch-$dist-update-log-$date      dans     le     repertoire
       INCOMING_DIR. Vous pouvez deplacer, renommer ou toucher ce  fichier  si
       vous  souhaitez que l'image soit mise a jour plus ou moins souvent. Son
       contenu liste les sorties de cowbuilder pendant la mise a jour  (ou  la
       creation) de la racine de construction.

NOTES

       Puisque  cowbuilder  cree  un  chroot,  et  qu'il  faut  pour cela etre
       superutilisateur, cowpoke necessite egalement certains  des  droits  du
       superutilisateur. Et toutes les horreurs qui peuvent arriver a cause de
       ca pourront vous arriver un  jour.  cowbuilder  est  connu  pour  avoir
       accidentellement  ecrase  des systemes de fichiers montes 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 cowpoke pour isoler
       tous  ces  problemes  sur  une  machine  qui n'est pas votre machine de
       developpement avec vos quelques heures de travail non committe.

VOIR AUSSI

       cowbuilder(1), pbuilder(1), ssh-agent(1), sudoers(5).

AUTEUR

       cowpoke a ete ecrit par Ron <ron@debian.org>.

TRADUCTION

       Ce document est une traduction, maintenue  a  l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   de   traduction
       francophone du projet Debian.

       Nicolas Francois, Guillaume Delacour, Cyril Brulebois,  Thomas  Huriaux
       et David Prevot ont realise cette traduction.

       L'equipe  de  traduction a fait le maximum pour realiser une adaptation
       francaise de qualite.  Veuillez signaler toute erreur de traduction  en
       ecrivant  a  <debian-l10n-french@lists.debian.org> ou par un rapport de
       bogue sur le paquet devscripts.

       La version anglaise  la  plus  a  jour  de  ce  document  est  toujours
       consultable en ajoutant l'option << -L C >> a la commande man.

                                 28 avril 2008                      COWPOKE(1)