Exécution de LIB
Différentes options de ligne de commande peuvent être utilisées pour contrôler LIB.
Ligne de commande LIB
Pour exécuter LIB, tapez la commande lib, suivie des options et des noms de fichiers pour la tâche pour laquelle vous utilisez LIB. LIB accepte également l’entrée de ligne de commande dans les fichiers de commande, qui sont décrits dans la section suivante. LIB n’utilise pas de variable d’environnement.
Fichiers de commande LIB
Vous pouvez passer des arguments de ligne de commande à LIB dans un fichier de commandes à l’aide de la syntaxe suivante :
LIB @command-file
Le fichier de commandes de fichier est un fichier texte. Aucun espace ou onglet n’est autorisé entre le signe (@) et le nom du fichier. Le nom du fichier de commande n’a pas d’extension par défaut. Spécifiez le nom complet du fichier, y compris toute extension. Les caractères génériques ne peuvent pas être utilisés. Vous pouvez spécifier un chemin absolu ou relatif avec le nom de fichier.
Dans le fichier de commandes, les arguments peuvent être séparés par des espaces ou des onglets, car ils peuvent se trouver sur la ligne de commande. Les arguments peuvent également être séparés par des caractères de nouvelle ligne. Utilisez un point-virgule ( ;) pour marquer un commentaire. LIB ignore tout le texte du point-virgule à la fin de la ligne.
Vous pouvez spécifier l’ensemble ou la partie de la ligne de commande dans un fichier de commandes, et vous pouvez utiliser plusieurs fichiers de commandes dans une commande LIB. LIB accepte l’entrée de fichier de commande comme si elle est spécifiée à cet emplacement sur la ligne de commande. Les fichiers de commande ne peuvent pas être imbriqués. LIB fait écho au contenu des fichiers de commande, sauf si l’option /NOLOGO est utilisée.
Utilisation des options LIB
Une option se compose d’un spécificateur d’option, qui est un tiret (-) ou une barre oblique (/), suivie du nom de l’option. Les noms d’options ne peuvent pas être abrégés. Certaines options prennent un argument, spécifié après un signe deux-points ( :). Aucun espace ou onglet n’est autorisé dans une spécification d’option. Utilisez un ou plusieurs espaces ou onglets pour séparer les spécifications d’option sur la ligne de commande. Les noms d’options et leurs arguments de nom de fichier ou mot clé ne respectent pas la casse, mais les identificateurs utilisés comme arguments respectent la casse. LIB traite les options dans l’ordre spécifié sur la ligne de commande et dans les fichiers de commande. Si une option est répétée avec différents arguments, la dernière à traiter est prioritaire.
Les options suivantes s’appliquent à tous les modes de LIB :
/ERRORREPORT [AUCUNE | FILE D’ATTENTE D’INVITE | | D’ENVOI]
L’option /ERRORREPORT est déconseillée. À compter de Windows Vista, le rapport d’erreurs est contrôlé par les paramètres de rapport d’erreurs Windows (WER ).
/LINKREPRO :directory-path
/LINKREPROTARGET :filename
Pour aider Microsoft à diagnostiquer lib.exe incidents et erreurs internes, vous pouvez utiliser l’option /LINKREPRO . Cette option génère une reproduction de liens, un ensemble d’artefacts de build qui permettent à Microsoft de reproduire un problème qui se produit pendant les opérations de bibliothèque. L’option /LINKREPROTARGET peut être utilisée avec l’option /LINKREPRO . Il génère uniquement des artefacts de reproduction de liens lorsque lib.exe produit le fichier spécifié. Pour plus d’informations, consultez Comment signaler un problème avec l’ensemble d’outils Microsoft C++.
/LTCG
« LTCG » correspond à la génération de code au moment du lien. Cette fonctionnalité nécessite une coopération entre le compilateur (cl.exe), LIB et l’éditeur de liens (LINK). Ensemble, ils peuvent optimiser le code au-delà de ce que n’importe quel composant peut faire par lui-même.
L’option /LTCG à LIB spécifie que les entrées de cl.exe incluent des fichiers objet générés à l’aide de l’option du compilateur /GL . Si LIB rencontre de telles entrées et que /LTCG n’est pas spécifié, il redémarre avec /LTCG activé après avoir affiché un message d’information. En d’autres termes, il n’est pas nécessaire de définir cette option explicitement, mais elle accélère les performances de build. C’est parce que LIB n’a pas à redémarrer lui-même.
Dans le processus de génération, la sortie de LIB est envoyée à LINK. LINK a sa propre option /LTCG distincte. Il est utilisé pour effectuer différentes optimisations, notamment l’optimisation de l’ensemble du programme et l’instrumentation d’optimisation guidée par profil (PGO). Pour plus d’informations sur l’option LINK, consultez /LTCG.
/MACHINE
Spécifie la plateforme cible du programme. En règle générale, vous n’avez pas besoin de spécifier /MACHINE. LIB déduit le type d’ordinateur à partir des fichiers .obj. Toutefois, dans certaines circonstances, LIB ne peut pas déterminer le type d’ordinateur et émet un message d’erreur. Si une telle erreur se produit, spécifiez /MACHINE. En mode /EXTRACT , cette option est uniquement destinée à la vérification. Utilisez-la lib /? sur la ligne de commande pour afficher les types d’ordinateurs disponibles.
/NOLOGO
Supprime l’affichage du message de copyright LIB et du numéro de version et empêche l’écho des fichiers de commande.
/VERBOSE
Affiche des détails sur la progression de la session, y compris les noms des fichiers .obj ajoutés. Les informations sont envoyées vers la sortie standard et peuvent être redirigées vers un fichier.
/WX[ :NO]
Considérez les avertissements comme des erreurs. Pour plus d’informations, consultez l’article /WX (Traiter les avertissements de l’Éditeur de liens comme des erreurs).
Les autres options s’appliquent uniquement aux modes spécifiques de LIB. Ces options sont présentées dans les sections décrivant chaque mode.