3.5.9. Опции для компоновщика

Опция

Описание

-Ldir

Добавить каталог dir к списку каталогов, в которых будет

производиться поиск библиотек, определенных опцией -l.

-llibrary

При компоновке искать библиотеку library.

Компоновщик ищет библиотеку, файл которой имеет в

A

library.a в стандартном списке

действительности имя lib.

каталогов библиотек. После этого он использует этот файл

так, как если бы он был точно задан своим именем.

Wilson

Есть разница, в каком месте командной строки указана

опция; Компоновщик обрабатывает библиотеки и объектные

файлы в той последовательности, в которой они заданы. Т.е.

foo. -lz bar.o даст поиск библиотеки z после файла

foo.o, но перед файлом bar.o. Если файл bar.o ссылается

на функции из libz.a, то эти функции могут не загрузиться.

Каталоги для поиска включают некоторое количество

стандартных системных директорий, плюс те, что были

определены опциями -L.

Обычно файлы, найденные таким способом, являются

библиотечными (файлами архивов, состоящих из объектных

by

файлов). Компоновщик обрабатывает архивы путем поиска в

них объектных файлов, в которых определены символы, на

которые уже были ссылки, но не было определений. Но если

обрабатываемый файл является просто объектным файлом,

Translated

то он компонуется обычным способом. Единственной

разрешаются точками входа в стандартных библиотеках

разницей между использованием опции -l (т.е. -lmylib) и

простым заданием имени файла библиотеки (т.е.

libmylib.a) является то, что -l ищет библиотеку в ряде

каталогов, как определено. По умолчанию компоновщик

будет искать библиотеки, заданные опцией -l в каталоге:

<install-path>\lib

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

умолчанию, это будет:

c:\Program Files\Microchip\MPLAB C30\lib

Такое поведение может быть изменено с использованием

переменных окружения, описанных в п. 3.6. «Переменные

окружения».

-nodef ultlibs

Не использовать стандартные системные библиотеки при

компоновке. Компоновщику будут переданы только

библиотеки, которые вы зададите. Компилятор может

создавать вызовы memcmp, memset и memcpy. Обычно они

компилятора. При использовании данной опции описанные

точки входа должны поддерживаться каким-то другим

способом.

-s

Удалить все таблицы символов и информацию о

перемещении из исполняемого кода.

© 2008 Microchip Technology Inc.

DS51284H(ru) стр. 3-23

Опция

Описание

-u symbol

Сделать вид, что symbol не определен, чтобы заставить

прикомпоновать библиотечные модули с его определением.

Допустимо многократное использование опции -u с разными

символами, для загрузки дополнительных библиотечных

модулей.

-Wl, option

Передать опцию option компоновщику. Если option

содержит запятые, она разбивается этими запятыми на

несколько опций.

-Xlinker option

.

Передать опцию option компоновщику. Может

A

использоваться для поддержки специфических системных

опций компоновщика, которые компилятор не распознает.

Wilson

3.5.10. Опции для поиска в каталогах

Опция

Описание

-Bprefix

Эта опция определяет, где искать исполняемые,

библиотечные, включаемые файлы и файлы данных самого

компилятора. Драйвер компилятора запускает одну или

более программ pic30-cpp, pic30-cc1, pic30-as и

pic30-ld. Он пробует prefix в качестве префикса для

каждой программы, которую пытается запустить.

Для каждой запускаемой программы драйвер компилятора

первым делом проверяет префикс опции -B, если есть. Если

by

программа не найдена или опция -B отсутствует, драйвер

использует значение, хранимое в переменной окружения

PIC30_EXEC_PREFIX, если оно задано. Подробнее см. п. 3.6.

«Переменные окружения». Наконец, драйвер будет искать

для программ текущую переменную окружения PATH.

Префикс опции -B, который эффективно определяет названия

каталогов, также используется для библиотек

компоновщиком, потому что компилятор переводит его в

опцию -L для компоновщика. Он также применяется для

включаемых препроцессором файлов, поскольку компилятор

переводит его в опцию -isystem для препроцессора. В этом

случае компилятор добавляет к префиксу include.

Другой, очень похожий на опцию -B способ задать префикс,

заключается в использовании переменной окружения

PIC30_EXEC_PREFIX

-specs=file

Обработать файл после того, как компилятор причитает

Translated

стандартный файл specs, для того, чтобы аннулировать

умолчания, которые управляющая программа pic30-gcc

использует для определения, какие опции передавать

pic30-cc1, pic30-as, pic30-ld, и т.п. В командной

строке может быть определено больше одной опции

-specs=file, и все они будут обработаны в порядке слева

направо.

DS51284H(ru) стр. 3-24

© 2008 Microchip Technology Inc.

Опция

Описание

-fargument-alias

Определяет возможные соотношения между параметрами и

-fargument-noalias

между параметрами и глобальными данными.

-fargument-

-fargument-alias — определяет, что аргументы

noalias-global

(параметры) могут перекрываться друг с другом и с

глобальной областью памяти.

