Запуск программы LIBRunning LIB

Для управления LIB можно использовать различные параметры командной строки.Various command-line options can be used to control LIB.

Командная строка LIBLIB Command Line

Чтобы запустить программу LIB, введите команду lib, а затем укажите параметры и имена файлов для задачи, для которой вы используете LIB.To run LIB, type the command lib, followed by the options and file names for the task you're using LIB for. LIB также принимает входные данные командной строки в командных файлах, которые описаны в следующем разделе.LIB also accepts command-line input in command files, which are described in the following section. LIB не использует переменную среды.LIB doesn't use an environment variable.

Командные файлы LIBLIB Command Files

Аргументы командной строки можно передать в LIB в командном файле с помощью следующего синтаксиса:You can pass command-line arguments to LIB in a command file using the following syntax:

Файл команд lib @LIB @command-file

Файл Command-File — это текстовый файл.The file command-file is a text file. Пробелы и символы табуляции не допускаются между символом ( @ ) и именем файла.No spaces or tabs are allowed between the at sign (@) and the file name. Имя командного файла не имеет расширения по умолчанию.The command-file name has no default extension. Укажите полное имя файла, включая любое расширение.Specify the full file name, including any extension. Подстановочные знаки использовать нельзя.Wildcards can't be used. Вы можете указать абсолютный или относительный путь с именем файла.You may specify an absolute or relative path with the file name.

В командном файле аргументы могут быть разделены пробелами или символами табуляции, как это можно сделать в командной строке.In the command file, arguments can be separated by spaces or tabs, as they can on the command line. Аргументы также можно разделять символами новой строки.Arguments can also be separated by newline characters. Чтобы пометить комментарий, используйте точку с запятой ( ; ).Use a semicolon (;) to mark a comment. LIB игнорирует весь текст от точки с запятой до конца строки.LIB ignores all text from the semicolon to the end of the line.

В командном файле можно указать либо все, либо часть командной строки, а в команде LIB можно использовать более одного командного файла.You can specify either all or part of the command line in a command file, and you may use more than one command file in a LIB command. LIB принимает ввод командного файла, как если бы он был указан в этом расположении в командной строке.LIB accepts the command-file input as if it's specified in that location on the command line. Командные файлы не могут быть вложенными.Command files can't be nested. LIB отображает содержимое командных файлов, если не используется параметр /nologo .LIB echoes the contents of command files unless the /NOLOGO option is used.

Использование параметров LIBUsing LIB Options

Параметр состоит из спецификатора Option, который является либо тире ( - ), либо косой чертой ( / ), за которой следует имя параметра.An option consists of an option specifier, which is either a dash (-) or a forward slash (/), followed by the name of the option. Имена параметров не могут быть сокращены.Option names can't be abbreviated. Некоторые параметры принимают аргумент, указанный после двоеточия ( : ).Some options take an argument, specified after a colon (:). В спецификации параметров не допускаются пробелы и символы табуляции.No spaces or tabs are allowed within an option specification. Используйте один или несколько пробелов или символов табуляции для разделения спецификаций параметров в командной строке.Use one or more spaces or tabs to separate option specifications on the command line. Имена параметров и их ключевые слова или имена файлов не учитывают регистр, но идентификаторы, используемые в качестве аргументов, чувствительны к регистру.Option names and their keyword or file name arguments aren't case-sensitive, but identifiers used as arguments are case-sensitive. LIB обрабатывает параметры в порядке, указанном в командной строке и в командных файлах.LIB processes options in the order specified on the command line and in command files. Если параметр повторяется с другими аргументами, последний из них имеет приоритет.If an option is repeated with different arguments, the last one to be processed takes precedence.

Следующие параметры применяются ко всем режимам работы с LIB:The following options apply to all modes of LIB:

/Errorreport [None | , Отправка очереди | запросов | ]/ERRORREPORT [NONE | PROMPT | QUEUE | SEND]

Параметр/ERRORREPORT является устаревшим.The /ERRORREPORT option is deprecated. Начиная с Windows Vista, Управление отчетами об ошибках осуществляется с помощью параметров отчеты об ошибках Windows (WER) .Starting in Windows Vista, error reporting is controlled by Windows Error Reporting (WER) settings.

/Линкрепро: directory-Path /LINKREPRO:directory-path
/Линкрепротаржет: имя файла/LINKREPROTARGET:filename

