L'interface de Build Catalyst est l'utilitaire make appelé rafmake. L'interface dispose de différentes options qui contrôlent son comportement.
La syntaxe de la commande dépend du système d'exploitation, comme illustré dans le tableau ci-après.
Système d'exploitation | Options |
---|---|
Linux et Solaris (Générer une cible.) | rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –B fichier-bldhost ] [ –c mode-compat ] [ –C répertoire-modif ] [ –A fichier-BOS ] ... [ macro=valeur ... ] [ nom-cible ... ] |
Windows (Générer une cible.) | rafmake [ –f makefile ] ... [ –ukinservwdpqUN ] [ –J num ] [ –c mode-compat ] [ –C répertoire-modif ] [ –A fichier-BOS ] ... [ macro=valeur ... ] [ nom-cible ... ] |
Tout (Afficher les informations sur la version pour l'utilitaire rafmake. | rafmake { –ver/sion | –VerAll } |
La commande rafmake prend en charge la plupart des options courantes de la commande make de GNU version 3.80. La commande rafmake fournit également des options supplémentaires.
Option | Description |
---|---|
–f fichier-makefile | Utilise le fichier makefile comme fichier d'entrée. Si vous omettez cette option, la commande rafmake recherche les fichiers d'entrée nommés makefile et Makefile (dans cet ordre) dans le répertoire de travail en cours. Vous pouvez spécifier plusieurs paires d'arguments –f fichier-makefile. Plusieurs fichiers d'entrée sont effectivement concaténés. |
–u | (Sans condition) Regénère toutes les cibles spécifiées et leurs dépendances, qu'il soit ou non nécessaire de les regénérer. (Voir aussi –U.) |
–k | Abandonne le travail sur l'entrée en cours s'il échoue, mais continue sur d'autres cibles qui ne dépendent pas de cette entrée. |
–i | Ignore les codes d'erreur retournés par les commandes. |
–n | (Pas d'exécution) Répertorie les lignes de commande, y compris celles qui commencent par un signe arobase (@), à partir du fichier makefile pour les cibles qui doivent être regénérées, mais ne les exécute pas. Exception : une commande contenant la chaîne $(MAKE) est toujours exécutée. |
–s | (Silencieux) Ne répertorie pas les ligne de commande avant de les exécuter. |
–e | Les variables d'environnement écrasent les affectations de macros dans le fichier makefile. (Toutefois, les affectations de macro=valeur dans la ligne de commande ou dans la spécification des options d'une génération remplacent les variables d'environnement.) |
–r | (Pas de règle) N'utilise pas les règles intégrées dans le fichier buildcatalyst-home-dir/etc/builtin.mk (Linux et Solaris) ou dans le fichier buildcatalyst-home-dir\etc\builtin.mk (Windows). Lorsqu'elle est utilisée conjointement avec l'option –c, l'option –r désactive également la lecture des fichiers de démarrage spécifiques à la plateforme. Reportez-vous à l'option –c pour plus d'informations. |
–v | (Texte) Légèrement plus prolixe que le mode de sortie par défaut. |
–w | (Répertoire de travail) Imprime un message qui contient le répertoire de travail avant et après l'exécution du fichier makefile. |
–d | (Débogage) Très prolixe, inclut une liste des variables d'environnement lues par la commande rafmake au cours de la génération. Utilisez cette option uniquement lors du débogage des fichiers makefile. |
–p | (Imprimer) Répertorie toutes les descriptions de cibles et toutes les descriptions de macros, y compris les définitions de macros spécifiques à des cibles et les règles implicites. N'exécute rien. |
–q | (Requête) Evalue les cibles de fichiers makefile, mais n'exécute pas les scripts de génération. La commande rafmake retourne l'une des réponses suivantes :
|
–U | Construit de manière inconditionnelle les cibles d'objectif uniquement. Ne génère pas de sous-cible. Si vous ne spécifiez pas une cible dans la ligne d commande, la cible par défaut est l'objectif. (L'option –u génère de manière inconditionnelle les deux cibles d'objectif et les dépendances de la génération.) |
–N | Désactive la procédure par défaut pour la lecture d'un ou plusieurs fichiers BOS (Build Option Specification, Spécification d'option de build). |
–J num | Active la capacité de génération parallèle. Le nombre maximum de regénérations de cibles simultanées est défini sur l'entier num. Si num=0, la génération parallèle est désactivée. (Cela équivaut à la non spécification d'une option –J.) Vous pouvez aussi spécifier num comme valeur de la variable d'environnement RAFMAKE_CONC. |
–B fichier-bldhost | Utilise le fichier-bldhost comme fichiers d'hôtes de la génération pour une génération parallèle. Si vous ne spécifiez pas l'option –B, la commande rafmake utilise le fichier .bldhost.$RAFMAKE_HOST_TYPE dans votre répertoire d'accueil. Lorsque vous utilisez l'option –B, vous devez aussi utiliser l'option –J ou définir la variable d'environnement RAFMAKE_CONC. |
–c mode-compat | (Compatibilité) Appelle la commande rafmake dans un mode de compatibilité. (Vous pouvez aussi utiliser la variable d'environnement RAFMAKE_COMPAT pour spécifier un mode de compatibilité.) Vous pouvez définir la variable mode-compat sur l'une des valeurs suivantes :
Sur les systèmes Linux et Solaris seulement, la variable mode-compat peut aussi avoir l'une des valeurs suivantes. L'option –c est indépendante des plateformes Linux et Solaris. Toutefois, certains modes tentent de lire les fichiers spécifiques au système ; si ces fichiers n'existent pas, la commande échoue.
|
–C rép | Change de répertoire. La commande rafmake passe au répertoire dir avant de démarrer la génération. |
–A fichier-BOS | Spécifie les fichiers BOS à lire immédiatement après ceux qui sont lus par défaut. Utilisez cette option à plusieurs reprises pour spécifier plusieurs fichiers BOS. Lorsque vous utilisez –N avec cette option, rafmake lit les fichiers BOS spécifiés au lieu des fichiers BOS par défaut. Vous pouvez aussi spécifier une liste séparée par deux points des noms de chemin d'accès aux fichiers BOS (Linux et Solaris) ou une liste séparée par des points virgules des mêmes noms de chemin d'accès comme la valeur de la variable d'environnement RAFMAKE_OPTS_SPECS. |
–ver/sion | Imprime les informations de version à propos de la commande rafmake. |
–VerAll | Imprime les informations de version à propos de la commande rafmake et des bibliothèques (Linux et Solaris) ou des fichiers DLL (Windows) utilisés par la commande rafmake. |