Executando LIB

Várias opções de linha de comando podem ser usadas para controlar o LIB.

Linha de comando LIB

Para executar o LIB, digite o comando lib, seguido pelas opções e nomes de arquivo para a tarefa para a qual você está usando o LIB. O LIB também aceita a entrada de linha de comando em arquivos de comando, descritos na seção a seguir. LIB não usa uma variável de ambiente.

Arquivos do comando LIB

Você pode passar argumentos de linha de comando para LIB em um arquivo de comando usando a seguinte sintaxe:

LIB @command-file

O command-file do arquivo é um arquivo de texto. Nenhum espaço ou guia é permitido entre o sinal (@) e o nome do arquivo. O nome command-file não tem nenhuma extensão padrão. Especifique o nome completo do arquivo, incluindo qualquer extensão. Curingas não podem ser usados. É possível especificar um caminho absoluto ou relativo com o nome do arquivo.

No arquivo de comando, os argumentos podem ser separados por espaços ou tabulações, como podem na linha de comando. Os argumentos também podem ser separados por caracteres de nova linha. Use um ponto e vírgula (;) para marcar um comentário. O LIB ignora todo o texto desde o ponto e vírgula até o final da linha.

Você pode especificar tudo ou parte da linha de comando em um arquivo de comando e pode usar mais de um arquivo de comando em um comando LIB. O LIB aceita a entrada de arquivo de comando como se tivesse sido especificado naquele local na linha de comando. Os arquivos de comando não podem ser aninhados. O LIB ecoa o conteúdo dos arquivos de comando, a menos que a opção /NOLOGO seja usada.

Usando opções LIB

Uma opção consiste em um especificador de opção, que é um traço (-) ou uma barra (/), seguida pelo nome da opção. Os nomes de opções não podem ser abreviados. Algumas opções usam um argumento, especificado após dois-pontos (:). Espaços ou tabulações não são permitidos dentro de uma especificação de opção. Use um ou mais espaços ou tabulações para separar as especificações de opção na linha de comando. Os nomes de opção e suas palavras-chave ou argumentos de nome de arquivo não diferenciam maiúsculas de minúsculas, mas os identificadores usados como argumentos diferenciam maiúsculas de minúsculas. O LIB processa opções na ordem especificada na linha de comando e nos arquivos de comando. Se uma opção for repetida com argumentos diferentes, a última processada terá precedência.

As seguintes opções se aplicam a todos os modos de LIB:

/ERRORREPORT [NONE | PROMPT | QUEUE | SEND]

A opção /ERRORREPORT foi preterida. Desde o Windows Vista, o relatório de erros é controlado pelas configurações WER (Relatório de Erros do Windows).

/LINKREPRO:directory-path
/LINKREPROTARGET:filename

Para ajudar a Microsoft a diagnosticar falhas e erros internos de lib.exe, você pode usar a opção /LINKREPRO. Essa opção gera uma reprodução de vinculação é um conjunto de artefatos de compilação que permitem à Microsoft reproduzir um problema que ocorre durante as operações da biblioteca. A opção /LINKREPROTARGET pode ser usada com a opção /LINKREPRO. Ele só gera artefatos de reprodução de link quando lib.exe produz o arquivo especificado. Para obter mais informações, confira Como relatar um problema com o conjunto de ferramentas do Microsoft C++.

/LTCG

"LTCG" significa geração de código em tempo de link. Esse recurso requer cooperação entre o compilador (cl.exe), LIB e o vinculador (LINK). Juntos, eles podem otimizar o código além do que qualquer componente pode fazer sozinho.

A opção /LTCG para LIB especifica que as entradas de cl.exe incluem arquivos de objeto gerados usando a opção do compilador /GL. Se o LIB encontrar essas entradas e /LTCG não for especificado, ele será reiniciado com /LTCG habilitado após exibir uma mensagem informativa. Em outras palavras, embora não seja necessário definir essa opção explicitamente, isso acelera o desempenho de build. Isso ocorre porque o LIB não precisa reiniciar sozinho.

No processo de build, a saída do LIB é enviada para LINK. O LINK tem sua própria opção /LTCG separada. Ele é usado para executar várias otimizações, incluindo otimização de programas inteiros e instrumentação PGO (otimização guiada por perfil). Para obter mais informações sobre a opção LINK, consulte /LTCG.

/MACHINE

Especifica a plataforma de destino para o programa. Normalmente, você não precisa especificar /MACHINE. LIB infere o tipo de computador dos arquivos .obj. No entanto, em algumas circunstâncias, o LIB não pode determinar o tipo de computador e emite uma mensagem de erro. Se esse erro ocorrer, especifique /MACHINE. No modo /EXTRACT , essa opção é somente para verificação. Use lib /? na linha de comando para ver os tipos de computador disponíveis.

/NOLOGO

Suprime a exibição da mensagem de direitos autorais e do número de versão da LIB e impede o eco de arquivos de comando.

/VERBOSE

Exibe detalhes sobre o andamento da sessão, incluindo os nomes dos arquivos .obj que estão sendo adicionados. A informação é enviada para uma saída padrão e pode ser redirecionada para um arquivo.

/WX[:NO]

Tratar avisos como erros. Para obter mais informações, consulte /WX (Tratar Avisos do Vinculador como Erros).

Outras opções se aplicam somente a modos específicos de LIB. Essas opções são discutidas nas seções que descrevem cada modo.

Confira também

Referência de LIB