« Faireunpaquet » : différence entre les versions

Ce petit memento comporte 5 parties: <br /><br />1) Fabrication d'un paquet élémentaire (vikings) <br />2) Fabrication d'un paquet plus compliqué avec compilation (cacheproc) <br />3) Exemple d'un paquet de scripts de mise à jour <br />4) Le rétroportage vite fait, bien ou mal fait <br />5) ./configure;make;make install et paquet debian... <br />6)Recompilation<br />7) Fabrication directe.<br /><br />'''Les sources et les résultats de ces paquets se trouve sur <br />deb http://boisson.homeip.net/sarge/ ./ <br />deb http://boisson.homeip.net/source ./ <br />'''<br /><br /><u>'''1) Un exemple très simple: vikings'''</u><br /><br />'''On ne travaille PAS sous root'''<br /><br />Ce paquet contient une arborescence /usr/games/lost et un script /usr/games/vik. Les fichiers sont tout prêts et n'ont pas besoin de préparation. <br /><br />- faire un répertoire /tmp/vikings-1.0 <br />- Y mettre vik et le répertoire lost <br />- Faire

</center>

<br />dh_make pose la question de savoir si c'est un paquet simple (oui), multiple, librairie ou module noyau. Il crée un répertoire debian et un répertoire /tmp/vikings-1.0.orig permettant de faire le fichier .diff.gz (les paquets sources contiennet en général les sources initiaux, un fichier .diff rajoutant l'arborescence et les patchs debian et un fichier .dsc décrivant le paquet). ''A ce stade, il est important de noter que seules des modifications de textes sont permises. Si un binaire est modifié dans le paquet source, il est nécessaire de supprimer le répertoire /tmp/vikings-1.0.orig, les sources seront alors composés d'un fichier .tar.gz et d'un fichier .dsc (pas de diff.gz),''<br />Puis viennent les éditions

<br />$ emacs debian/control

</center>

<center>

</center>

<br />par

</center>

</center>

</center>

<center>

<br />''Le répertoire de travail est /tmp/vikings-1.0=CURDIR, $(CURDIR)/debian/vikings contient l'arborescence du paquet à venir''. Il est parfois bon de faire au préalable

'''Code:'''

<br />        mkdir -p $(CURDIR)/debian/vikings/usr/games <br />        cp -dpRf vik lost $(CURDIR)/debian/vikings/usr/games

<br />Pour créer le répertoire. Une autre méthode plus simple consiste à déclarer le répertoire dans debian/dirs

<br />(Y mettre usr/games et virer le reste). Faire

{| width="90%" cellspacing="1" cellpadding="3"

'''Code:'''

|-

|}

</center>

'''Code:'''

|-

<br />$ fakeroot dpkg-buildpackage -us -uc

<br />qui fabrique les paquets sources et le .deb. <br />Supposons que damned, faute de frappe et le paquet plante, dans ce cas, repartir de sources propres:

<br />$ cd .. <br />$ rm -Rf vikings-1.0/ <br />$ dpkg-source -x vikings_1.0-1.dsc <br />$ cd vikings-1.0/ <br />$ emacs [le fichier fautif (Makefile ou debian/rules souvent)] <br />$ fakeroot dpkg-buildpackage -us -uc

</center>

<br />Le paquet vikings_1.0-1_i386.deb est cré dans la racine. <br /><br /><u>'''2) Un deuxième exemple: cacheproc'''</u><br /><br />cacheproc est un petit programme recherchant des processus cachés, il est écrit en camllight. Il se compose de

