Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] make - utilitaire GNU make pour maintenir des groupes de programmes [size=18] [b]Résumé[/b] [/size] [b]make [/b] [ [b]-f[/b] [i]makefile[/i] ] [ option ] ... cible ... [size=18] [b]Avertissement[/b] [/size] Cette page de manuel est un extrait de la documentation de [b]GNU make .[/b] Elle n'est mise à jour qu'occasionnellement, car le projet GNU n'utilise pas nroff. Pour obtenir une documentation complète et à jour, référez-vous au fichier Info [b]make.info[/b] qui est créé à partir du fichier source Texinfo [b]make.texinfo .[/b] [size=18] [b]Description[/b] [/size]     Le but de l'utilitaire [i]make[/i] est de déterminer automatiquement quelles sont les parties d'un gros programme qu'il faut recompiler, et d'exécuter les commandes appropriées. Le manuel décrit l'implémentation GNU de [b]make ,[/b] qui a été écrite par Richard Stallman et Roland McGrath. Nos exemples représentent des programmes C, puisqu'ils sont les plus courants, mais vous pouvez utiliser [i]make[/i] avec n'importe quel langage de programmation dont le compilateur peut être lancé en ligne de commandes. En fait, [i]make[/i] n'est pas limité aux seuls programmes. Vous pouvez l'utiliser pour décrire n'importe quelle tâche dans laquelle certains fichiers doivent être mis à jour automatiquement à partir d'autres fichiers quand ces derniers sont modifiés.     Avant d'utiliser [b]make ,[/b] vous devez écrire un fichier appelé [i]makefile[/i] qui décrit les relations entre les fichiers de votre programme, et qui fournit les commandes nécessaires à la mise à jour de chacun d'entre eux. Dans un programme, le fichier exécutable sera typiquement mis à jour à partir de fichiers objets, qui sont eux-mêmes créés en compilant des fichiers sources.     Quand un fichier makefile adéquat existe, chaque fois que vous modifierez certains fichiers sources, cette simple commande shell : 1[table][row][col]    [/col][col] [b]make[/b][/col][/row][/table] 1 suffira pour effectuer toutes les recompilations nécessaires. Le programme [i]make[/i] utilise la base de données du makefile et les dates de dernière modification des fichiers pour décider quels fichiers doivent être mis à jour. Pour chacun de ces fichiers, il exécute les commandes enregistrées dans la base de données.     [i]make[/i] exécute les commandes du [i]makefile[/i] pour mettre à jour un ou plusieurs [b]noms[/b] de cibles, où [i]nom[/i] est typiquement un programme. Si aucune option [b]-f[/b] n'est présente, [i]make[/i] recherchera les makefiles [b]GNUmakefile ,[/b] [i]makefile[/i] et [b]Makefile ,[/b] dans cet ordre.     Normalement, vous devriez appeler votre makefile soit [i]makefile[/i] soit [b]Makefile .[/b] (Nous recommandons [i]Makefile[/i] car il apparaît de façon bien visible près du début du listage d'un répertoire, juste à côté d'autres fichiers importants comme [b]README .)[/b] Le premier nom recherché, [b]GNUmakefile ,[/b] n'est pas recommandé pour la plupart des makefiles. Vous ne devriez utiliser ce nom que si vous avez un makefile qui est spécifique au [b]make[/b] GNU, et qui ne sera pas compris par d'autres versions de [b]make .[/b] Si [i]makefile[/i] est « - », l'entrée standard est lue.     [i]make[/i] met à jour une cible si elle dépend de fichiers prérequis qui ont été modifiés depuis la dernière modification de la cible, ou si la cible n'existe pas. [size=18] [b]Options[/b] [/size] 1 [b]-b[/b][/col][/row][/table] [b]-m[/b] [table][row][col]    [/col][col]Ces options sont ignorées, et sont présentes pour assurer la compatibilité avec d'autres versions de [b]make .[/b][/col][/row][/table] [b][i]-C rép[/i][/b] [table][row][col]    [/col][col]Se déplacer dans le répertoire [i]rép[/i] avant de lire les makefiles ou de faire quoi que ce soit d'autre. Si plusieurs options [b]-C[/b] sont spécifiées, chacune d'entre elles est interprétée relativement à la précédente : « [b][/b]-C / [b][/b]-C etc » est équivalent à « [b][/b]-C /etc». Cela est typiquement utilisé lors d'invocations récursives de [b]make .[/b][/col][/row][/table] [b]-d[/b] [table][row][col]    [/col][col]Afficher des informations de débogage en plus du traitement normal. Les informations de débogage indiquent quels fichiers sont évalués pour la reconstruction, quels dates de fichiers sont comparées et avec quels résultats, quels fichiers ont réellement besoin d'être recréés, quelles règles implicites sont prises en compte et lesquelles sont appliquées - bref, tout ce qu'il y a d'intéressant à savoir sur la manière dont [i]make[/i] décide de ce qu'il doit faire.[/col][/row][/table] [b]-e[/b] [table][row][col]    [/col][col]Donner la priorité aux variables d'environnement par rapport aux variables des makefiles.[/col][/row][/table] [b][i]-f fichier[/i][/b] [table][row][col]    [/col][col]Utiliser [i]fichier[/i] en tant que makefile.[/col][/row][/table] [b]-i[/b] [table][row][col]    [/col][col]Ignorer toutes les erreurs dans les commandes exécutées pour reconstruire les fichiers.[/col][/row][/table] [b][i]-I rép[/i][/b] [table][row][col]    [/col][col]Spécifie un répertoire [i]rép[/i] où il faut rechercher les makefiles inclus. Si plusieurs options [b]-I[/b] sont utilisées pour spécifier plusieurs répertoires, les répertoires sont parcourus dans l'ordre spécifié. À la différence des autres drapeaux de [b]make ,[/b] les répertoires fournis avec les drapeaux [b]-I[/b] peuvent venir directement après le drapeau : [b][i]-I rép[/i][/b] est permis, tout comme [b][/b]-I[i][/i] rép. Cette syntaxe est admise pour assurer la compatibilité avec le drapeau [b]-I[/b] du préprocesseur C.[/col][/row][/table] [b][i]-j travaux[/i][/b] [table][row][col]    [/col][col]Spécifie le nombre de travaux (commandes) à exécuter simultanément. S'il y a plus d'une option [b]-j ,[/b] seule la dernière est utilisée. Si l'option [b]-j[/b] est fournie sans argument, [b]make[/b] ne limitera pas le nombre de travaux qui peuvent être exécutés simultanément.[/col][/row][/table] [b]-k[/b] [table][row][col]    [/col][col]Continuer autant que possible après une erreur. Même si la création de la cible a échoué (et donc celle des cibles qui en dépendent), les autres dépendances de ces cibles peuvent être traitées de la même façon.[/col][/row][/table] [b]-l[/b][/col][/row][/table] [b][i]-l charge[/i][/b] [table][row][col]    [/col][col]Spécifier qu'aucun nouveau travail (commande) ne doit être commencé s'il y a d'autres travaux en cours d'exécution et que la charge moyenne est d'au moins [i]charge[/i] (un nombre en virgule flottante). Sans argument, cette option supprime une limite de charge fournie antérieurement.[/col][/row][/table] [b]-n[/b] [table][row][col]    [/col][col]Afficher les commandes qui seraient exécutées, mais ne pas les exécuter réellement.[/col][/row][/table] [b][i]-o fichier[/i][/b] [table][row][col]    [/col][col]Ne pas reconstruire le [i]fichier[/i] même s'il est plus ancien que ses dépendances, et ne pas reconstruire quoi que ce soit à cause de modifications dans [b]fichier .[/b] Le fichier est essentiellement traité comme étant très âgé et ses règles sont ignorées.[/col][/row][/table] [b]-p[/b] [table][row][col]    [/col][col]Afficher la base de données (règles et valeurs des variables) qui résultent de la lecture des makefiles ; exécuter ensuite la commande comme elle est spécifiée. Cela affiche également les informations de version fournies par l'interrupteur [b]-v[/b] (voir en dessous). Pour afficher la base de données sans essayer de reconstruire le moindre fichier, utilisez [b]make[/b] -p -f[i][/i] /dev/null.[/col][/row][/table] [b]-q[/b] [table][row][col]    [/col][col]« Mode question ». Ne pas lancer de commandes, ni afficher quoi que ce soit, mais uniquement renvoyer une valeur de retour qui vaut 0 si les cibles spécifiées sont déjà à jour, ou une valeur non nulle sinon.[/col][/row][/table] [b]-r[/b] [table][row][col]    [/col][col]Interdire l'utilisation des règles implicites intégrées. Effacer également la liste des suffixes par défaut pour les règles se rapportant aux suffixes.[/col][/row][/table] [b]-s[/b] [table][row][col]    [/col][col]Opération silencieuse ; ne pas afficher les commandes quand elles sont exécutées.[/col][/row][/table] [b]-S[/b] [table][row][col]    [/col][col]Annuler l'effet de l'option [b]-k .[/b] Cela n'est jamais nécessaire sauf pour un [i]make[/i] récursif où [b]-k[/b] peut être hérité à partir du [i]make[/i] du plus haut niveau via MAKEFLAGS, ou si vous fournissez [b]-k[/b] dans la variable MAKEFLAGS de votre environnement.[/col][/row][/table] [b]-t[/b] [table][row][col]    [/col][col]« Touch »er les fichiers (les marquer comme étant à jour sans réellement les modifier) au lieu d'exécuter leurs commandes. Cela est utilisé pour faire croire à make que les commandes ont été exécutées, afin de tromper les invocations futures de [b]make .[/b][/col][/row][/table] [b]-v[/b] [table][row][col]    [/col][col]Afficher la version de [b]make ,[/b] un copyright, une liste des auteurs et un avertissement indiquant l'absence de garantie.[/col][/row][/table] [b]-w[/b] [table][row][col]    [/col][col]Afficher un message contenant le répertoire de travail avant et après d'autres traitements. Cela peut être utile pour débusquer des erreurs se produisant dans des imbrications compliquées de commandes [i]make[/i] récursives.[/col][/row][/table] [b][i]-W fichier[/i][/b] [table][row][col]    [/col][col]Faire croire que le [i]fichier[/i] cible vient d'être modifié. Quand c'est utilisé avec le drapeau [b]-n ,[/b] cela montre ce qui se passerait si ce fichier était modifié. Sans [b]-n ,[/b] cela revient presque à exécuter la commande [i]touch[/i] sur le fichier donné avant de lancer [b]make ,[/b] mis à part que la date de modification n'est modifiée que dans l'imagination de [b]make .[/b][/col][/row][/table] [size=18] [b]Voir aussi[/b] [/size] [i]The GNU Make Manual[/i] [size=18] [b]Bugs[/b] [/size] Voir le chapitre « Problems and Bugs » dans [b]The GNU Make Manual .[/b] [size=18] [b]Auteur[/b] [/size] Cette page de manuel a été écrite par Dennis Morse de l'Université de Stanford. Elle a été retravaillée par Roland McGrath. [size=18] [b]Traduction[/b] [/size] Frédéric Delanoy <[i]delanoy_f[/i] at yahoo.com>, 2002.
Fichier