Section courante

A propos

Section administrative du site

windres

Ressource Windows
Binutils (GNU Binary Utilities)

Syntaxe

windres [options] [input-file] [output-file]

Paramètres

Nom Description
-c val Ce paramètre permet d'indiquer que la page de codes par défaut à utiliser lors de la lecture d'un fichier rc. val doit être un hexadécimal préfixé par «0x» ou un code de page de codes décimal. L'intervalle valide va de zéro à 0xffff, mais la validité de la page de codes dépend de l'hôte et de la configuration.
--codepage val Ce paramètre permet d'indiquer que la page de codes par défaut à utiliser lors de la lecture d'un fichier rc. val doit être un hexadécimal préfixé par «0x» ou un code de page de codes décimal. L'intervalle valide va de zéro à 0xffff, mais la validité de la page de codes dépend de l'hôte et de la configuration.
-D target Ce paramètre permet d'indiquer option -D à transmettre au préprocesseur lors de la lecture d'un fichier rc.
--define sym[=val] Ce paramètre permet d'indiquer option -D à transmettre au préprocesseur lors de la lecture d'un fichier rc.
-F target Ce paramètre permet d'indiquer le format BFD à utiliser pour un fichier COFF en entrée ou en sortie. Il s'agit d'un nom de cible BFD ; vous pouvez utiliser l'option --help pour voir une liste des cibles prises en charge. Normalement, Windres utilisera le format par défaut, étant le premier répertorié par l'option --help. Sélection de la cible.
-h Ce paramètre permet d'afficher un résumé d'utilisation de cette commande.
--help Ce paramètre permet d'afficher un résumé d'utilisation de cette commande.
-I directory Ce paramètre permet d'indiquer un répertoire d'inclusion à utiliser lors de la lecture d'un fichier rc. Windres transmettra cela au préprocesseur en tant qu'option -I. Windres recherchera également ce répertoire lors de la recherche de fichiers nommés dans le fichier rc. Si le paramètre passé à cette commande correspond à l'un des formats pris en charge (comme décrit dans l'option -J), il émettra un avertissement de dépréciation et se comportera comme l'option -J. Les nouveaux programmes ne devraient pas utiliser ce comportement. Si un répertoire correspond à un format, préfixez-le simplement avec «./» pour désactiver la compatibilité ascendante.
-i filename Ce paramètre permet d'indiquer le nom du fichier d'entrée. Si cette option n'est pas utilisée, alors windres utilisera le premier paramètre sans option comme nom de fichier d'entrée. S'il n'y a pas de paramètres sans options, alors windres lira à partir de l'entrée standard. Windres ne peut pas lire un fichier COFF à partir de l'entrée standard.
--include-dir directory Ce paramètre permet d'indiquer un répertoire d'inclusion à utiliser lors de la lecture d'un fichier rc. Windres transmettra cela au préprocesseur en tant qu'option -I. Windres recherchera également ce répertoire lors de la recherche de fichiers nommés dans le fichier rc. Si le paramètre passé à cette commande correspond à l'un des formats pris en charge (comme décrit dans l'option -J), il émettra un avertissement de dépréciation et se comportera comme l'option -J. Les nouveaux programmes ne devraient pas utiliser ce comportement. Si un répertoire correspond à un format, préfixez-le simplement avec «./» pour désactiver la compatibilité ascendante.
--input filename Ce paramètre permet d'indiquer le nom du fichier d'entrée. Si cette option n'est pas utilisée, alors windres utilisera le premier paramètre sans option comme nom de fichier d'entrée. S'il n'y a pas de paramètres sans options, alors windres lira à partir de l'entrée standard. Windres ne peut pas lire un fichier COFF à partir de l'entrée standard.
--input-format format Ce paramètre permet d'indiquer le format d'entrée à lire. le format peut être «res», «rc» ou «coff». Si aucun format d'entrée n'est spécifié, Windres devinera, comme décrit ci-dessous.
-J format Ce paramètre permet d'indiquer le format d'entrée à lire. le format peut être «res», «rc» ou «coff». Si aucun format d'entrée n'est spécifié, Windres devinera, comme décrit ci-dessous.
-l val Ce paramètre permet d'indiquer la langue par défaut à utiliser lors de la lecture d'un fichier rc. val doit être un code de langue hexadécimal. Les huit bits de poids faible sont le langage et les huit bits de poids fort sont le sous-langage.
--language val Ce paramètre permet d'indiquer la langue par défaut à utiliser lors de la lecture d'un fichier rc. val doit être un code de langue hexadécimal. Les huit bits de poids faible sont le langage et les huit bits de poids fort sont le sous-langage.
--no-use-temp-file Ce paramètre permet d'indiquer qu'il faut utiliser popen, et non un fichier temporaire, pour lire la sortie du préprocesseur. Il s'agit du comportement par défaut.
-O format Ce paramètre permet d'indiquer le format de sortie à générer. le format peut être «res», «rc» ou «coff». Si aucun format de sortie n'est spécifié, Windres devinera, comme décrit ci-dessus.
-o filename Ce paramètre permet d'indiquer le nom du fichier de sortie. Si cette option n'est pas utilisée, alors windres utilisera le premier paramètre non optionnel, après celui utilisé pour le nom du fichier d'entrée, comme nom du fichier de sortie. S'il n'y a pas de paramètre non optionnel, alors windres écrira sur la sortie standard. Windres ne peut pas écrire un fichier COFF sur la sortie standard. Notez que pour des raisons de compatibilité avec rc, l'option -fo est également acceptée, mais son utilisation n'est pas recommandée.
--output filename Ce paramètre permet d'indiquer le nom du fichier de sortie. Si cette option n'est pas utilisée, alors windres utilisera le premier paramètre non optionnel, après celui utilisé pour le nom du fichier d'entrée, comme nom du fichier de sortie. S'il n'y a pas de paramètre non optionnel, alors windres écrira sur la sortie standard. Windres ne peut pas écrire un fichier COFF sur la sortie standard. Notez que pour des raisons de compatibilité avec rc, l'option -fo est également acceptée, mais son utilisation n'est pas recommandée.
--output-format format Ce paramètre permet d'indiquer le format de sortie à générer. le format peut être «res», «rc» ou «coff». Si aucun format de sortie n'est spécifié, Windres devinera, comme décrit ci-dessus.
--preprocessor-arg option Ce paramètre permet, lorsque Windres lit un fichier rc, d'être exécuté d'abord via le préprocesseur C. Cette option peut être utilisée pour spécifier du texte supplémentaire à transmettre au préprocesseur sur sa ligne de commande. Cette option peut être utilisée plusieurs fois pour ajouter plusieurs options à la ligne de commande du préprocesseur. Si l'option --preprocessor n'a pas été spécifiée, alors un ensemble de paramètres de préprocesseur par défaut sera utilisé, toutes les options --preprocessor-arg étant placées après elles sur la ligne de commande. Ces paramètres par défaut sont -E, -xc-header et -DRC_INVOKED.
--preprocessor program Ce paramètre permet d'indiquer que lorsque Windres lit un fichier rc, il l'exécute d'abord via le préprocesseur C. Cette option peut être utilisée pour spécifier le préprocesseur à utiliser. Le préprocesseur par défaut est gcc.
-r Ce paramètre est ignoré et utiliser pour la compatibilité avec rc.
--target target Ce paramètre permet d'indiquer le format BFD à utiliser pour un fichier COFF en entrée ou en sortie. Il s'agit d'un nom de cible BFD ; vous pouvez utiliser l'option --help pour voir une liste des cibles prises en charge. Normalement, Windres utilisera le format par défaut, étant le premier répertorié par l'option --help. Sélection de la cible.
-U target Ce paramètre permet d'indiquer une option -U à transmettre au préprocesseur lors de la lecture d'un fichier rc.
--undefine sym Ce paramètre permet d'indiquer une option -U à transmettre au préprocesseur lors de la lecture d'un fichier rc.
--use-temp-file Ce paramètre permet d'utiliser un fichier temporaire au lieu d'utiliser popen pour lire la sortie du préprocesseur. Utilisez cette option si l'implémentation du popen est boguée sur l'hôte (par exemple, certaines versions non anglaises de Windows 95 et Windows 98 sont connues pour avoir un popen bogué où la sortie sera plutôt envoyée à la console).
-V Ce paramètre permet d'afficher le numéro de version pour Windres.
-v Ce paramètre permet d'activer le mode détaillé. Cela vous indique ce qu'est le préprocesseur si vous n'en avez pas spécifié un.
--version Ce paramètre permet d'afficher le numéro de version pour Windres.
--yydebug Ce paramètre permet, si windres est compilé avec YYDEBUG défini sur 1, d'activer le débogage de l'analyseur.

Description

Cette commande permet de lancer un compilateur pour les fichiers de ressources Windows.

La commande windres lit les ressources d'un fichier d'entrée et les copie dans un fichier de sortie. L'un ou l'autre fichier peut être dans l'un des trois formats suivants :

Format Description
rc Un format de texte lu par le compilateur de ressources.
res Un format binaire généré par le compilateur de ressources.
coff Un objet ou un exécutable COFF.

Remarque



Dernière mise à jour : Dimanche, le 3 Septembre 2023