{| width="90%" cellspacing="1" cellpadding="3"

<br />-rw-r--r--  1 francois src 2474 2004-01-19 22:08 chercheprocess.ml <br />-rw-r--r--  1 francois src  707 2004-01-19 22:22 Makefile <br />-rw-r--r--  1 francois src 1450 2004-01-19 22:32 README <br />-rw-r--r--  1 francois src 1936 2004-01-19 22:08 regarde.ml

{| width="90%" cellspacing="1" cellpadding="3"

</center>

<center>

|-

<br />       $(MAKE) all

au lieu de $(MAKE) dans le build-stamp et commenter le dh_strip (les objets caml supporte mal le strip (=compression de l'exe)). <br />Reste donc à faire le Makefile. J'utilise un Makefile «générique» que je modifie à la demande. Il contient

<center>

'''Code:'''

<br />        echo -n "Starting $DESC: $NAME" <br />        cp /etc/apt/sources.list.lycee /etc/apt/sources.list <br />        apt-get update <br />        apt-get install -y lycee <br />        cp /etc/apt/sources.list.vrai /etc/apt/sources.list <br />        echo "." <br />   # rajout éventuel de compléments

<br />$ chmod +x /etc/init.d/maj <br />$ update-rc.d maj defaults 99

<br />/etc/apt/sources.list.lycee <br />contient une ligne <br />deb file:/home/ftp/ / <br />qui est ici un dépot partagé via nfs. <br /><br />Le paquet pris en exemple est celui qui me permet de gérer les salles du lycée où je travaille. A l'heure actuelle il contient

<center>

<center>

<br />#!/usr/bin/make <br />prefix          = /usr <br />exec_prefix     = ${prefix} <br />srcdir          = . <br /><br />bindir          = ${exec_prefix}/bin <br />DESTDIR= <br /><br /><br />distclean: clean <br /><br />clean: <br /><br />install: <br />        mkdir -p $(DESTDIR)/etc/init.d <br />        mkdir -p $(DESTDIR)/etc/apt/ <br />        mkdir -p $(DESTDIR)/usr/local/bin <br />        mkdir -p $(DESTDIR)/usr/local/windows <br />        cp -dpf maj $(DESTDIR)/etc/apt <br />        cp sources.list.lycee $(DESTDIR)/etc/apt/ <br />        cp lomount $(DESTDIR)/usr/local/bin <br />        cp repareW98 $(DESTDIR)/usr/local/bin <br />   cp tux.xpm   $(DESTDIR)/var/lycee <br />        chmod +x $(DESTDIR)/usr/local/bin/* <br />        cp init.reg autoexec.bat $(DESTDIR)/usr/local/windows

<br /><br />Pour le fichier debian/rules, il n'y a pas de fabrication de binaires (donc commenter le $(MAKE) de build-stamp). Le reste est le script par défaut. <br /><br />Le fichier debian/control contient les paquets rajoutés sur les machines au fur et à mesure de leur évolution:

<center>

{| width="90%" cellspacing="1" cellpadding="3"

<br />Source: lycee <br />[.....] <br />Package: lycee <br />Architecture: any <br />Depends: ${shlibs:Depends}, ${misc:Depends}, camllight (&gt;= 0.75-2), ntpdate, fingerd, sun-j2re1.4, tuareg-mode <br />Description: paquet de MAJ Lycee <br /> Mise à jour incrémentale des systèmes Linux

<br /><br />Ici j'ai rajouté camllight, le mode tuareg pour caml, un java, ntpdate pour synchroniser les machines et fingerd pour savoir qui travaille et quand sur les machines (c'est mon coté bigbrother qu'il faut bien assumer). <br /><br /><br />Enfin, le fichier debian/postinst exécute les différents patchs éventuels:

<br />... <br />case "$1" in <br />    configure) <br /># remplacement de maj <br />    cp /etc/apt/maj /etc/init.d <br />    chmod +x /etc/init.d/maj <br />        update-rc.d maj defaults 99 <br /># exécution patch1 <br />    if [ ! -f /etc/lycee/patch1 ] ; then <br />        mkdir -p /etc/lycee/ <br />        touch /etc/lycee/patch1 <br /># là mettre les commandes du patch1, ici remplacement logo <br />        cd /etc/X11/xdm/pixmaps <br />        rm tux.xpm <br />        ln -s /var/lycee/tux.xpm <br />        echo "Patch1 appliqué" <br /><br />    fi <br />        ;; <br />    abort-upgrade|abort-remove|abort-deconfigure) <br /><br />    ;; <br /><br />    *) <br />        echo "postinst called with unknown argument \`$1'" &gt;&amp;2 <br />        exit 1 <br />    ;; <br />esac <br />...

<br /><br />Pour faire une mise à jour sur les machines, il suffit donc de mettre à jour le dépot local et tout se fera automatiquement. Cela a remplacé avantageusement le rapatriement automatique de scripts. Ça montre bien la puissance du paquetage .deb qui permet vraiment de tout faire très simplement <br /><br /><u>'''4) Fabrication rapide de backports.'''</u><br /><br />Le problème s'est posé pour moi pour clamav avant la mise en place de debian/volatile (que je n'utilise pas du coup). clamav fait des maj régulièrement et mon serveur était sous potato puis est maintenant sous woody (je n'ai pas le temps ni le vrai désir de passer sous sarge). Il s'agit donc de faire des backports de clamav. Il se trouve que Stephen Gran a fait un paquet très propre (en tout cas la version 0.80), lors des mise à jour je procède comme suit: <br /><br />Mettons que je parte de la version 0.80 <br />0) Récupération de l'arborescence debian de ce paquet <br />1) rapatriement de l'archive source clamav nouvelle <br />2) dépilage de cette archive et renommage du répertoire en clamav-0.80 <br />3) Exécution de

<br />$ dch -v backport-0.88-4

<br />Le paquet sera dans la version backport-0.88 <br />4) Compilation

