Provided by: kernel-package_12.036+nmu1_all bug

NOM

       make-kpkg - Construire des paquets Debian du noyau a partir des sources
       du noyau Linux

SYNOPSIS

       make-kpkg [options] [cible[cible ...]]

DESCRIPTION

       Cette page de manuel decrit l'utilitaire Debian make-kpkg, utilise pour
       creer  les paquets Debian concernant le noyau. Cet utilitaire doit etre
       lance a partir du repertoire racine des sources du noyau  Linux,  noyau
       qui   doit   avoir  ete  prealablement  configure  (a  moins  que  vous
       n'utilisiez la cible << configure >>). Normalement,  si  kernel-package
       ne  trouve pas de fichier .config dans le repertoire courant, il essaye
       absolument d'en trouver un  autre  qui  fera  l'affaire  (en  fait,  un
       fichier  de  configuration  deja  pre-regle  pour les noyaux Debian sur
       cette architecture) puis lancera un make  oldconfig  pour  permettre  a
       l'utilisateur  de repondre a toute nouvelle question. Typiquement, vous
       executez cette commande en tant que root ou avec fakeroot, ou encore en
       indiquant a make-kpkg comment devenir root, comme ceci :

            make-kpkg --rootcmd fakeroot kernel_image

       Le paquet Debian sera cree dans le repertoire pere des sources du noyau
       depuis lequel la commande a ete lancee.

       De plus, sachez que certaines versions de gcc ne fonctionnent pas  tres
       bien  avec  les  sources  du noyau (gcc 2.95 rencontre des problemes de
       compilation du noyau  si  on  n'utilise  pas  l'option  de  compilation
       << -fno-strict-aliasing >>).  Ce  probleme  a ete regle pour les noyaux
       recents (les series 2.2 et 2.4 n'ont pas ce probleme)  (je  crois  que,
       pour  les  noyaux  plus  anciens,  vous  risquez  d'avoir a modifier le
       Makefile). Vous pouvez indiquer la version de gcc a  utiliser  pour  la
       compilation  du  noyau  en  definissant  les  variables CC et HOSTCC du
       Makefile (le Makefile du premier niveau). Cela se fait tout  simplement
       en  definissant  la  variable  d'environnement  MAKEFLAGS.  Pour  voir,
       testez :

        % KBUILD_VERBOSE=1 MAKEFLAGS="CC=gcc-4.4" make-kpkg configure

       KBUILD_VERBOSE  affiche  le  detail  des  commandes  qui  sont  lancees
       (consultez  le  Makefile  de  premier  niveau  afin  de  connaitre  les
       variables qui peuvent etre definies).

       Attention : Ne definissez pas l'option -j directement  dans  MAKEFLAGS,
       cela    risque    de    faire   echouer   la   construction.   Utilisez
       CONCURRENCY_LEVEL comme defini plus haut. L'option -j peut  aussi  etre
       utilisee.

OPTIONS

       Affiche un message d'aide.

       --revision num'ero
              Modifier  le  numero  de version pour les paquets construits par
              celui  donne  par  l'argument  num'ero.  Ceci  impose   plusieurs
              contraintes :  La  version  ne  doit contenir que des caracteres
              alphanumeriques ou les caracteres ~ + . (tilde, plus  et  point)
              et  doit  contenir  un  chiffre (Consultez le manuel Policy pour
              plus de details). Vous pouvez eventuellement prefixer le  numero
              de  modification  par  un chiffre suivi d'un deux points (:). La
              valeur par defaut est  10.00.Custom  a  moins  que  la  variable
              d'environnement   DEBIAN_REVISION_MANDATORY   ne  soit  definie,
              auquel cas une erreur sera produite si la modification n'est pas
              indiquee  sur  la  ligne  de  commande  ou  dans  le  fichier de
              configuration.   Conseil :   Vous   pouvez   le   configurer   a
              $(version)-<truc>  dans  le fichier de configuration pour que le
              numero de version amont precede la chaine personnalisee <truc>.

       --append-to-version toto

       --append_to_version toto
              L'argument  toto  est  ajoute  a  la  valeur  de   la   variable
              EXTRAVERSION   presente  dans  le  Makefile  du  noyau.  Puisque
              EXTRAVERSION fait partie de la version du noyau,  il  est  aussi
              ajoute au nom du paquet, et de ce fait doit obeir a la politique
              qui regit les noms de paquet. Ce  qui  signifie  qu'il  ne  doit
              contenir  que  des  caracacteres alphanumerique en minuscules et
              des caracteres ~ - +  .  (tilde,  point,  tiret  et  plus).  Les
              majuscules  sont  interdites  selon  la Charte pour les nouveaux
              paquets. Si la variable d'environnement IGNORE_UPPERCASE_VERSION
              est  definie,  make-kpkg changera la casse en minuscules pour le
              numero de version defini  soit  dans  le  Makefile  ou  dans  le
              fichier   localversion.  Cette  option  outrepasse  la  variable
              d'environnement APPEND_TO_VERSION

       --added-modules toto

       --added_modules toto
              Cet argument se presente sous la forme d'une  liste  de  modules
              additionnels  separes  par des virgules (modules non inclus dans
              l'arborescence  principale  du   noyau)   que   vous   souhaitez
              construire  lorsque  vous invoquez les cibles modules_truc. Vous
              devez indiquer le chemin complet des repertoires  contenant  les
              modules,  ou  simplement  le nom du module s'il peut etre trouve
              dans MODULE_LOC, qui pointe par defaut sur /usr/src/modules.  Le
              comportement  par  defaut compile tous les modules qui sont dans
              MODULE_LOC, quand les cibles modules_truc sont demandees.

       --arch truc
              Pratique pour definir  l'architecture  quand  vous  utilisez  la
              compilation  croisee.  Si  vous  ne  faites  pas  de compilation
              croisee, l'architecture est automatiquement determinee. On  peut
              obtenir  le meme resultat en reglant la variable d'environnement
              KPKG_ARCH.  Cette  valeur  doit  correspondre  au   contenu   de
              DEB_HOST_ARCH_CPU  lorsque  dpkg-architecture est execute sur la
              machine  cible,  et  elle  peut   correspondre   a   une   autre
              architecture  dans le cas d'un ensemble multiarchitecture (comme
              i386/amd64).

       --cross-compile truc

       --cross_compile truc
              Pratique pour definir la chaine cible quand vous  faites  de  la
              compilation  croisee.  Utilisez la cible fantome << - >> si vous
              construisez pour les  autres  architectures  dans  le  cas  d'un
              ensemble  multiarchitecture,  comme i386/amd64. Le meme resultat
              peut etre obtenu en  definissant  la  variable  d'environnement.
              Notez  bien  que  cela ne regle en aucune maniere le compilateur
              que le processus de construction du noyau doit utiliser.  Si  le
              compilateur  par defaut utilise par le processus de construction
              n'est pas celui dont vous avez besoin, definissez  explicitement
              le compilateur qui doit etre utilise. CROSS_COMPILE.

       --subarch truc
              Certaines  architectures  (comme  Alpha,  ou m68k) ont besoin de
              noyaux differents pour  chacune  des  sous-architectures.  Cette
              option  offre  un  moyen  de le specifier en tant qu'argument de
              make-kpkg. Notez bien qu'une gestion de  ces  sous-architectures
              doit  etre  presente  dans  les sources du noyaux afin que cette
              option serve a quelque chose. On peut obtenir le  meme  resultat
              en reglant la variable d'environnement KPKG_SUBARCH

       --arch-in-name

       --arch_in_name
              Cette  option  rallonge  le nom du paquet de l'image du noyau en
              integrant la sous-architecture dans le nom de l'image ; ainsi on
              peut    ecrire    des    scripts   pour   creer   de   multiples
              sous-architectures, l'une apres l'autre. On peut faire  la  meme
              chose en reglant la variable d'environnement ARCH_IN_NAME. Notez
              bien que seul le nom du paquet est change, pas l'emplacement des
              modules, etc.

       --pgpsign nom
              Definit   la   chaine   utilisee  pour  signer  le  fichier  des
              modifications (changes) pour les modules  externes  ranges  dans
              /usr/src/modules/  et qui utilisent PGP. Cette option prendra le
              pas sur le  comportement  par  defaut  et  sur  les  preferences
              generales  qui  se trouvent dans le fichier /etc/kernel-pkg.conf
              ou ~/.kernel-pkg.conf.

       --config cible
              Modifie le type de configuration utilisee, par defaut oldconfig.
              cible  doit prendre une des valeurs suivantes oldconfig, config,
              menuconfig,   gconfig,    xconfig,    randconfig,,    defconfig,
              allmodconfig, allyesconfig, allnoconfig; old, menu, g, ou x.

              Notez cependant que make-kpkg explore au demarrage le fichier de
              configuration a la recherche  de  certaines  options,  notamment
              l'activation  ou  non  des modules, et que la modification de ce
              choix  pendant  la  configuration  engendrera  une  erreur.   Si
              necessaire,  creez  un  fichier  de configuration le plus proche
              possible de celui desire avant d'appeler  make-kpkg  avec  cette
              option.

       --targets
              Affiche la liste des cibles connues. Voir la section CIBLES plus
              loin.

       --noexec
              Passe l'option -n au  processus  make  afin  que  les  commandes
              soient  simplement  affichees  a  l'ecran  mais  pas  reellement
              executees. C'est tres pratique pour le debogage.

       --verbose
              Appelle make avec l'option -V=1, ce qui  appelle  les  commandes
              Make du niveau superieur, pratique pour voir ce qui est en train
              de se passer.

       --initrd
              Lorsque make-kpkg fabrique un paquet kernel-image, il prend  ses
              dispositions  pour  transmettre  aux scripts hook lances par les
              scripts de fin d'installation que  cette  image  a  besoin  d'un
              initrd,  et que les scripts hook de creation d'initrd ne doivent
              pas etre court-circuites avant. Sans  cette  option,  le  script
              hook  initramfs  fourni  en  exemple  avec kernel-package n'aura
              aucun effet lors de l'installation. Le meme resultat  peut  etre
              obtenu  en  definissant  la variable d'environnement INITRD avec
              n'importe quel contenu. Notez bien qu'a moins qu'il n'y ait  des
              scripts hook dans /etc/kernel ou indiques dans le parametre hook
              script de /etc/kernel-img.conf, aucun initrd ne sera  cree  (les
              scripts fournis ne sont que des exemples).

       --jobs num'ero
              --j     num'ero    Configure    la    variable    d'environnement
              CONCURRENCY_LEVEL a num'ero

       --overlay-dir /chemin/vers/r'epertoire
              Le repertoire indique doit  contenir  les  fichiers  qui  seront
              copies dans le repertoire ./debian des sources du noyau, afin de
              construire les paquets debian. Les fichiers remplaceront tout ou
              partie  du  contenu  de  /usr/share/kernel-package  qui y serait
              normalement place, et il est a la  charge  de  l'utilisateur  de
              verifier que les fichiers du repertoire indiques sont compatible
              avec make-kpkg. Si make-kpkg est casse par un de  ces  fichiers,
              vous  pouvez  garder  les  morceaux.  Le meme resultat peut etre
              obtenu    en    definissant    la    variable    d'environnement
              KPKG_OVERLAY_DIR.

              Veuillez  noter que overlay-dir/Control et overlay-dir/changelog
              sont particuliers, et que des substitutions  de  variables  sont
              executees    sur    ces    fichiers.   Utilisez   ces   fichiers
              /usr/share/kernel-package/Control                             et
              /usr/share/kernel-package/changelog    en   tant   que   modeles
              (templates)

              Si    un     programme     (ou     un     script     executable)
              overlay-dir/post-install    est   present,   il   sera   execute
              immediatement apres le remplissage de ./debian. Le  script  sera
              execute  dans  le  repertoire  ./debian.  Cela  peut  servir par
              exemple a supprimer des  fichiers  dont  l'utilisateur  n'a  pas
              besoin,   ou   executer   des  operations  autres  qu'un  simple
              remplacement.

       --zimage
              Genere un noyau en zImage plutot qu'en bzImage (comportement par
              defaut).  C'est  utile  pour ceux qui ont des problemes avec les
              noyaux bzImage.

       --bzimage
              Genere un noyau en bzImage. C'est utile pour ceux qui veulent un
              noyau  bzImage  sur  les  systemes  ou le reglage par defaut est
              zImage.

       --rootcmd commande
              La  commande  qui  offre  la   possibilite   d'obtenir   l'acces
              superutilisateur  (par  exemple,  << sudo >>  ou << fakeroot >>)
              pour les besoins de  l'option  -r  de  dpkg-buildpackage.  Cette
              option  ne  fonctionne  pas pour trois cibles precises, qui sont
              binary,  binary-indep  et  binary-arch.  Pour  ces  cibles,   la
              commande  make-kpkg  doit  etre  lancee  en  tant  que  root (ou
              fakeroot).

       --stem truc
              Nomme le paquet truc-* a la place  de  kernel-*.  Pratique  pour
              assurer  la  transition  du  nommage  des  paquets de kernel-* a
              linux-*,  afin  de  preparer  les   noyaux   non-linux   de   la
              distribution.   Defini   a   linux  par  defaut.  Cette  chaine,
              puisqu'elle est le debut du nom du paquet, ne doit comporter que
              des  lettres  minuscules  (a-z),  des  chiffres (0-9), plus (+),
              moins '(-) ou des points (.). Elle doit faire une longueur  d'au
              moins 2 caracteres, et commencer par une lettre.

       --us   Cette  option est transmise a dpkg-buildpackage et demande de ne
              pas signer la source.  Elle  n'a  de  sens  que  pour  la  cible
              buildpackage.

       --uc   Cette option est transmise a dpkg-buildpackage, et demande de ne
              pas signer le changelog. Elle n'a de  sens  que  pour  la  cible
              buildpackage.

       Les  options  peuvent  etre  raccourcies  en  la  plus petite chaine de
       caracteres non equivoque et peuvent etre invoquees indifferemment  avec
       les  prefixes  -  ou  -- ; Vous pouvez mettre un espace ou un symbole =
       entre une option et sa valeur. Vous  pouvez  aussi  utiliser  la  forme
       option=valeur ;  Pour plus d'informations sur ces variantes et d'autres
       qui sont reconnues, consultez la page de manuel Getopt::Long (3perl).

       CONCURRENCY_LEVEL
              Si elle est definie, cette  variable  d'environnement  regle  le
              niveau  de  profondeur (NdT : concurrency) utilise par make pour
              compiler le noyau et l'ensemble des  modules.  Elle  utilise  le
              drapeau  -j  dans  le  make  qui  est  dans  la  cible  build de
              make-kpkg.  Elle  doit  etre  un  (petit)  entier,  si  vous  la
              definissez.  Vous pouvez obtenir le nombre actuel de CPU grace a
              la commande :
               "grep -c '^processor' /proc/cpuinfo" ATTENTION : NE  definissez
              PAS  l'option  dans  MAKEFLAGS  directement,  cela  entrainerait
              l'echec  de  la  construction.  L'option  -j  peut  aussi   etre
              configuree en argument a make-kpkg.

