Page suivante - Page précédente - Table des matières

6. Compiler des RPMs

Compiler ses RPMs est très simple, spécialement si vous pouvez obtenir du logiciel que vous essayez qu'il se compile tout seul.

La procédure de base pour compiler un RPM est la suivante :

  • Assurez-vous que votre fichier /etc/rpmrc est paramétré pour votre système.
  • Récupérez les sources donc vous compilez le RPM pour la compilation sur votre système.
  • Faites un patch des changements que vous devez faire aux sources pour qu'elles compilent correctement.
  • Faites un fichier spec pour le paquetage.
  • Assurez-vous que chaque chose est à sa place.

En utilisation normale, RPM construit aussi bien des paquetages sources que des binaires.

6.1 Le fichier rpmrc

Maintenant, la seule configuration de RPM is disponible via le fichier /etc/rpmrc. Un exemple de celui-ci ressemble à : 

 require_vendor: 1
 distribution: I roll my own!
 require_distribution: 1
 topdir: /usr/src/me
 vendor: Mickiesoft
 packager:  Mickeysoft Packaging Account <packages@mickiesoft.com> optflags: i386 -O2 -m486 -fno-strength-reduce
 optflags: alpha -O2
 optflags: sparc -O2
 signature: pgp
 pgp_name: Mickeysoft Packaging Account
 pgp_path: /home/packages/.pgp
 tmppath: /usr/tmp

La ligne require_vendor fait que RPM trouve une ligne vendor. Elle peut provenir du fichier /etc/rpmrc ou de l'en-tête du fichier spec lui-même. Pour désactiver ceci, mettez le nombre à 0. Cela reste vrai pour les lignes require_distribution et require_group.

La ligne suivante est la ligne distribution. Pour pouvez définir cela ici ou plus tard, dans l'en-tête du fichier spec. Quand vous compilez pour une distribution particulière, il est conseillé de s'assurer que cette ligne est correcte, bien que ça ne soit pas requis. La ligne vendor fonctionne selon le même principe, mais peut être n'importe quoi (ex: Joe's Software and Rock Music Emporium).

RPM supporte aussi maintenant la création de paquetages sur des architectures multiples. Le fichier rpmrc peut conserver une variable "optflags" pour compiler ce qui requiert des options spécifiques à l'architecture durant la compilation. Voir plus loin les paragraphes concernant l'utilisation de cette option.

En supplément des macros ci-dessus, il y en a beaucoup plus. Vous pouvez utiliser :

 rpm --showrc
pour savoir comment vos options sont définies et quels sont les options disponibles.

6.2 Le fichier Spec

Nous avons commencé à parler du fichier spec. Les fichiers spec sont requis pour construire un paquetage. Le fichier spec est une description du logiciel accompagnée des instructions concernant sa compilation, ainsi qu'une liste des fichiers pour tous les binaires qui seront installés.

Il est recommandé nommer votre fichier spec conformément à une convention standard, c'est à dire nom_du_paquetage-numéro_de_version-numéro de release.spec.

Voici un petit fichier spec (vim-3.0-1.spec):

 Summary: ejects ejectable media and controls auto ejection
 Name: eject
 Version: 1.4
 Release: 3
 Copyright: GPL
 Group: Utilities/System
 Source: sunsite.unc.edu:/pub/Linux/utils/disk-management/eject-1.4.tar.gz
 Patch: eject-1.4-make.patch
 Patch1: eject-1.4-jaz.patch
 %description
 This program allows the user to eject media that is autoejecting like
 CD-ROMs, Jaz and Zip drives, and floppy drives on SPARC machines.
 %prep
 %setup
 %patch -p1
 %patch1 -p1
 %build
 make RPM_OPT_FLAGS="$RPM_OPT_FLAGS"
 %install
 install -s -m 755 -o 0 -g 0 eject /usr/bin/eject
 install -m 644 -o 0 -g 0 eject.1 /usr/man/man1
 %files
 %doc README COPYING ChangeLog
 /usr/bin/eject
 /usr/man/man1/eject.1

6.3 L'en-tête