<br />$ cd ../clamav-0.88-4 <br />$ fakeroot dpkg-buildpackage -us -uc

<br /><br />C'est fini, les nouveaux paquets sont faits. <br /><br />Voici les commandes tapés pour le passage de 0.88-2 à 0.88-4:

<center>

<br /><br />C'est tout. Les sources obtenus me permettent de faire les paquets pour woody, sarge amd64, etc. <br /><br />Il peut y avoir quelques soucis nécessitant des retouches de debian/rules <br /><br /><u>'''5) Fabrication d'un paquet via checkinstall.'''</u><br /><br />attention, il y a un bug dans la version de checkinstall de lenny, le checkinstall n'existe pas chez etch, on pourra le trouver ici <br />'''deb http://boisson.homeip.net/debian etch divers'''<br />Pour contourner le bug, lancer checkinstall avec l'option --fstrans=no <br />Sinon, checkinstall ne peut construire correctement le paquet si l'installation se fait avec un programme binaire statique.<br /><br />Parfois, la méthode dh_make conduit à modifier le Makefile, on ne comprend plus rien et on a juste envie de faire un paquet et pas les paquets sources. Un petit génie a inventer checkinstall (par encore parfait mais bon)... <br /><br />Exemple scilab version 4 dont j'avais besoin en urgence (ci dessous de mémoire, c'est reconstitué). <br />Chargement rapide des sources, configuration classique:

<br />bref, du classique. <br />Là commence checkinstall:

<br />$ su <br /># checkinstall make install <br /><br />checkinstall 1.5.3, Copyright 2001 Felipe Eduardo Sanchez Diaz Duran <br />           This software is released under the GNU GPL. <br /><br /><br />The package documentation directory ./doc-pak does not exist. <br />Should I create a default set of package docs?  [y]: <br /><br />Preparing package documentation...OK <br /><br />Installing with "make install"... <br /><br />========================= Installation results =========================== <br /><br />Copying documentation directory... <br />[....] <br />======================== Installation succesful ========================== <br /><br />Copying files to the temporary directory...OK <br /><br />Striping ELF binaries and libraries...OK <br /><br />Compressing man pages...OK <br /><br />Building file list...OK <br /><br /><br />Please write a description for the package. <br />End your description with an empty line or EOF. <br />&gt;&gt;

<br />&gt;&gt; Scilab version 4 du 9 juillet 2006 <br />&gt;&gt;