.

-fargument-noalias — определяет, что аргументы не

A

могут перекрываться друг с другом, но могут перекрываться

с глобальной областью памяти.

-fargument-noalias-global — определяет, что

Wilson

аргументы не могут перекрываться друг с другом и с

глобальной областью памяти.

Каждый язык будет автоматически использовать ту опцию,

какая необходима по языковому стандарту. Вам

необязательно использовать эти опции самому.

-fcall-saved-reg

Трактовать регистр с именем reg как доступный регистр

сохраняемый функциями. Он может быть выделен даже для

временных нужд или переменных, которые существуют до и

после вызова. Функции, компилированные таким способом,

будут сохранять и восстанавливать регистр reg, если они

используют его.

Использование этой опции с указателями фрейма или стека

является ошибкой. Использование этой опции для другого

регистра, которому отводится фиксированная повсеместная

роль в машинной модели исполнения, приведет к

Translated

byкатастрофическим результатам.

Беда другого свойства произойдет при использовании этой

опции для регистра, в котором функция может возвращать

результат.

Этот флаг должен использоваться равным образом для всех

модулей.

-fcall-used-reg

Трактовать регистр с именем reg как доступный регистр,

который затирается функциями. Он может быть выделен для

временных нужд или переменных, которые существуют

только до вызова. Функции, компилированные таким

способом, будут не будут сохранять и восстанавливать

регистр reg.

Использование этой опции с указателями фрейма или стека

является ошибкой. Использование этой опции для другого

регистра, которому отводится фиксированная повсеместная

роль в машинной модели исполнения, приведет к

катастрофическим результатам.

Этот флаг должен использоваться равным образом для всех

модулей.

-ffixes-reg

Трактовать регистр с именем reg как защищенный регистр;

генерируемый код никогда не должен ссылаться на него

(кроме, возможно, как на указатели стека и фрейма и

некоторые другие регистры постоянного назначения).

reg должно быть именем регистра, например:

-ffixed-w3

© 2008 Microchip Technology Inc.

DS51284H(ru) стр. 3-25

Опция

Описание

-finstrument-functions

Генерировать инструментальные вызовы на входе и выходе

функции. Сразу после входа в функцию и точно перед

выходом из функции, будут вызваны следующие

профилирующие функции с адресом текущей функции и

местоположением вызова.

void __cyg_profile_func_enter

(void *this_fn, void *call_site);

void __cyg_profile_func_exit

(void *this_fn, void *call_site);

Первый аргумент является адресом начала текущей функции

.

и однозначно может быть обнаружен в таблице символов.

Функции профилирования должны быть предусмотрены

пользователем.

A

Такое оснащение функций требует использования указателя

фреймов. Некоторые уровни оптимизации запрещают

использование указателя фреймов. Предохранит от этого

задание опции -fno-omit-frame-pointer.

Это оснастка также делается для функций, inline

встраиваемых в другие функции. Профилирующие вызовы

будут указывать где, в принципе, происходит вход и выход из

inline встроенной функции. Это означает, что должны быть

доступны адресуемые версии таких функций. Если все

используемые вами функции встроены inline, вышесказанное

Wilson

может означать дополнительное увеличение размеров кода.

Если extern inline используется в вашем коде Cи, то

должна быть предусмотрена адресуемая версия таких

функций.

Если функции присвоен атрибут no_instrument_function,

by

тогда эта оснастка не будет сделана.

-fno-ident

Игнорировать директиву #ident

-fpack-struct

Паковать члены структур вместе без пропусков. Обычно вы

не горите желанием использовать эту опцию, поскольку она

делает код не оптимальным, а смещения членов структур не

будут согласовываться с системными библиотеками.

Устройство dsPIC® требует, чтобы слова были выровнены по

границе четных байтов, так что следует быть весьма

аккуратными при использовании атрибута упаковки, чтобы

избежать ошибок адресации на этапе исполнения.

-fpcc-struct-return

Возвращать значения коротких struct и union, подобно

Translated

длинным, в памяти, а не в регистрах. Это соглашение менее

эффективно, но у него есть преимущество совместимости

вызовов между файлами, откомпилированными 16-битовым

компилятором, и файлами, откомпилированными другими

компиляторами.

Короткие структуры и союзы — те, чей размер и

выравнивание соответствует одному из целых типов.

-fno-short-double

По умолчанию компилятор использует тип double

эквивалентный типу float. Эта опция делает double

эквивалентным long double. Выборочное применение этой

опции к разным модулям может иметь непредсказуемые

результаты, если модули совместно используют данные типа

double как непосредственно, через передачу аргументов,

так и косвенно, через общее буферное пространство.

Штатные библиотеки предусматривают обе установки опции.

-fshort-enums

Выделять для типа enum только такое количество байтов,

которое нужно для объявленного диапазона возможных

значений. А именно, тип enum будет эквивалентен

наименьшему целому типу, который его вмещает.

DS51284H(ru) стр. 3-26

© 2008 Microchip Technology Inc.