CIBLES

       clean  Efface tous les fichiers crees dans le repertoire des sources du
              noyau par la cible build, et lance un make distclean. (Consultez
              le  Makefile du noyau Linux pour plus d'informations). Notez que
              malgre l'attention  que  nous  portons  aux  reglages  du  noyau
              courant   contenus   dans   le   fichier   .config,  le  fichier
              include/linux/autoconf.h ne sera pas garde. Cette cible ne  doit
              pas  etre  combinee avec une autre, puisque make-kpkg lit toutes
              les donnees avant de  lancer  une  quelconque  cible,  donc  les
              autres  cibles  seront  executees avec les anciennes donnees, ce
              qui n'est surement pas ce que vous desirez.

       buildpackage
              Cette cible lance les cibles clean,  et  binary,  et  genere  le
              paquet complet grace a dpkg-buildpackage

       binary Cette  cible  genere  les  quatre  paquets Debian en lancant les
              cibles binary-indep et binary-arch. Toutefois,  il  faut  lancer
              make-kpkg  en  tant  que  root  (ou  fakeroot), car --rootcmd ne
              fonctionnera pas.

       binary-indep
              Cette cible genere les paquets independants de l'architecture en
              lancant  les  cibles kernel_source, kernel_manual et kernel_doc.
              Toutefois, il  faut  lancer  make-kpkg  en  tant  que  root  (ou
              fakeroot), car --rootcmd ne fonctionnera pas.

       binary-arch
              Cette  cible  genere les paquets dependants de l'architecture en
              lancant les cibles kernel_headers et kernel_image. Toutefois, il
              faut  lancer  make-kpkg  en  tant  que  root  (ou fakeroot), car
              --rootcmd ne fonctionnera pas. kernel_image.

       kernel_source
              Cette cible genere un paquet Debian des sources du noyau  Linux.
              Si  la  variable d'environnement SOURCE_CLEAN_HOOK pointe sur un
              executable, alors cet executable  sera  lance,  juste  avant  de
              faire  le  paquet,  sur  le  repertoire  (racine) temporaire des
              sources                        du                         noyau,
              ./debian/tmp-source/usr/src/kernel-source-X.X.XX,  de facon a ce
              qu'on puisse lancer toute  commande  appropriee  (supprimer  des
              arborescences liees a des architectures, oter les repertoires de
              controle de version, find . -type d -name CVS  -prune  -exec  rm
              -rf  {}  \;  etc.) Cela ne concerne que les sources du noyau qui
              sont en cours  d'empaquetage.  Si  cette  action  porte  sur  le
              repertoire  courant  et  ses  repertoires  fils,  l'arborescence
              originale qui contient les sources reste, elle,  inchangee.  Les
              variables  d'environnement  HEADER_CLEAN_HOOK  et DOC_CLEAN_HOOK
              sont semblables. Elles doivent pointer sur des executables ; ces
              executables   seront   appliques   sur  le  repertoire  (racine)
              temporaire des en-tetes du noyau et de  la  documentation  juste
              avant  la  generation  des paquets respectifs, de facon a ce que
              vous puissiez lancer toute action qui vous semble  adequate.  De
              meme,  ne  sont  touchees  que  les  sources  qui  sont en cours
              d'empaquetage.

       kernel_debug
              Cette cible fabrique une paquet Debian contenant les symboles de
              debogages   pour  les  modules  contenu  dans  le  paquet  image
              correspondant. L'idee de base ici est de garder le controle  sur
              l'encombrement   dans  /lib/modules/<kver>,  puisqu'il  pourrait
              s'agir d'une partition racine dotee de limites de taille.

       kernel_headers
              Cette cible genere le  paquet  Debian  des  fichiers  d'en-tetes
              contenus dans le noyau Linux.

       kernel_manual
              Cette  cible  genere  le  paquet  Debian  contenant les pages de
              manuel de la section 9 fournies dans le noyau Linux. Notez  bien
              que  ce  n'est  pas vraiment une cible independante, puisque son
              appel declenchera l'appel de la cible kernel_doc, et  creera  un
              paquet kernel-doc en meme temps.

       kernel_doc
              Cette  cible  genere un paquet Debian contenant la documentation
              contenue  dans  le  noyau  Linux.   Elle   peut   etre   appelee
              independamment  de  la cible kernel_manual, mais l'inverse n'est
              pas possible.

       kernel_image
              Cette cible genere un paquet Debian contenant un noyau Linux, et
              tous  les  modules  definis  dans le fichier de configuration du
              noyau .config. S'il n'y  a  pas  de  fichier  .config  dans  les
              repertoires  des  sources du noyau, une configuration par defaut
              est  utilisee,  identique  a  celle  utilisee  pour  creer   les
              disquettes de demarrage Debian.

              Si le fichier ./debian/post-install existe, et qu'il s'agit d'un
              executable, il est lance juste avant la creation  du  paquet  de
              l'image  du  noyau.  De  meme, notez que si des scripts existent
              dans le repertoire ./debian/image.d/ , run-parts sera lance  sur
              ce  repertoire  juste  avant la creation du paquet de l'image du
              noyau. L'emplacement de la racine de l'image pour le  paquet  en
              cours   de   construction  peut  etre  defini  par  la  variable
              d'environnement IMAGE_TOP, et la version du  noyau  est  definie
              grace  a  la  variable  d'environnement  version  pour  tous ces
              scripts.

              Consultez la  documentation  a  propos  des  variables  de  type
              << hook >>   (points   d'entree)  dans  kernel-img.conf(5).  Ces
              variables  peuvent  indiquer  des  scripts   qui   ajoutent   ou
              suppriment  une ligne dans le menu du grub a l'installation ou a
              la suppression de l'image du noyau. Un exemple  de  script  pour
              ajouter des lignes au menu du grub est fourni dans le repertoire
              /usr/share/doc/kernel-package/.

              En  dehors   de   ces   variables   de   type   << hook >>   que
              l'administrateur   peut   definir,  il  existe  un  ensemble  de
              repertoires dans  lesquels  des  paquets,  ou  l'administrateur,
              peuvent    deposer    des    scripts.   Ces   repertoires   sont
              /etc/kernel/preinst.d/,                 /etc/kernel/postinst.d/,
              /etc/kernel/prerm.d/,          /etc/kernel/postrm.d/          et
              /etc/kernel/preinst.d/<VERSION>/,
              /etc/kernel/postinst.d/<VERSION>/,
              /etc/kernel/prerm.d/<VERSION>/, /etc/kernel/postrm.d/<VERSION>/.
              Si  ces  repertoires existent, le paquet kernel-image lancera le
              programme run-parts sur  ceux-ci,  en  passant  en  argument  la
              version  en  cours  d'installation  ou de suppression, durant la
              phase  correspondante  (installation  ou   suppression).   Avant
              d'appeler  ces  scripts,  la  variable d'environnement STEM doit
              etre reglee avec le contenu de l'argument --stem (ou a sa valeur
              par  defaut,  linux), et la variable KERNEL_PACKAGE_VERSION doit
              contenir la version de kernel-package qui a cree ce paquet.  Ces
              scripts  peuvent  etre  appeles  avec deux arguments, le premier
              etant la version  de  l'image  du  noyau,  et  le  second  etant
              l'endroit  ou est range l'image proprement dite. Lorsque debconf
              est lance avant que le script ne  soit  appele,  ce  dernier  ne
              devra  pas  generer  de  message  de  diagnostic  sur  la sortie
              standard -- En effet, au moment ou la post-installation  appelle
              db_stop,  debconf  ne  retablit pas la sortie standard, tous les
              messages en sa direction disparaissent.

              A  l'installation,  vous  aurez  la  possibilite  de  lancer  le
              chargeur de demarrage LILO (ou des equivalents tels que loadlin,
              SILO, QUIK, VMELILO, ZIPL, yaboot, PALO ou GRUB ), en creant  un
              fichier  de  configuration  pour ces programmes de demarrage, si
              necessaire. A ce moment, vous  aurez  aussi  la  possibilite  de
              mettre  ce  nouveau  noyau  sur  une  disquette, en formatant la
              disquette si  necessaire.  En  cas  de  suppression,  le  paquet
              verifie  la  version  du  noyau  en cours d'execution, et refuse
              alors d'effacer le noyau en cours d'utilisation. Grub merite une
              mention  particuliere  ici,  puisque  grub n'a pas besoin d'etre
              relance apres l'installation d'une image  de  noyau,  et  qu'une
              modification  automatisee du contenu du menu est suffisante pour
              l'installation ou la suppression d'une image d'un noyau.

       build  Cette cible,  utilisee  par  la  cible  kernel_image  ci-dessus,
              compile le noyau Linux.

       modules
              Cette  cible  vous permet de generer tous les modules et paquets
              additionnels qui dependent fortement de la version du noyau pour
              laquelle   ils   ont  ete  compiles,  en  meme  temps  que  vous
              construisez votre image du noyau. Cette cible s'attend a trouver
              les modules et paquets sous /usr/src/modules, et, pour chacun de
              ces repertoires,  se  deplacera  dans  MODULE_LOC/x  (MODULE_LOC
              etant  par  defaut /usr/src/modules ), et lancera la regle kdist
              du fichier debian.rules qui s'y trouve. Cette cible creera le(s)
              paquet(s)  Debian  de(s)  module(s),  ainsi  qu'un  fichier  tar
              compresse  et   un   fichier   diff   compresse,   les   md5sums
              correspondants,  crees  par  dpkg-genchanges, seront enregistres
              dans un fichier des modifications  (changes).  Ce  fichier  sera
              signe  avec  la  meme identite que celle utilisee pour signer le
              paquet du noyau. Cette option est utilisee par les  responsables
              qui deploient les paquets dans les archives de Debian.

       modules_config
              Cette  cible permet de configurer tous les paquets de MODULE_LOC
              qui pointent par defaut sur /usr/src/modules. A utiliser si vous
              avez  besoin  de  modifier  manuellement  certains  points de la
              configuration, ou si vous voulez compiler manuellement tous  les
              modules  additionnels.  A  n'utiliser  que si vous disposez deja
              d'un repertoire ./debian.

       modules_image
              Cette cible vous  permet  de  construire  tous  les  paquets  de
              MODULE_LOC  qui  pointent  par defaut sur /usr/src/modules, mais
              elle ne cree pas les fichiers sources ou diffs, ni ne cree ni ne
              signe  un  fichier des modifications (un fichier << changes >>).
              C'est la seule option liee aux modules dont vous aurez besoin si
              vous  voulez  juste  compiler les modules additionnels pour leur
              installation sur une ou plusieurs machines. Utilisee en  general
              en  conjonction  avec  kernel_image,  notamment si vous invoquez
              aussi l'option append_to_version (afin d'eviter de faux messages
              d'avertissement).  A  n'utiliser  que si vous disposez deja d'un
              repertoire ./debian.

       modules_clean
              Cette  cible  vous  permet  de  nettoyer  tous  les  paquets  de
              MODULE_LOC  qui pointent par defaut sur /usr/src/modules, ce qui
              devrait etre suffisant pour defaire  tout  ce  qu'ont  pu  faire
              toutes  les autres cibles modules_truc. A n'utiliser que si vous
              disposez deja d'un repertoire ./debian.

       configure
              Cette cible lance configure (en fait config_target,  defini  par
              --config  qui  pointe  par  defaut  sur oldconfig) assez tot, de
              sorte que vous puissiez  editer  les  fichiers  crees  par  make
              config  dans  le  repertoire  des  sources  du  noyau,  sans que
              make-kpkg ne les ecrase ensuite.

       debian Cette cible cree le repertoire ./debian et patche eventuellement
              le  source. Cette cible est appelee par la cible configure. Vous
              utiliserez cette cible  pour  patcher  les  sources,  puis  vous
              lancerez  l'etape de configuration manuellement afin de mettre a
              jour le fichier  de  configuration  avec  toutes  les  nouvelles
              options  de  configuration  que  les  patches  pourraient  avoir
              ajoutees.

       libc-kheaders
              C'est une cible speciale pour les responsables de libc-dev,  qui
              peuvent  s'en  servir  pour creer les paquets d'en-tetes dont la
              libc a besoin. Notez qu'il est dangereux de creer un  paquet  de
              libc-kheaders  d'en-tetes  differentes de celles avec lesquelles
              la libc a ete compilee. C'est une cause connue d'arrets  brutaux
              du  systeme.  Consultez /usr/share/kernel-package/README.headers
              pour plus d'informations. Creer et installer votre propre paquet
              libc-kheaders peut endommager votre systeme, a moins que vous ne
              soyez sur de ce vous faites. Vous etes prevenus.

