*.c *.h (Fichiers source) | COMPILATEUR | *.o (Fichier objet) | Librairies --> LIEUR <-- Fichiers objet | Fichier executable

Le fichier Makefile est un fichier nécessaire à make. Un fichier Makefile indique à make comment exécuter les instructions nécessaires à l'installation d'un logiciel ou d'une librairie.

Le fichier Makefile doit se trouver dans le répertoire courant lorsqu'on appelle make à l'invite du shell.

Les instructions contenues dans un fichier Makefile obéissent à une syntaxe particulière un peu stupide.

Une règle est une suite d'instructions qui seront exécutées pour construire une cible, mais uniquement si des dépendances sont plus récentes.

La syntaxe d'une règle est la suivante: cible: dependances commandes ...

La cible est généralement le nom d'un fichier qui va être généré par les commandes qui vont suivre, ou une action gérée par ces mêmes commandes, par exemple clean ou install (Voir chapitre IX [Cibles] pour plus de détails sur les conventions utilisées dans l'attribution d'un nom à une règle).

Les dépendances sont les fichiers ou les règles nécessaires à la création de la cible. Par exemple un fichier en-tête ou un fichier source dans le cas d'une compilation C. Dans le cas d'un fichier, la cible n'est construite que si ce fichier est plus récent que la cible.

C'est une suite de commandes shell qui seront exécutées au moment de la création de la cible. Une étrangeté de la syntaxe des fichiers Makefile oblige l'utilisateur de make à insérer une tabulation au début de chaque ligne, faute de quoi make affichera une erreur au moment de son exécution.

La syntaxe de make oblige aussi l'utilisateur à ajouter une caractère "backslash" ('\') à la fin de chaque ligne dès que les commandes à exécuter dépassent une ligne de texte.

# Mon premier Makefile all: foobar.o main.c gcc -o main foobar.o main.c foobar.o: foobar.c foobar.h gcc -c foobar.c -o foobar.o

Si vous avez enregistré l'exemple ci-dessus dans un fichier Makefile, il ne nous reste plus qu'a exécuter make dans le même répertoire que celui où vous avez enregistré le fichier.

Make s'exécute tout simplement en lançant la commande:

$ make all

Make va alors interpréter le fichier Makefile et exécuter les commandes contenues dans la règle all, une fois que les dépendances foobar.o et main.c seront vérifiées.

C'est à dire dire que si foobar.o ou main.c sont plus récents que le fichier main, make recompilera main.

Notez que si j'avais simplement tapé: "make" le résultat serait le même car quand make est exécuté sans argument, make exécute la première règle recontrée.

La déclaration se fait tout simplement avec la syntaxe ci-dessous: NOM = VALEUR Les espaces insérés ici ne sont pas obligatoires, mais facilitent la lisibilité du Makefile. La valeur affectée à la variable peut comme pour les macro-commandes du C comporter n'importe quels caractères, elle peut aussi être une autre variable.

La syntaxe de l'appel de la macro-commande est la suivante: $(NOM)

prefix = /usr/local bindir = $(prefix)/bin

Un pattern s'utilise un peu comme un caractère joker, mais uniquement dans le cas des cibles. Le caractère faisant office de joker est le caractère pourcent ('%').

L'intérêt est d'avoir plusieurs cibles. Les patterns permettent de filtrer les cibles pour savoir pour lesquelles d'entre elles les commandes qui suivent seront exécutées.

Pourquoi cet exemple est-il idiot ? Tout simplement parcequ'on met pèle-mêle tous les fichiers à compiler dans la même variable OBJECTS. Le plus simple aurait été d'utiliser plusieurs variables et de faire des règles différentes pour chaque type de compilation (normale, x11, athena).

# Notons que les objets sont à la fois des fichiers objets à lier et # des exécutables à compiler OBJECTS = text/main.o text/foo.o x11/main x11/bar athena/main # Le compilateur est bien sûr gcc CC = gcc # Les dépendances sont tous les objets all: $(OBJECTS) # On va quand même faire quelque chose dans cette règle echo DONE # Ici les règles pour tous les fichiers .o se trouvant dans le # répertoire 'text' text/%.o: text/%.c $(CC) -c text/$*.c # Ici les règles pour tous les fichiers se trouvant dans le répertoire # 'x11' x11/%: x11/%.c $(CC) -lX11 x11/$*.c # Ici les règles pour les fichiers se trouvant dans le répertoire # 'athena' athena/%: athena/%.c $(CC) -lXaw -lXext -lXmu -lXt -lX11 athena/$*.c

Les variables automatiques sont des variables qui sont actualisées au moment de l'exécution de chaque règle, en fonction de la cible et des dépendances.

$@: nom de la cible $<: première dépendance de la liste des dépendances $?: les dépendances plus récentes que la cible $^: toutes les dépendances $*: dans le cas de l'utilisation des patterns, la chaine correspondant au %

Entre parenthèses les valeurs par défaut

AR: programme de maintenance d'archive (ar) CC: compilateur C (cc) CXX: compilateur C++ (c++) RM: commande pour effacer un fichier (rm) TEX: programme pour créer un fichier TeX dvi à partir d'un source TeX (tex) ARFLAGS: paramètres à passer au programme de maintenance d'archives () CFLAGS: paramètres à passer au compilateur C () CXXFLAGS: paramètres à passer au compilateur C++ ()

Entre parenthèses les valeurs usuelles

prefix: racine du répertoire d'installation (/usr/local) exec_prefix: racine pour les binaires ($(prefix)) bindir: répertoire d'installation des binaires ($(exec_prefix)/bin) libdir: répertoire d'installation des librairies ($(exec_prefix)/lib) datadir: répertoire d'installation des données statiques pour le programme ($(exec_prefix)/lib) statedir: répertoire d'installation des données modifiables par le programme ($(prefix)/lib) includedir: répertoire d'installation des en-têtes ($(prefix)/include) mandir: répertoire d'installation des fichiers de manuel ($(prefix)/man) manxdir: répertoire d'installation des fichiers de la section x du manuel ($(prefix)/manx) infodir: répertoire d'installation des fichiers info ($(prefix)/info) srcdir: répertoire d'installation des fichiers source ($(prefix)/src)

Un utilisateur de make peut donner à ses cibles le nom qu'il désire. Mais pour des raisons de lisibilité, on donne toujours un nom standard à ses cibles selon leur comportement.

Quelques exemples de cibles standard:

all: compile tous les fichiers source pour créer l'exécutable principal install: exécute all, et copie l'exécutable, les librairies, les datas, et les fichiers en-tête s'il y en a dans les répertoires de destination uninstall: détruit les fichiers créés lors de l'installation, mais pas les fichiers du répertoire d'installation (où se trouvent les fichiers source et le Makefile) clean: détruit tout les fichiers créés par all info: génère un fichier info dvi: génère un fichier dvi dist: crée un fichier tar de distribution