L'en-tête comporte des champs standard que vous devez remplir. Il y a quelques restrictions bien sûr. Les champs doivent être remplis comme suit :

  • Summary: C'est la description du paquetage en une ligne.
  • Name: Cela doit être la partie "nom" du fichier rpm que vous projetez d'utiliser.
  • Version: Cela doit être la partie "version" du fichier rpm que vous projetez d'utiliser.
  • Release: C'est le numéro de release pour un paquetage d'une même version (par exemple si vous construisez un paquetage et que vous le trouvez qu'il est légèrement râté et que vous souhaitez le reconstruire, le paquetage suivant aura le numéro de release 2).
  • Icon: c'est le nom du fichier icône pour utilisation par un autre utilitaire d'installation de "haut niveau" (comme glint ou gnorpm). Ce doit être un gif et doit être placé dans le répertoire SOURCES.
  • Source: Cette ligne pointe sur l'emplacement d'origine des sources de base. Il est utilisé si vous voulez réobtenir les sources ou regarder si il existe une version plus récente. Restriction: le nom du fichier dans cette ligne doit concorder avec le nom du fichier que vous avez sur votre propre système (c'est à dire ne pas télécharger les sources et changer le nom du fichier). Vous pouvez aussi spécifier plus d'un fichier source en utilisation des lignes comme : 

     Source0: blah-0.tar.gz
 Source1: blah-1.tar.gz
 Source2: fooblah.tar.gz

    Ces fichiers iront dans le répertoire SOURCES (la structure des répertoires est abordée dans un autre paragraphe, "L'arborescence du répertoire des sources".)

  • Patch: C'est l'emplacement où vous pouvez trouvez le patch si vous voulez le retélécharger. Restriction: le nom du fichier dpot concorder avec celui que vous utilisez qaudn vous faites VOTRE patch. Notez que vous pouvez avoir plusieurs fichiers patch de la même façon que vous pouvez avoir plusieurs sources. Vous auriez ainsi quelque chose comme : 

     Patch0: blah-0.patch
 Patch1: blah-1.patch
 Patch2: fooblah.patch
    Ces fichiers vont dans le répertoire SOURCES.

  • Copyright: Cette ligne indique la façon dont le package est protégé légalement. Vous pouvez utiliser quelque chose comme GPL, BSD, MIT, public domain, Distributable, ou commercial.
  • Buildroot: Cette ligne vous permet de spécifier un répertoire comme "root" pour la compilation et l'installation du nouveau paquetage. Vous pouvez l'utiliser pour faciliter les tests de votre paquetage avant de l'installer sur votre machine.
  • Group: Cette ligne est utilisée pour donner aux programmes d'installation de haut niveau l'emplacement de ce paquetage dans leur structure hiérarchique. La arborescence des groupes ressemble actuellement à : 

    Applications
 Communications
 Editeurs
 Emacs
 Ingéniérie
 Tableurs
 Bases de données
 Graphiques
 Réseau
 Mail
 News
 Publication
 TeX
Base
 Noyau
Utilitaires
 Archive
 Console
 Fichiers
 Système
 Terminal
 Texte
Démons
Documentation
X11
 XFree86
 Serveurs
 Applications
 Graphiques
 Réseau
 Jeux
 Stratégie
 Vidéo
 Amusements
 Utilitaires
 Librairies
 Gestionnaires de fenêtres
Librairies
Réseaux
 Admin
 Démons
 News
 Utilitaires
Développement
 Débuggeurs
 Librairies
 Libc
 Langages
 Fortran
 Tcl
 Construction
 Contrôle de version
 Utilitaires
Shells
Jeux

  • %description Ce n'est pas pas vraiment un champ de l'en-tête, mais doit être décrit avec le reste de celui-ci. Vous avez besoin d'un champ description par paquatage/sous-paquetage. C'est un champ multilgine qui est utilisé pour donner une description claire du paquetage.

6.4 Prep

C'est la seconde section du fichier spec. Il est utilisé pour préparer les sources à la compilation. Vous mettez ce que vous avez besoin de faire pour patcher les sources et paramétrer, comme ce que vous mettriez pour compiler les sources.

Une chose importante: chacune de ces sections est simplement un emplacement pour exécuter des scripts shell. Vous pourriez simplement faire un script sh et le mettre après le tag %prep pour décompresser et patcher vos sources. Nous avons conçu des macros pour aider à cela, toutefois.

La première de ces macros est %setup. Dans sa forme la plus simple (pas d'options de ligne de commande), elle décompresse simplement les sources et se rend dans le répertoire des sources. Elle prend aussi les options suivantes :

  • -n nom va définir le nom du répertoire de compilation. La valeur par défaut est $NAME-$VERSION. D'autres possibilités, parmi lesquelles $NAME, ${NAME}${VERSION}, ou n'importe quoi utilisé par le fichier tar principal. (Notez que ces variables "$" ne sont pas des variables réelles disponibles à l'intérieur du fichier spec . En réalité, elles sont juste utilisées ici à la place du nom de l'exemple. Il est nécessaire d'utiliser les vrais noms et versions dans votre paquetage, et non une variable.)
  • -c va créer et se rendre dans le répertoire donné avant de détarrer.
  • -b # va détarrer Source# avant de se rendre dans le répertoire (et cela n'a aucun sens avec -c donc ne les associez pas). C'est utile seulement avec de multiples fichiers source.
  • -a # va détarrer Source# après s'être rendu dans le répertoire.
  • -T Cette option supplante l'action par défaut de détarrer le Source et requiert un -b 0 ou -a 0 pour détarrer le fichier source principal. Vous en aurez besoin quand il y a des sources secondaires.
  • -D N'efface pas le répertoire avant la décompression. C'est seulement utilse où vous avez plus d'un macro setup Cela doit être utilisé uniquement dans les macros setup après la première (mais jamais dans celle-ci).

La macro suivante est la macro %patch. Cette macro aide à automatiser le processus d'application des patches aux sources. Il comporte plusieurs options, listées ici :

  • # va appliquer Patch# comme fichier patch
  • -p # spécifie le nombre de répertoires à éliminer pour la commande patch(1) (NdT: option -p).
  • -P L'action par défaut est d'appliquer Patch (ou Patch0). Ce paramètre inhibe ce comportement par défaut et requierrera un 0 pour détarrer le fichier. Cette option est très utile en seconde (ou plus) macro %patch qui requiert un numéro différent de la première macro.
  • Vous pouvez aussi faire %patch# au lieu de faire la commande réelle: %patch # -P

Ce sont toutes les macros dont vous avez besoin. Après que vous les ayez faites, vous pouvez également faire un autre réglage dont vous avez besoin via un script sh. Tout ce que vous incluez jusqu'à de la macro %build (évoquée dans la section suivante) est exécuté par sh. Regardez l'exemple plus haut afin de vous donner une idée du genre de choses que vous pouvez faire ici.

6.5 Compiler

Ils n'y a pas de vraies macros pour cette section. Vous devez juste mettre ici les commandes dont vous avez besoin pour compiler le logiciel lorsque vous avez détarré les sources, patchées celles-ci, et vous être rendu dans le répertoire. C'est juste un autre ensemble de commandes passées à sh, donc n'importe quelle commande acceptée par sh peut être placée ici (y compris des commentaires). Votre répertoire de travail courant est rétabli dans ces sections au répertoire racine des cources, gardez cela en mémoire. Vous devez changer de répertoire pour atteindre les sous-répertoires si nécessaire.

6.6 Installation

De même, il n'y a pas ici non plus de vraies macros. Vous mettrez ici simplement les commandes donc vous avez besoin pour installer. Si vous avez un "make install" disponible dans le paquetage que vous compilez, mettez-le ici. Sinon, vous pouvez patcher le Makefile pour un "make install" et faire juste un make install ici, ou l'installer à la main ici avec des commandes sh. Considérez que votre répertoire courant est le répertoire racine de vos sources.

6.7 Scripts d'installation/désinstallation optionnels

Vous pouvez mettre des scripts qui seront exécutés avant et après l'installation et la désinstallation de paquetages binaires. Une des principales raison pour ça est la nécessité de lancer /sbin/ldconfig après l'installation ou la suppression de paquetages contenant des librairies partagées. Les macros pour chacun de ces scripts sont les suivantes:

  • %pre est la macro qui fait les scripts de pré-installation.
  • %post est la macro qui fait les scripts de post-installation.
  • %preun est la macro qui fait les scripts de pré-désinstallation.
  • %postrun est la macro qui fait les scripts de post-désinstallation.

Le contenu de ces sections doit ressembler à un script sh, sauf que vous n'avez pas besoin de #!/bin/sh.

6.8 Fichiers

C'est la section où vous devez lister les fichiers pour le paquetage binaire. RPM n'a aucun moyen de connaitre quels fichiers sont installés par le "make install". Il n'y a PAS de moyen de le savoir. Certains ont suggéré de faire un "find" avant et après l'installation. Avec un système multiutilisateur, c'est inacceptable car d'autres fichiers qui n'ont rien à voir peuvent être crées pendant le processus d'installation.

Il y a plusieurs macros disponibles pour faire des choses spéciales. Elles sont listées et décrites ici:

  • %doc est utiliser pour marquer la documentation dans le paquetage source que vous voulez installer dans un paquetage binaire. Les documents seront installés dans /usr/doc/$NAME-$VERSION-$RELEASE. Vous pouvez lister plusieurs documents sur la ligne de commande avec cette macro, ou les lister séparément en utilisant une macro pour chaque.
  • %config est utilisé pour marquer les fichiers de configuration dans un paquetage. Cela inclut des fichiers comme sendmail.cf, passwd, etc. Si vous déinstallez par la suite un paquetage contenant des fichiers de configuration, les fichiers non modifiés seront supprimés et les fichiers modifiés seront conservés avec l'extension .rpmsave. Vous pouvez bien sûr mettre plusieurs fichiers avec cette macro.
  • %files -f nomfichier va vous permettre de lister vos fichiers dans un fichier arbitraire à l'intérieur du répertoire de compilation des sources. C'est pratique dans le cas où vous avez un paquetage qui ne peut pas construire sa propre liste de fichiers. Vous incluez alors simplement cette liste de fichiers ici, et vous ne devez pas lister les fichiers spécifiquement.

Le plus gros inconvénient dans le liste de fichier est la liste des répertoire. Si vous listez /usr/bin par accident, votre paquetage va contenir tous les fichiers de /usr/bin sur votre système.

6.9 Le compiler

L'arborescence du répertoire des sources

La première chose dont vous avez besoin est une arborescence de compilation bien configurée. C'est configurable dans /etc/rpmrc. La plupart des gens utiliseront simplement /usr/src.

Vous aurez probablement besoin de créer les répertoires suivants pour construire l'arborescence de compilation:

  • BUILD est le répertoire où toutes les compilations par RPM ont lieu. Vous ne devez pas faire vos tests de compilation quelquepart en particulier, mais c'est là où RPM va faire sa compilation.
  • SOURCES est le répertoire où vous mettrez le fichier source tarré original et vos patches. C'est là que RPM regarde par défaut.
  • SPECS est le répertoire où tous les fichiers spec vont.
  • RPMS is le répertoire où RPM va mettre tous ses binaires RPMs compilés.

Test de la compilation

La premireè chose que vous voudrez probablement faire est de compiler proprement la source sans utiliser RPM. Pour faire cela, décompressez les sources, et changez le nom du répertoire en $NAME.orig. Ensuite re-décompressez les sources. Utilisez ces sources pour compiler. Allez à l'intérieur de celui-ci et suivez les instructions de compilation pour le compiler. Si vous devez éditer des choses, vous aurez besoin d'un patch. Dès que vous réuississez à le compiler, nettoyez le répertoire des sources. Effacez les fichiers qui ont été obtenus par le script configure. Ensuite, remontez au répertoire parent. Vous ferez ensuite quelque chose comme :

 diff -uNr dirname.orig dirname> ../SOURCES/dirname-linux.patch

Cela créera un patch pour vous que vous pourrez utilisez dans votre fichier spec. Notez que le "linux" que vous voyez dans le nom du patch est juste un identificateur. Vous voudrez sûrement utiliser quelque chose de plus descriptif comme "config" ou "bugs" pour décrire pourquoi vous avez dû faire un patch. De plus il est recommandé de vérifier dans le fichier patch que vous avez créé que vous n'avez pas inclus de binaires par accident avant de l'utiliser.

Générer la liste des fichiers

Maintenant que vous avez des souces qui vont compiler et que vous savez comment le faire, compilez-les et installez-les. Regardez la sortie de la séquence d'installation et construisez la liste de fichiers que vous utiliserez dans le fichier spec à partir de celle-ci. On construit habituellement le fichier spec en parallèle avec toutes ces étapes. Vous pouvez créer celui de base et remplir ses parties les plus simples, et ensuite remplir les autre étapes au fur et à mesure.

Compiler le package avec RPM

Dès que vous avez un fichier spec, vous êtes prêt à essayer et à compiler votre paquetage. Le voie la plus utilisée pour faire cela est avec une commande qui ressemble à la suivante :

 rpm -ba foobar-1.0.spec
Il y a d'autres options utiles avec le paramètre -b :

  • p signifie d'éxécuter simplement la section prep du fichier spec.
  • l est un vérificateur de liste qui fait des contrôles sur %files.
  • c fait le prep et compile. C'est utile quand vous n'êtes pas sûr du tout de la source que vous compilez. Cela semble peu utile parce que vous travaillerez avec les sources elles-mêmes jusqu'à ce qu'elles compilent et commencerez seulement à travailler avec RPM, mais dès que vous serez accoutumé à l'utilisation de RPM vous trouverez des cas où vous les utiliserez.
  • i fait un prep, compile, et installe.
  • a fait tout (paquetages source et binaire).

Il y a plusieurs modificateurs à l'option -b. Ce sont les suivants:

  • --short-circuit va sauter à une étape (peut être utilisé uniquement avec c et i).
  • --clean efface l'arborescence de compilation quand le travail est terminé.
  • --keep-temps va conserver tous les fichiers temporaires et les scripts fais dans /tmp. Vous pouvez actuellement voir quels fichiers ont été crées dans /tmp en utilisant l'option -v.
  • --test n'exécute aucune des étapes réelles, mais conserve les fichiers temporaires.

6.10 Le tester

Dès que vous avez des rpms source et binaire pour votre paquetage, vous devez le tester. La voie la plus simple et la meilleure est d'utiliser pour les tests une machine totalement différente de celle sur laquelle vous avez construit le paquetage. Après tout, vous avec juste fait un ensemble de "make install" sur votre propre machine, alors il pourrait aussi bien être installé.

Vous pouvez faire un rpm -u nom_du_paquetage sur le paquetage pour tester, mais vous pouvez être déçu parce durant la construction du paquetage, vous avez fait un make install. Si vous avez laissé quelque chose en dehors de votre liste des fichiers, il ne sera pas désinstallé. Vous réinstallerez alors le paquetage binaire et votre système sera de nouveau complet, mais votre rpm toujours pas. Gardez à l'esprit que vous faites un rpm -ba paquetage, la plupart des peersonnes installeront simplement celui-ci avec rpm -i paquetage. Assurez-vous de ne rien faire dans la section build ou install qui aura besoin d'être fait quand les binaires seront installés par eux-mêmes.

6.11 Que faire avec vos nouveaux RPMs

Dès que vous avez construit votre propre rpm de quelque chose (si il n'a pas déjà été "RPMisé"), vous pouvez faire profier les autres de votre travail (si votre rpm est un logiciel librement redistribuable). Pour cela, vous l'uploaderez sur ftp://contrib.redhat.com/

6.12 Que faire maintenant ?

Regardez les sections précédentes Tests et Que faire ... Nous voulons tous les RPMs que nous pouvons obtenir, et nous voulons que ce soient tous les bons RPMs. Prenez le temps de les tester correctement, et ensuite prenez le temps de les uploader afin que chacun en bénéficie. De même, assurez-vous que vous uploadez uniquement des logiciels librement redistribuables. Les logiciels commerciaux et les sharewares ne doivent pas être uploadés à moins que le copyright le permette explicitement. Cela inclut Netscape, ssh, pgp, etc.

Page suivante - Page précédente - Table des matières