Gestion d'une bibliothèque
Le mode par défaut de LIB consiste à générer ou modifier une bibliothèque d’objets COFF. LIB s’exécute dans ce mode lorsque vous ne spécifiez /EXTRACT pas (pour copier un objet dans un fichier) ou /DEF (pour générer une bibliothèque d’importation).
Pour générer une bibliothèque à partir d’objets et/ou de bibliothèques, utilisez la syntaxe suivante :
LIB[options...]files...
Cette commande crée une bibliothèque à partir d’un ou plusieurs fichiers d’entrée. files Il files peut s’agir de fichiers d’objets COFF, de fichiers objet OMF 32 bits ou de bibliothèques COFF existantes. LIB crée une bibliothèque qui contient tous les objets dans les fichiers spécifiés. Si un fichier d’entrée est un fichier objet OMF 32 bits, LIB le convertit en COFF avant de générer la bibliothèque. LIB ne peut pas accepter un objet OMF 32 bits qui se trouve dans une bibliothèque créée par la version 16 bits de LIB. Vous devez d’abord utiliser le LIB 16 bits pour extraire l’objet ; vous pouvez ensuite utiliser le fichier objet extrait comme entrée dans le LIB 32 bits.
Par défaut, LIB nomme le fichier de sortie à l’aide du nom de base du premier fichier objet ou bibliothèque et de l’extension .lib. Le fichier de sortie est placé dans le répertoire actif. S’il existe déjà un fichier portant le même nom, le fichier de sortie remplace le fichier existant. Pour conserver une bibliothèque existante, utilisez l’option /OUT permettant de spécifier un nom pour le fichier de sortie.
Les options suivantes s’appliquent à la génération et à la modification d’une bibliothèque :
/LIBPATH: dir
Remplace le chemin de la bibliothèque d’environnement et le dirdéfinit sur . Pour plus d’informations, consultez la description de l’option LINK /LIBPATH .
/LIST
Affiche des informations sur la bibliothèque de sortie en sortie standard. La sortie peut être redirigée vers un fichier. Vous pouvez utiliser /LIST pour déterminer le contenu d’une bibliothèque existante sans la modifier.
/NAME: filename
Lors de la génération d’une bibliothèque d’importation, filename spécifie le nom de la DLL pour laquelle la bibliothèque d’importation est générée.
/NODEFAULTLIB
Supprime une ou plusieurs bibliothèques par défaut de la liste des bibliothèques qu’elle recherche lors de la résolution des références externes. Pour plus d’informations, consultez /NODEFAULTLIB.
/OUT: filename
Remplace le nom de fichier de sortie par défaut et le remplace par filename. Par défaut, la bibliothèque de sortie est créée dans le répertoire actif, avec le nom de base du premier fichier bibliothèque ou objet sur la ligne de commande et l’extension .lib.
/REMOVE: object
Omettez le spécifié object de la bibliothèque de sortie. LIB crée une bibliothèque de sortie en combinant tous les objets (que ce soit dans les fichiers ou bibliothèques d’objets), puis en supprimant les objets spécifiés avec /REMOVE.
/SUBSYSTEM:{CONSOLE | EFI_ROM | | NATIVEPOSIX | WINDOWS | | | WINDOWSCEEFI_APPLICATIONEFI_BOOT_SERVICE_DRIVER | EFI_RUNTIME_DRIVER}[,#[.##]]
Indique au système d’exploitation comment exécuter un programme créé en liant à la bibliothèque de sortie. Pour plus d’informations, consultez la description de l’option LINK /SUBSYSTEM .
Les options LIB spécifiées sur la ligne de commande ne respectent pas la casse.
Vous pouvez utiliser LIB pour effectuer les tâches de gestion de bibliothèque suivantes :
Pour ajouter des objets à une bibliothèque, spécifiez le nom de fichier de la bibliothèque existante et les noms de fichiers des nouveaux objets.
Pour combiner des bibliothèques, spécifiez les noms de fichiers de la bibliothèque. Vous pouvez ajouter des objets et combiner des bibliothèques avec une seule commande LIB.
Pour remplacer un membre de bibliothèque par un nouvel objet, spécifiez la bibliothèque contenant l’objet membre à remplacer et le nom de fichier du nouvel objet (ou la bibliothèque qui le contient). Lorsqu’un objet portant le même nom existe dans plusieurs fichiers d’entrée, LIB place le dernier objet spécifié dans la commande LIB dans la bibliothèque de sortie. Lorsque vous remplacez un membre de bibliothèque, veillez à spécifier le nouvel objet ou la bibliothèque après la bibliothèque qui contient l’ancien objet.
Pour supprimer un membre d’une bibliothèque, utilisez l’option /REMOVE. LIB traite toutes les spécifications de /REMOVE après avoir combiné tous les objets d’entrée, quel que soit l’ordre de ligne de commande.
Remarque
Vous ne pouvez pas supprimer un membre et l’extraire dans un fichier à la même étape. Vous devez d’abord extraire l’objet membre à l’aide /EXTRACTde , puis réexécuter LIB à l’aide /REMOVEde . Ce comportement diffère de celui de la bibliothèque LIB 16 bits (pour les bibliothèques OMF) fournie dans d’autres produits Microsoft.