GCC - The Complete Reference (537669), страница 122
Текст из файла (страница 122)
Расгдиренная информация для отладчика дт))з включается только при указании символа "+" в качестве значения 1еие1. Значения 1еие1 1, 2 и 3 описаны в опции -д. Этот формат может использоваться отладчиком РВХ на многих системах ВЯР, но он не работает с отладчиками РВХ или ЯРВ на платформах М1РБ, А!р))а я в системе 3'т)К4. Прн выработки информации формата БТАВБ на системе 3'т(К4 требуется также применение ассемблера б)ч)(3. 548 Часть |у. Приложения -н Рге Выводит упорядоченный список всех использованных заголовочных файлов вместе со отдельным списком таких файлов, не имеющих кода предотвращения ситуации их множественного включения.
Имеется другая форма представления этой опции: --схасе-спс1ибев. — Ье!р Показывает список распознаваемых дсс опций. Если также указана опция -ч, то выводимый список будет включать и опции задействуемых дсс процессов. Если при этом дополнительно указать опцию -н, то в список будут включены и все недокументированные опции. См. также описание опции --Сахдее-Ье1р. Рге, Ада, Зауа — 1пс!иде-61гес1огу То же, что опция -1. Рге, Ас1а,!ача -1 пате Поле пате этой опции указывает препроцессору имя верхнего каталога для поиска включаемых в программу заголовочных файлов Ппс1цде 61ез).
В этом каталоге и ниже его должен проводиться поиск файлов, включаемых препроцессором в исходный код программы по директиве йепс1ибе. Опция может быть использована в командной строке несколько раз для указания нескольких таких каталогов. Установленные этой опцией катало~и просматриваются в первую очередь, что дает возможность замещения любых включаемых в программы системных заголовочных файлов.
Использование этой опции с точкой, те. в форме -1., назначает компилятору текущий каталог в качестве рабочего каталога. При компиляции программ на языке Ада поле паве этой опции указывает путь для поиска исходных файлов. При компиляции программ на языке Гага указывает компилятору путь для для поиска файлов классов. Возможно указание не только имени каталога, но и имени . Зах или . яхр архива. Установка опции -1 имеет более высокий приоритет, чем опция --с1аеераСИ и переменная окружения Сьдяердтн. Указанное опцией -1 расположение будет просматриваться в первую очередь.
Разработчики компилятора рекомендуют отдавать предпочтение этой опции и использовать ее вместо --с1аеврасЬ. См. также опции -1-, -ееуесеш, -а, -псесбепс, -м1сЬрхехсхЬехоке и переменную окружения срлтн. По установке вторичного списка лля поиска заголовочных файлов см. опцию -Ы1кахсех. Эта опция другую форму представления --1пс1цбе-Ыкесссху. Рге Опция модифицирует порядок применения директив -1, стоящих перед ней в командной строке.
Установки этих опций будут действовать на директивы, имеющие формат $1пс1цбе "... ", и не будут оказывать действия на директивы в фор- Приложение Г. Опции командной строки компилятора ОСС 549 -1д!Гайег йгесйогу Рге Добавляет указанное имя кГсгесеогу во второй список каталогов для поиска заголовочных файлов. При поиске включаемого файла компилятор ОСС вначале просматривает каталоги из первого списка. И только затем, если файл не найден, поиск продолжается в каталогах из второго списка. В первый список каталоги добавляются опцией -1. Другая форма представления этой опции: --1ас1ибе-ссгесеогу-агеег. -!Птасгоь 6/епате Рге Указанный этой опцией файл с именем гх1епаже препроцессор считывает и обрабатывает прежде исходного кода программы.
В этом файле пропускается вся информация, кроме директив макроопределений. Назначенные при этом макросы могут затем быть использованы в обрабатываемом исходном файле. Любые опции -и или -п обрабатываются раньше любых опций -сжасгов. Опции -1пс1цсе и -сжасгов обрабатываются в том порядке, в котором они стоят в командной строке. Другая форма этой опции: --саасгов, -!Пс!цде 61еиате Рге Указанный этой опцией файл с именем Шепаже препроцессор считывает и обрабатывает прежде исходного кода программы так, как если бы он включался по директиве $1ас1цсе в первой строке программы.
Любые опции -и или -и обрабатываются раньше любых опций -сас1цбе. Опции -спс1цбе и -сжасгов обрабатываются в том порядке, в котором они стоят в командной строке. Другая форма этой опции: --1пс1ибе. -1пс1цде-Ьагг1ег Опция имеет то же значение, что и -1-. Рге -1пс1иде-д!Гес~огу-айег сИгесйогу То же, что и опция -Ыс гак еег. Рге -!пс! цде-ргейх рге6х То же, что и -сргеСсх. Рге -!Пс!иде-и11Ь-ргеФ!х йгес~огу То же„что и -3лтсспргег1х. Рге мате йспс1исе <... >. При этом все опции -1, которые стоят в командной строке после -1-, будут работать с директивами йспс1исе <...
>. Кроме того„использование опции -1- отменяет выполняемый по умолчанию поиск включаемых заголовочных файлов в каталоге расположения исходного файла. Другая форма представления этой опции: --1пс1исе-Ьаггсег. 550 Часть Пб Приложения 4пс1ибе-мч11Ь-ргейх-агтег йгес~огу То же„что и -1м1сЬрге11х. Рге 4пс! ис1е-тдг1Ф-ргейх-Ье1оге йгесйогу То же, что и -м1сЬргег1хЬегоге. Рге 4яуя1епз ЖгесФогу Рге Добавляет указанный каталог сИгессогу в начало дополнительного списка каталогов для поиска включаемых заголовочных файлов.
При этом каталог помечается как системный, при компиляции к нему применяется такое же отношение, как и к стандартным системным каталогам. См. также опции -1 и -в. 4ийпргейх йгес~огу Рге Опция добавляет каталог в дополнительный список путей включаемых заголовочных файлов. При этом полное имя добавляемого каталога составляется из префикса, указанною опцией -1ргег1х, и значения поля Жгесеогу этой опции. Если префикс не определен опцией -1ргегхх, стоящей в командной строке прежде рассматриваемой опции, то по умолчанию применяется такое значение префиксного каталога, которое действовало при инсталляции самого компилятора. При поиске включаемого заголовочного файла компилятор ОСС вначале просматривает каталоги из первого списка (каталоги в него добавляются опцией -1), затем, если файл не найден, поиск продолжается в каталогах из второго списка.
Эта опция может быть записана в форме --1пс1цбе-м1сЬ-ргег1х или --1пс1ибе-ттссЬ-ргег1х-агсег. -'пмФргейхЬе1оге ФгесФогу Рге Добавляет каталог в основной список путей для поиска включаемых заголовочных файлов. При этом полное имя добавляемого каталога составляется из префикса, указанного в опции -1ргег1х, и значения поля Игесеогуэтой опции. Если префикс не определен в командной строке до рассматриваемой опции, то по умолчанию применяется такое значение префиксного каталога, которое действовало при инсталляции самого компилятора. Эта опция может быть записана как --1пс1ибе-м1сЬ-ргег1х-Ьегоге.
--11Ьгагу-с11гес1огу йгес~огу Опция имеет то же значение, что и -ь. 1л1п1сег 4ргейх рге6х Рге Указывает значение ргей1х в качестве префикса, добавляемого для составления полных имен путей доступа перед именами каталогов, указанных опциями -1н1сЬрге11х и -1тт1сЬргег1хЬегоге. Другая форма этой опции: --1пс1ибе-рге11х. Приложение Г. Опции командной строки компилятора йСС 55 1 -1АИге сходку Добавляет указанный каталог стхгесеогу в список каталогов для поиска библиотек, указанных опциями -1 ("эль"). См.
также опцию -в и в приложении 2 описание переменной окружения 1 ХВЯАВХ РАТН. -1ИЬгагу Опция задает имя статической библиотеки, используемой компоновшиком для разрешения внешних ссылок. Полное имя библиотеки составляется добавлением к указанному имени 1ЛЬгагу префикса 11Ь и суффикса .а. Например, опция -1сопво1е сообщает компоновшику имя библиотеки 11Ьсопво1е.а.
Поиск библиотеки с именем, указаным опцией -1, будет выполняться среди библиотек стандартного набора (т.е. в стандартных каталогах для размещения библиотек) и в каталогах, указанных опциями -г . При компоновке программ на языке О(уеспве-С требуется указтавать опцию -1оЬзс. Она сообшает компоновщику о необходимости использования основной библиотеки ОЬ|ест(те-С11ЬоЬЗс.а. Для разрешения внешних ссылок программы компоновщик просматривает библиотеки в том порядке, в котором они указаны опциями -1 в командной строке.
Порядок просмотра библиотек может иметь важное значение. Например, по следующей команде компоновщик сможет разрешить все ссылки из библиотеки д1омег. о на объектгя библиотеки 11Ьзред. а и не сможет разрешить такие же ссылки, если они есть в библиотеке й1овтег.о. дсс д1оивг.о -1эред гзоиег.о -о вватта11 Порядок следования опций имеет значение и тогда, когда используемые библиотеки имеют перекрестные ссылки между собой. При наличии циркулярных ссылок между двумя библиотеками для их разрешения может потребоваться указание в команде их имен более одного раза.
Как в следующем примере команды: доо вргьпд.о -1скзас -1гигЬо -1дк1ас -о вргьпд Одна и та же библиотека может быть указана в командной строке как своим полным именем (11Ьзред. а), так и опцией -1 (-1бред). Но только при использовании опции -1 компоновщик будет выполнять поиск библиотеки в стандартных каталогах и в каталогах, назначенных опциями -ь. Для совместимости с соглашениями РОБ1Х допускается оставлять пробел между флагом опции и именем библиотеки. См. также опцию -ь.
— ! апяиаяе !апуиаде Опция имеет то же значение, что и -х. Рге По этой опции препроцессор выводит правило зависимостей в формате, пригодном для его включения в компоновочный сценарий (гпайей1е). Это правило состав- 552 Часть 1У. Приложения ляется из имени объектного файла, стоящего за ним двоеточия, и, затем, имени исходного файла и имен всех включаемых заголовочных файлов. Каждый включаемый файл выводится в отдельной строке, вместе с полным путем расположения (ра(п пате). если какие-либо файлы были указаны в командной строке опциями -зпс1ибе или -йпасхов, то их имена также будут выведены в этом списке. Опция -м автоматически применяет опцию -в, Выводимое по этой опции правило включает только имя объектного файла и список зависимостей, там нет никаких указаний, относящихся к компиляции исходного кода.