Параметры управления программой

Для управления работой библиотекаря используется набор параметров (ключей).

Все параметры предваряются префиксом "-".

Они могут быть указаны в командной строке или в командном файле (см. подраздел 5.7 «Командный файл»).

В Табл. 5‑1 приводится перечень параметров библиотекаря.

Табл. 5‑1 Список параметров управления библиотекарем.

Наименование параметра	Назначение
-c [create]	Создание библиотеки объектных файлов.
-a [add]	Добавление файлов в библиотеку объектных файлов.
-r [replace]	Замещение файлов в библиотеке объектных файлов.
-d [delete]	Удаление файлов из библиотеки объектных файлов.
-e [extract]	Извлечение файлов из библиотеки объектных файлов.
-l [list]	Просмотр содержимого библиотеки объектных файлов.
-h [help]/-?	Краткая справка об использовании программы.

5.6.1 Создание библиотеки (ключ -c [create])

При данном режиме должны быть указаны имя создаваемой библиотеки и имена включаемых объектных файлов. При указании имен объектных файлов допускается использование wildcards: '*' и '?'. Если в качестве имени библиотеки используется имя существующего файла, то этот файл будет предварительно удален.

5.6.2 Добавление файлов в библиотеку (ключ -a [add])

Режим аналогичен предыдущему, за исключением того, что в случае существования библиотеки с указанным именем, эта библиотека не будет предварительно уничтожена, указанные объектные файлы будут добавлены в библиотеку. Если при попытке добавить файл в библиотеку обнаруживается, что файл с таким именем в библиотеке уже существует, то добавление не будет произведено.

5.6.3 Замещение файлов в библиотеке (ключ -r [replace])

Режим аналогичен режиму add, за исключением того, что указанные в командной строке объектные файлы будут добавлены в библиотеку вне зависимости от того, есть ли одноименные файлы уже в библиотеке или нет.

5.6.4 Удаление файлов из библиотеки (ключ -d [delete])

В режиме удаления в командной строке обязательно должны быть указаны имя библиотеки и удаляемые файлы. Если файла с указанным именем в библиотеке нет, библиотекарь выдает предупреждение и продолжает работу.

5.6.5 Извлечение файлов из библиотеки (ключ -e [extract])

Данный режим позволяет извлечь из библиотеки модули и поместить их в отдельные объектные файлы. Библиотека при этом не изменяется. При извлечении в командной строке должно быть указано имя библиотеки. Если не указаны имена объектных файлов, то из библиотеки будут извлечены все модули. При извлечении создаваемые файлы получают текущее время!

5.6.6 Просмотр содержимого библиотеки (ключ -l [list])

Выводится список элементов библиотеки с указанием имени, времени и размера. Сам ключ в командной строке можно не указывать, например:

libr library.lib

5.6.7 Краткая справка об использовании программы (ключ -h [help]/-?)

Краткая справка выдается также при запуске программы без параметров или с ключами -h, -?. Ее вид:

Библиотекарь объектных файлов * v1.02 * (c) 1997-99 * НТЦ Модуль

Формат запуска:

libr [команда] [имя_библиотеки] [список_файлов]

команда   - команда, задающая режим работы библиотекаря

имя_библиотеки - имя библиотеки

список_файлов - перечень объектных файлов

Список команд:

-h или -? - краткая справка (этот текст)

-l   - просмотреть список файлов библиотеки

-c   - создать библиотеку

-a   - добавить файлы в библиотеку

-d   - удалить файлы из библиотеки

-e   - извлечь файлы из библиотеки

(библиотека не изменяется)

-r - добавить файлы в библиотеку с замещением существующих

Примечания:

1. Если команда не указана, выполняется '-l'.

2. '-c' перед созданием библиотеки уничтожает файл с именем имя_библиотеки.

3. Если при извлечении список файлов не указан, извлекаются все файлы.

4. Извлекаемые файлы перекрывают существующие.

5. При удалении и замещении создается временная копия библиотеки.

Командный файл

Часть параметров библиотекаря может быть помещена в командный файл. В этом случае командная строка имеет вид:

libr @имя_командного_файла.

Командных файлов может быть несколько:

libr @командный_файл1 @командный_файл2.

Кроме того, в командный файл может быть занесена только часть командной строки, например:

libr @имя_командного_файла.

Не допускаются вложенные командные файлы.

Командный файл представляет собой текстовый файл, содержащий допустимые параметры, разделенные произвольным количеством разделителей. В качестве разделителей можно использовать пробелы, символы табуляции и перевода строки.

Пример командного файла:

-с mylib.lib

file1.elf file2.elf

file3.elf file4.elf

При вызове библиотекаря с данным командным файлом будет создана библиотека mylib.lib, в состав которой войдут перечисленные выше объектные файлы.