commande make

Objectif

Gère, met à jour et régénère des groupes de programmes.

Syntaxe

make [ -DVariable ] [ -d Option ] [ -e ] [ -i ] [ -j[Travaux] ] [ -k ] [ -n ] [ -p ] [ -q ] [ -r ] [ -S ] [ -s ] [ -t ] [ -f MakeFile ... ] [ Cible ... ]

Descriptif

La commande make vous aide à gérer un ensemble de programmes. L'entrée de la commande make est une liste de spécifications de dépendance de fichier.

Il existe quatre types de ligne dans un fichier makefile: les spécifications de dépendance de fichier, les commandes shell, les affectations de variables et les commentaires. En général, les lignes peuvent être continuées d'une ligne à la suivante en les terminant par une barre oblique inversée (\). Le caractère de retour à la ligne de fin et l'espace blanc initial de la ligne suivante sont compressés dans un espace unique.

Spécifications de dépendance de fichier

Les lignes de dépendance se composent d'une ou plusieurs cibles, d'un opérateur et de zéro ou plusieurs prérequis (sources). Cela crée une relation dans laquelle les cibles dépendent des prérequis et sont généralement créées à partir de ces derniers. La relation exacte entre la cible et le prérequis est déterminée par l'opérateur qui les sépare. Les opérateurs sont les suivants:

Les spécifications de dépendance de fichier comportent deux types de règles: inférence et cible. Les règles d'inférence spécifient comment une cible doit être actualisée. Ces règles ont une cible sans / (barre oblique) et un minimum de 1. (point). Les règles cible spécifient comment générer la cible. Ces règles peuvent avoir plusieurs cibles.

Exécution de fichier makefile

La commande make exécute les commandes dans le fichier makefile ligne par ligne. Lorsque make exécute chaque commande, il écrit la commande dans la sortie standard (sauf indication contraire, par exemple, à l'aide de l'indicateur -s ). Un fichier makefile doit avoir un onglet devant les commandes sur chaque ligne.

Règles cible

Les règles cible ont le format suivant:

target[target...] : [prerequisite...] [;command]
<Tab>command

Cibles spéciales

Les cibles spéciales ne peuvent pas être incluses avec d'autres cibles, c'est-à-dire qu'elles doivent être la seule cible spécifiée. Ces cibles contrôlent le fonctionnement de la commande make . Ces cibles sont les suivantes:

Règles d'inférence

La commande make comporte un ensemble par défaut de règles d'inférence, que vous pouvez compléter ou remplacer par des définitions de règles d'inférence supplémentaires dans le fichier makefile. Les règles par défaut sont stockées dans le fichier externe /usr/ccs/lib/aix.mk. Vous pouvez remplacer votre propre fichier de règles en définissant la variable MAKERULES sur votre propre nom de fichier à partir de la ligne de commande. La ligne suivante montre comment modifier le fichier de règles à partir de la ligne de commande:

make MAKERULES=/pathname/filename

Les règles d'inférence sont constituées de suffixes et de commandes cible. A partir des suffixes, la commande make détermine les prérequis, et à partir des suffixes et de leurs prérequis, la commande make détermine comment mettre à jour une cible. Les règles d'inférence ont le format suivant:

rule:
<Tab>command
...

oùruleprésente l'une des formes suivantes:

Les suffixes .s1 et .s2 sont définis comme prérequis de la cible spéciale, .SUFFIXES. Les suffixes .s1 et .s2 doivent être des suffixes connus au moment où la règle d'inférence est affichée dans le fichier makefile. Les règles d'inférence utilisent les suffixes dans l'ordre dans lequel ils sont spécifiés dans .SUFFIXES. Une nouvelle règle d'inférence est démarrée lorsqu'une nouvelle ligne ne commence pas par un<Tab>ou #.

Plusruleest vide, par exemple:

rule: ;

L'exécution n'a aucun effet et la commande make reconnaît que le suffixe existe, mais n'effectue aucune action lorsque les cibles sont obsolètes.

Un ~ (tilde) dans les règles précédentes fait référence à un fichier SCCS. Par conséquent, la règle .c~.otransforme un fichier de prérequis en langage C SCCS en fichier objet (.o). Parce que les . du fichier SCCS est un préfixe, il est incompatible avec la vue de suffixe de la commande make . Le ~ (tilde) est un moyen de changer une référence de fichier en une référence de fichier SCCS.

Bibliothèques

Une cible ou un prérequis peut également être membre d'une bibliothèque d'archives et est traité comme tel s'il existe des parenthèses dans le nom. Par exemple, library (name) indique que name est un membre de la bibliothèque d'archives library. Pour mettre à jour un membre d'une bibliothèque à partir d'un fichier particulier, vous pouvez utiliser le format .s1.a, où un fichier avec le suffixe .s1 est utilisé pour mettre à jour un membre de la bibliothèque d'archives. Le fichier .a fait référence à une bibliothèque d'archives.

Utilisation de macros

Dans les fichiers makefile, les définitions de macro sont définies au format suivant:

