Administrar una biblioteca

El modo predeterminado de LIB es compilar o modificar una biblioteca de objetos COFF. LIB se ejecuta en este modo cuando no se especifica /EXTRACT (para copiar un objeto en un archivo) o /DEF (para compilar una biblioteca de importación).

Para compilar una biblioteca a partir de objetos o bibliotecas, use la siguiente sintaxis:

LIB [options...] files...

Este comando crea una biblioteca a partir de uno o varios archivos de entrada, files. files puede ser archivos objeto COFF, archivos objeto OMF de 32 bits o bibliotecas COFF existentes. LIB crea una biblioteca que contiene todos los objetos de los archivos especificados. Si un archivo de entrada es un archivo objeto OMF de 32 bits, LIB lo convierte en COFF antes de compilar la biblioteca. LIB no puede aceptar objetos OMF de 32 bits que se encuentren en una biblioteca creada por la versión de 16 bits de LIB. Primero debe usar la LIB de 16 bits para extraer el objeto; después, puede usar el archivo objeto extraído como entrada en la LIB de 32 bits.

Cuando la LIB asigna un nombre al archivo de salida utiliza de forma predeterminada el nombre base del primer objeto o archivo de biblioteca y la extensión .lib. El archivo de salida se coloca en el directorio actual. Si ya existe un archivo con el mismo nombre, el archivo de salida reemplaza al archivo existente. Para conservar una biblioteca existente, use la opción /OUT para especificar un nombre para el archivo de salida.

Las siguientes opciones se aplican a la creación y modificación de una biblioteca:

/LIBPATH: dir
Reemplaza la ruta de acceso a la biblioteca de entorno y la establece en dir. Para más información, consulte la descripción de la opción /LIBPATH de LINK.

/LIST
Muestra información sobre la biblioteca de salida a la salida estándar. La salida se puede redireccionar a un archivo. Puede usar /LIST para determinar el contenido de una biblioteca existente sin modificarlo.

/NAME: filename
Al compilar una biblioteca de importación, filename especifica el nombre del archivo DLL para el que se compila dicha biblioteca.

/NODEFAULTLIB
Quita una o varias bibliotecas predeterminadas de la lista de bibliotecas en la que realiza búsquedas cuando resuelve referencias externas. Para obtener más información, vea /NODEFAULTLIB.

/OUT: filename
Reemplaza el nombre de archivo de salida predeterminado y lo reemplaza por filename. De forma predeterminada, la biblioteca de salida se crea en el directorio actual, con el nombre base de la primera biblioteca o archivo de objeto en la línea de comandos y la extensión .lib.

/REMOVE: object
Omite el elemento object especificado de la biblioteca de salida. LIB crea una biblioteca de salida al combinar todos los objetos (independientemente de que estén en archivos objeto o bibliotecas) y luego eliminar los objetos especificados con /REMOVE.

/SUBSYSTEM:{CONSOLE | EFI_APPLICATION | EFI_BOOT_SERVICE_DRIVER | EFI_ROM | EFI_RUNTIME_DRIVER | NATIVE | POSIX | WINDOWS | WINDOWSCE}[,#[.##]]
Indica al sistema operativo cómo ejecutar un programa creado mediante la vinculación a la biblioteca de salida. Para más información, vea la descripción de la opción /SUBSYSTEM de LINK.

Las opciones de LIB especificadas en la línea de comandos no distinguen mayúsculas de minúsculas.

LIB se puede usar para realizar las siguientes tareas de administración de biblioteca:

  • Para agregar objetos a una biblioteca, especifique el nombre de archivo de la biblioteca existente y los nombres de archivo de los nuevos objetos.

  • Para combinar bibliotecas, especifique los nombres de archivo de las bibliotecas. Puede agregar objetos y combinar bibliotecas con un solo comando LIB.

  • Para reemplazar un miembro de la biblioteca por un nuevo objeto, especifique la biblioteca que contiene el objeto miembro que se va a reemplazar y el nombre de archivo del nuevo objeto (o la biblioteca que lo contiene). Si existe un objeto con el mismo nombre en más de un archivo de entrada, LIB coloca el último objeto especificado en el comando LIB en la biblioteca de salida. Al reemplazar un miembro de la biblioteca, asegúrese de especificar el nuevo objeto o biblioteca después de la biblioteca que contiene el objeto antiguo.

  • Para eliminar un miembro de una biblioteca, use la opción /REMOVE. LIB procesa todas las especificaciones de /REMOVE después de combinar todos los objetos de entrada, independientemente del orden en la línea de comandos.

Nota:

No puede eliminar un miembro y extraerlo en un archivo en el mismo paso. Primero debe extraer el objeto miembro mediante /EXTRACTy, después, volver a ejecutar LIB mediante /REMOVE. Este comportamiento difiere del de la LIB de 16 bits (para bibliotecas OMF) que se proporciona en otros productos de Microsoft.

Consulte también

Referencia de LIB