<br />This package will be built according to these values: <br /> le numéro et en remplissant <br />0 -  Maintainer: [ [mailto:francois@boisson.homeip.net francois@chez.moi] ] <br />1 -  Summary: [ Scilab version 4 du 9 juillet 2006 ] <br />2 -  Name:    [ scilab ] <br />3 -  Version: [ 1.0 ] <br />4 -  Release: [ 1 ] <br />5 -  License: [ GPL ] <br />6 -  Group:   [ agreg ] <br />7 -  Architecture: [ i386 ] <br />8 -  Source location: [ scilab ] <br />9 -  Alternate source location: [  ] <br /><br />Enter a number to change any of them or press ENTER to continue: <br /><br />***************************************** <br />**** Debian package creation selected *** <br />***************************************** <br /><br />Building Debian package...OK <br /><br />Installing Debian package... <br /><br />Erasing temporary files...OK <br /><br />Writing backup package...OK <br /><br />Deleting temp dir...OK <br /><br /><br />********************************************************************** <br /><br /> Done. The new package has been installed and saved to <br /> /tmp/scilab/scilab_4.0_i386.deb <br /><br /> You can remove it from your system anytime using: <br /><br />      dpkg -r scilab <br /><br />********************************************************************** <br /><br />#

<br />/usr/local/bin/lsdepend: <br /><br />#!/bin/sh <br />find . -type f | xargs ldd 2&gt; /dev/null | <br /> sed -e '1,$s/=.*//' | <br /> sed -e '1,$s/^ */dpkg -S /' | grep -v ":" | <br /> grep "\.so" | <br /> sort -u | sh | <br /> sed -e '1,$s/:.*//' | <br /> sort -u | <br /> sed -e '1,$s/^/dpkg -l | grep "^[a-zA-Z]\\{2\\} * /' | sed -e '1,$s/$/ "/' |sh

</center>

<br />$ mkdir gre <br />$ cd gre <br />$ dpkg-deb -e ../scilab_4.0_i386.deb <br />$ dpkg-deb -x ../scilab_4.0_i386.deb .

<br />La troisième commande fabrique un répertoire DEBIAN contenant un seul fichier control contenant

<center>

</center>