variable=value

Les macros peuvent être affichées dans le fichier makefile, comme suit:

• Si une macro est affichée dans une ligne cible, elle est évaluée lorsque la ligne cible est lue.
• Si une macro est affichée dans une ligne de commande, elle est évaluée lors de l'exécution de la commande.
• Si une macro est affichée dans une ligne de définition de macro, elle est évaluée lorsque la nouvelle macro est affichée dans une règle ou une commande.

Si une macro n'a pas de définition, elle prend par défaut la valeur NULL. Une nouvelle définition de macro remplace une macro existante du même nom. Les affectations de macros peuvent provenir des éléments suivants, dans l'ordre indiqué:

1. Règles d'inférence par défaut
2. Contenu de l'environnement
3. Fichiers makefile
4. Lignes de commande.
   Remarque: L'indicateur -e permet aux variables d'environnement de remplacer celles définies dans le fichier makefile.

Commandes Shell

Chaque cible peut être associée à une série de commandes shell, généralement utilisées pour créer la cible. Chacune des commandes de ce script doit être précédée d'un onglet. N'importe quelle cible peut être affichée sur une ligne de dépendance, mais une seule de ces dépendances peut être suivie d'un script de création, sauf si l'opérateur :: est utilisé.

Si le premier ou les deux premiers caractères de la ligne de commande sont @ (signe arobase),-(trait d'union) et + (signe plus), la commande est traitée comme suit:

Une commande qui ne comporte pas de métacaractères est directement exécutée par la commande make . Par exemple, la commande make consigne la première commande de l'exemple suivant dans le shell car elle contient le métacaractère shell > (signe supérieur à). La deuxième commande de l'exemple suivant ne contient pas de métacaractères de shell, c'est pourquoi la commande make l'exécute directement:

target: dependency
        cat dependency > target
        chmod a+x target

Le contournement de l'interpréteur de commandes permet de gagner du temps, mais il peut entraîner des problèmes. Par exemple, en tentant d'exécuter un script shell C à partir d'un fichier makefile en définissant la macro SHELL sur/bin/cshne fonctionnera pas sauf si la ligne de commande contient également au moins un métacaractère shell.

SHELL=/bin/csh
   
target: dependency
        my_csh_script

Ce fichier makefile échoue car la commande make tente de s'exécutermy_csh_scriptau lieu de l'envoyer à la coque C.

Affectations de variables

Les variables de la commande make sont similaires aux variables de l'interpréteur de commandes et sont composées de toutes les lettres majuscules. L'opérateur = affecte des valeurs à des variables. Toute variable précédente est ensuite remplacée. Tout espace avant la valeur affectée est supprimé.

macro += word ... 
macro += macro1 

L'opérateur + =, lorsqu'il est utilisé à la place de =, ajoute la nouvelle valeur avec un espace unique entre le contenu précédent de la variable et la valeur ajoutée.

Les variables sont utilisées en entourant le nom de la variable avec { } (accolades) ou () (parenthèses) et le faire précéder d'un signe $ (dollar). Si le nom de la variable ne contient qu'une seule lettre, les accolades ou les parenthèses ne sont pas obligatoires. Cette forme plus courte n'est pas recommandée.

La substitution de variable se produit à deux moments distincts, selon l'endroit où la variable est utilisée. Les variables des lignes de dépendance sont développées à mesure que la ligne est lue. Les variables des commandes shell sont développées lors de l'exécution de la commande shell .

Les quatre classes de variables (par ordre de priorité croissante) sont les suivantes:

VPATH=src:/usr/local/src

Indicateurs

Statut de sortie

Lorsque l'option -q est spécifiée, cette commande renvoie les valeurs de sortie suivantes :

Sinon, cette commande renvoie les valeurs de sortie suivantes:

Exemples

1. Pour créer la première cible trouvée dans le fichier makefile, entrez:

   make

2. Pour afficher, mais pas exécuter, les commandes utilisées par la commande make pour créer un fichier:
   make  -n search.o
   Cela permet de vérifier qu'un nouveau fichier de description est correct avant de l'utiliser.
3. Pour créer un fichier makefile indiquant que pgm dépend de deux fichiers, a.o et b.o, et qu'ils dépendent à leur tour des fichiers prérequis correspondants (a.c et b.c) et d'un fichier commun, incl.h, entrez:

   pgm: a.o b.o
             c89 a.o b.o -o pgm
   a.o: incl.h a.c
             c89 -c a.c
   b.o: incl.h b.c
             c89 -c b.c

4. Pour créer des fichiers .o optimisés à partir de fichiers .c , entrez:

   .c.o:
             c89 -c -o $*.c
   or:
   .c.o:
             c89 -c -o $<

5. Pour afficher le contenu des règles intégrées, entrez:
   make  -p  -f /dev/null 2>/dev/null
6. Pour utiliser la commande make en mode parallèle avec un maximum de 10 travaux parallèles à utiliser pour la génération de la cible spécifiée dans le fichier makefile, entrez:

   make -j10

Fichiers