Чтобы помочь корпорации Майкрософт в диагностике сбоев и внутренних ошибок программы lib. exe, можно использовать параметр /линкрепро .To help Microsoft diagnose lib.exe crashes and internal errors, you can use the /LINKREPRO option. Этот параметр создает ссылкудля воспроизведения, набор артефактов сборки, которые позволяют корпорации Майкрософт воспроизвести проблему, возникающую во время операций с библиотекой.This option generates a link repro, a set of build artifacts that allow Microsoft to reproduce a problem that occurs during library operations. Параметр /линкрепротаржет можно использовать с параметром /линкрепро .The /LINKREPROTARGET option can be used with the /LINKREPRO option. Он создает только артефакты для воспроизведения ссылок, когда программа lib. exe создает указанный файл.It only generates link repro artifacts when lib.exe produces the specified file. Дополнительные сведения см. в разделе как сообщить о проблеме с набором C++ инструментов Майкрософт.For more information, see How to report a problem with the Microsoft C++ toolset.

/LTCG/LTCG

"LTCG" означает Создание кода во время компоновки."LTCG" stands for link-time code generation. Эта функция требует взаимодействия между компилятором (CL. exe), lib и компоновщиком (Link).This feature requires cooperation between the compiler (cl.exe), LIB, and the linker (LINK). Вместе они могут оптимизировать код, помимо того, что может сделать любой компонент.Together they can optimize code beyond what any component can do by itself.

Параметр /LTCG для lib указывает, что входные данные из CL. exe включают объектные файлы, созданные с помощью параметра компилятора /GL .The /LTCG option to LIB specifies that the inputs from cl.exe include object files generated by using the /GL compiler option. Если LIB обнаруживает такие входные данные, а параметр /LTCG не указан, он перезапускается с включенным параметром/LTCG после отображения информационного сообщения.If LIB encounters such inputs, and /LTCG isn't specified, it restarts with /LTCG enabled after displaying an informational message. Иными словами, нет необходимости явно задавать этот параметр, но это ускоряет производительность сборки.In other words, it isn't necessary to set this option explicitly, but it speeds up build performance. Это обусловлено тем, что LIB не должен перезапускать саму себя.That's because LIB doesn't have to restart itself.

В процессе сборки выходные данные из библиотеки LIB отправляются в LINK.In the build process, the output from LIB is sent to LINK. LINK имеет собственный отдельный параметр /LTCG .LINK has its own separate /LTCG option. Он используется для выполнения различных операций оптимизации, включая оптимизацию всей программы и инструментирование с использованием профильной оптимизации (PGO).It's used to perform various optimizations, including whole-program optimization and profile-guided optimization (PGO) instrumentation. Дополнительные сведения о параметре LINK см. в разделе /LTCG.For more information about the LINK option, see /LTCG.

/MACHINE/MACHINE

Указывает целевую платформу для программы.Specifies the target platform for the program. Обычно не требуется указывать параметр /Machine.Usually, you don't need to specify /MACHINE. LIB выводит тип компьютера из OBJ-файлов.LIB infers the machine type from the .obj files. Однако в некоторых случаях программа LIB не может определить тип компьютера и выдает сообщение об ошибке.However, in some circumstances, LIB can't determine the machine type and issues an error message. При возникновении такой ошибки укажите /Machine.If such an error occurs, specify /MACHINE. В режиме /Extract этот параметр предназначен только для проверки.In /EXTRACT mode, this option is for verification only. Для просмотра доступных типов компьютеров используйте lib /? из командной строки.Use lib /? at the command line to see available machine types.

/NOLOGO/NOLOGO

Отключает отображение сообщения об авторских правах и номера версии LIB и предотвращает вывод командных файлов.Suppresses display of the LIB copyright message and version number and prevents echoing of command files.

/VERBOSE/VERBOSE

Отображает сведения о ходе выполнения сеанса, включая имена добавляемых OBJ-файлов.Displays details about the progress of the session, including names of the .obj files being added. Эти сведения отправляются в стандартный вывод и могут быть перенаправлены в файл.The information is sent to standard output and can be redirected to a file.

/WX[ : No]/WX[:NO]

Обрабатывать предупреждения как ошибки.Treat warnings as errors. Дополнительные сведения см. в разделе Параметр /WX (обработка предупреждений компоновщика как ошибок).For more information, see /WX (Treat Linker Warnings as Errors).

Другие параметры применяются только к конкретным режимам работы LIB.Other options apply only to specific modes of LIB. Эти параметры обсуждаются в разделах, описывающих каждый из режимов.These options are discussed in the sections describing each mode.

См. также разделSee also

Справочник по LIBLIB Reference