VARIABLES D'ENVIRONNEMENT

       KPKG_DEBUG, s'il  est  defini,  demande  a  make-kpkg  de  cracher  des
       messages  de  mise  au  point (debug) concernant des fonctions du shell
       executees en interne. Cela n'interessera probablement personne, a  part
       ceux  qui mettent au point make-kpkg. Les variables suivantes (decrites
       plus    haut)    affectent    make-kpkg :     DEBIAN_REVISION_MANDATORY
       APPEND_TO_VERSION  VERSION_H_OK  KPKG_ARCH  CROSS_COMPILE  KPKG_SUBARCH
       KPKG_OVERLAY_DIR  ARCH_IN_NAME  INITRD   SOURCE_CLEAN_HOOK   MODULE_LOC
       CONCURRENCY_LEVEL IGNORE_UPPERCASE_VERSION

FICHIERS

       Outre  les  options  de  lancement,  le  fichier debian.rules lance par
       make-kpkg recherche egalement un  fichier  de  configuration  propre  a
       l'utilisateur  ~/.kernel-pkg.conf.  En  cas d'absence de ce fichier, il
       recherche un reglage par defaut pour tout le systeme  dans  le  fichier
       /etc/kernel-pkg.conf.   La   configuration   par   defaut   permet   le
       remplacement pour tout le systeme du nom complet et du courriel  de  la
       personne  responsable  de  la  maintenance  des paquets du noyau sur le
       site, mais les fichiers  /etc/kernel-pkg.conf  (ou  ~/.kernel-pkg.conf)
       sont  en  fait des bribes de Makefile, et toute directive valide peut y
       etre incluse. Note : La prudence est de mise avec ce  fichier,  puisque
       vous  pouvez  changer completement le comportement du make en modifiant
       son          contenu.          Consultez           le           fichier
       /usr/share/doc/kernel-package/Problems.gz  pour  connaitre la liste des
       problemes recenses lors de la  compilation  des  images  du  noyau.  Un
       tutoriel  exhaustif  et  une  documentation sont aussi disponibles dans
       /usr/share/doc/kernel-package/README.gz   et   leurs   lectures    sont
       recommandees avant l'utilisation de cet utilitaire.

VOIR AUSSI

       kernel-pkg.conf(5),       kernel-img.conf(5)       Getopt::Long(3perl),
       dpkg-deb(1), dpkg-source(1), make(1), le manuel  des  Programmeurs,  le
       manuel  du  make  du  GNU  et  la  documentation complete du repertoire
       /usr/share/doc/kernel-package.

AUTEUR

       Cette page a ete ecrite par  Manoj  Srivastava,  <srivasta@debian.org>,
       pour le systeme Debian GNU/Linux.