<br />(La quatrième commande déplie l'archive des fichiers du paquet) <br />Pas de champ Depends dans ce fichier Control, donc de la pagaille et des déconvenues à prévoir. Pour cela on peut avoir une idée des paquets nécessaires avec le script lsdepend. Celui ci cherche les librairies appelées et donne la liste des paquets nécessaires. Ainsi ici, sachant que les bianires sont dans usr/lib/scilab-4.0/bin/

<br />$ cd /usr/lib/scilab-4.0/bin/ <br />francois@totoche:/usr/lib/scilab-4.0/bin$ lsdepend <br />ii  libc6          2.3.2.ds1-22   GNU C Library: Shared libraries and Timezone <br />ii  libg2c0        3.3.5-13       Runtime library for GNU Fortran 77 applicati <br />ii  libgcc1        3.4.3-12       GCC support library <br />ii  libice6        4.3.0.dfsg.1-1 Inter-Client Exchange library <br />ii  libncurses5    5.4-4          Shared libraries for terminal handling <br />ii  libsm6         4.3.0.dfsg.1-1 X Window System Session Management library <br />ii  libx11-6       4.3.0.dfsg.1-1 X Window System protocol client library <br />ii  libxext6       4.3.0.dfsg.1-1 X Window System miscellaneous extension libr <br />ii  libxmu6        4.3.0.dfsg.1-1 X Window System miscellaneous utility librar <br />ii  libxpm4        4.3.0.dfsg.1-1 X pixmap library <br />ii  libxt6         4.3.0.dfsg.1-1 X Toolkit Intrinsics <br />ii  maple4         1.0-1          Paquet Maple4 <br />ii  tcl8.4         8.4.9-1        Tcl (the Tool Command Language) v8.4 - run-t <br />ii  tk8.4          8.4.9-1        Tk toolkit for Tcl and X11, v8.4 - run-time <br />ii  xaw3dg         1.5+E-8        Xaw3d widget set <br />francois@totoche:/usr/lib/scilab-4.0/bin$

</center>

'''Code:'''

|-

<br />Depends: libc6, tk8.4, tcl8.4, xaw3dg, libxmu6, libxt6, libxext6, libsm6, libice6, libx11-6, libncurses5, libg2c0, libgcc1, libxpm4

<br />et le fichier DEBIAN/control suivant

<center>

</center>

'''Code:'''

<br />$ cd .. <br />$  dpkg-deb -b gre scilab_4.0_i386.deb <br />dpkg-deb : construction du paquet « scilab » dans « scilab_4.0_i386.deb ». <br />francois@totoche:/tmp$

</center>

<br /><br />et voilà le beau paquet scilab avec ses dépendances (du moins on l'espère). Bien évidemment, c'est rustique comme méthode mais cela permet de dupliquer une installation facilement et cela constitue une alternative pratique et rapide à la méthode classique sans sombrer dans les méandres d'un debian/rules ne fonctionnant pas...

<br /><br />6) Recompilation

Pour le coup c'est très simple. Il suffit de charger les sources, modifier eventuellement les options et recompiler le paquet. Soit donc pour le paquet paquet-1.23-6_i386.deb <br /><br />Code:<br />$ apt-get source paquet<br />$ cd paquet-1.23<br />$ emacs debian/rules <br /><br />(là chercher les options, regarder pres de la cible configure_stamp: ou build_stamp: et les modifier) <br /><br />Code:<br />$ fakeroot dpkg-buildpackage -b -uc<br />$ cd ..<br />$ ls *.deb<br /><br /><br />Le paquet est prêt.

'''<u>7) Fabrication directe.</u>'''

* Y mettre dedans un fichier control de la forme<br />Package: nomdupaquet<br />Priority: optional<br />Section: x11<br />Installed-Size: 4023 (si le paquet fait 4023K environ)<br />Maintainer: Georges Sand &lt;aurore.dupin@chopin.muses.fr&gt;<br />Architecture: all<br />Version: 1.0<br />Depends: xbase-clients<br />Description: Modifications de startx<br /> Lancement de X différent<br /> .

* Y mettre éventuellement un fichier '''postinst''' (éxécutable) pour les éventuels instructions à faire après l'installation. Dans le cas où un fichier d'un paquet est modifié (mettons startx ici) il est important de faire une «diversion», ce qui se fait par un fichier '''preinst '''<span>comme suit</span>:<br />set -e<br />case "$1" in<br /> install)<br /> dpkg-divert --package nomdupaquet --divert /usr/bin/startx.org --rename /usr/bin/startx<br /> dpkg-divert --package nomdupaquet --divert /usr/X11R6/bin/startx.org --rename /usr/X11R6/bin/startx<br /> ;;<br /> abort-upgrade)<br /> ;;<br /> upgrade)<br /> ;;<br /> *)<br /> echo "preinst called with unknown argument \`$1'" &gt;&amp;2<br /> exit 1<br /> ;;<br />esac<br />exit 0<br /><br />et bien sûr un fichier '''postrm'''<span> supprimant la diversion en cas de retrait du paquet:<br /><br />set -e<br />case "$1" in<br /> remove|purge)<br /> dpkg-divert --package xbase-agreg --rename --remove /usr/X11R6/bin/startx<br /> dpkg-divert --package xbase-agreg --rename --remove /usr/bin/startx<br /><br /> ;;<br /> upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)<br /> ;;<br /> *)<br /> echo "postrm called with unknown argument \`$1'" &gt;&amp;2<br /> exit 0<br />esac</span>

* <span>faire ensuite <br />$ cd /tmp/paquet<br />$ find . -type f | grep -v "^./DEBIAN" | md5sum &gt; DEBIAN/md5sums<br />$ su<br /># chown -R root.root *<br /># dpkg-deb -b . ../nomdupaquet-1.0_all.deb<br /></span><br /><br />

* <span>Le paquet est prêt.</span>