Spec-Zone.ru › GCC 7

3.18.10 Варианты Darwin

Эти параметры определены для всех архитектур, использующих операционную систему Darwin.

FSF GCC на Darwin не создаёт «fat» объектные файлы; он создаёт объектный файл для единственной архитектуры, на которую настроен GCC. Apple’s GCC на Darwin создаёт «fat» файлы, если используется несколько опций -arch; он делает это, выполняя компилятор или компоновщик несколько раз и объединяя результаты вместе с помощью lipo.

Тип создаваемого файла (например, ‘ppc7400’ или ‘ppc970’ или ‘i686’) определяется флагами, которые указывают ISA, на которую настроен GCC, например, -mcpu или -march. Опция -force_cpusubtype_ALL может быть использована для переопределения этого.

Инструменты Darwin ведут себя по-разному при возникновении несоответствия ISA. Ассемблер as разрешает использовать только инструкции, допустимые для типа создаваемого файла, поэтому вы не можете поместить 64-битные инструкции в файл объекта ‘ppc750’. Компоновщик для общих библиотек /usr/bin/libtool терпит неудачу и выводит ошибку, если его попросить создать общую библиотеку с менее жёсткими ограничениями, чем входные файлы (например, при попытке поместить файл объекта ‘ppc970’ в библиотеку ‘ppc7400’). Компоновщик для исполняемых файлов, ld, тихо присваивает исполняемому файлу наиболее жёсткие ограничения любого из его входных файлов.

-Fdir

Добавляет каталог фреймворка dir в начало списка каталогов, которые будут проверяться на наличие заголовочных файлов. Эти каталоги чередуются с каталогами, указанными с помощью опций -I, и сканируются слева направо.

Каталог фреймворка — это каталог, содержащий фреймворки. Фреймворк — это каталог, содержащий каталоги Headers и/или PrivateHeaders непосредственно в нём, заканчивающийся на .framework. Имя фреймворка — это имя этого каталога без .framework. Заголовочные файлы, связанные с фреймворком, находятся в одном из этих двух каталогов, причём Headers проверяются в первую очередь. Подфреймворк — это каталог фреймворка, который находится в каталоге Frameworks фреймворка. Включения заголовочных файлов подфреймворка могут появляться только в заголовочном файле фреймворка, содержащем подфреймворк, или в заголовочном файле подфреймворка-соседа. Два подфреймворка являются соседями, если они встречаются в одном фреймворке. Подфреймворк не должен иметь то же имя, что и фреймворк; если это нарушение происходит, выдаётся предупреждение. В настоящее время подфреймворк не может иметь подфреймворки; в будущем механизм может быть расширен, чтобы поддерживать это. Стандартные фреймворки можно найти в /System/Library/Frameworks и /Library/Frameworks. Пример включения выглядит так #include <Framework/header.h>, где Framework обозначает имя фреймворка, а header.h находится в каталоге PrivateHeaders или Headers.

-iframeworkdir

Как -F, за исключением того, что каталог обрабатывается как системный каталог. Основное различие между этой опцией -iframework и -F состоит в том, что с -iframework компилятор не выдаёт предупреждения о конструкциях, содержащихся в заголовочных файлах, найденных через dir. Эта опция допустима только для языков семейства C.

-gused

Выводить отладочную информацию для символов, которые используются. Для формата отладки stabs это включает -feliminate-unused-debug-symbols. По умолчанию включено.

-gfull

Выводить отладочную информацию для всех символов и типов.

-mmacosx-version-min=version

Самая ранняя версия MacOS X, на которой будет работать этот исполняемый файл, — version. Типичные значения version включают 10.1, 10.2, и 10.3.9.

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

-mkernel

Включить режим разработки ядра. Опция -mkernel устанавливает -static, -fno-common, -fno-use-cxa-atexit, -fno-exceptions, -fno-non-call-exceptions, -fapple-kext, -fno-weak и -fno-rtti, где это применимо. Этот режим также устанавливает -mno-altivec, -msoft-float, -fno-builtin и -mlong-branch для целей PowerPC.

-mone-byte-bool

Переопределить значения по умолчанию для bool, чтобы sizeof(bool)==1. По умолчанию sizeof(bool) равен 4, когда компилируется для Darwin/PowerPC и 1, когда компилируется для Darwin/x86, поэтому эта опция не влияет на x86.

Предупреждение: Переключатель -mone-byte-bool заставляет GCC генерировать код, не совместимый с двоичным кодом, сгенерированным без этого переключателя. Использование этого переключателя может потребовать повторной компиляции всех других модулей в программе, включая системные библиотеки. Используйте этот переключатель для соответствия нестандартной модели данных.

-mfix-and-continue
-ffix-and-continue
-findirect-data

Генерировать код, подходящий для быстрой разработки, например, для возможности для GDB динамически загружать файлы .o в уже запущенные программы. -findirect-data и -ffix-and-continue предоставлены для обратной совместимости.

-all_load

Загружает всех членов статических архивированных библиотек. Для получения дополнительной информации см. страницу руководства ld(1).

-arch_errors_fatal

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

-bind_at_load

Помечает выходной файл таким образом, что динамический компоновщик свяжет все неопределённые ссылки при загрузке или запуске файла.

-bundle

Создаёт файл в формате Mach-o bundle. Для получения дополнительной информации см. страницу руководства ld(1).

-bundle_loader executable

Этот параметр указывает executable, который загрузит файл выходных данных сборки, который связывается. Для получения дополнительной информации см. страницу руководства ld(1).

-dynamiclib

При передаче этой опции GCC создаёт динамическую библиотеку вместо исполняемого файла при компоновке, используя команду Darwin libtool.

-force_cpusubtype_ALL

Это приводит к тому, что выходной файл GCC имеет тип ‘ALL’, вместо типа, контролируемого параметром -mcpu или -march.

-allowable_client client_name
-client_name
-compatibility_version
-current_version
-dead_strip
-dependency-file
-dylib_file
-dylinker_install_name
-dynamic
-exported_symbols_list
-filelist
-flat_namespace
-force_flat_namespace
-headerpad_max_install_names
-image_base
-init
-install_name
-keep_private_externs
-multi_module
-multiply_defined
-multiply_defined_unused
-noall_load
-no_dead_strip_inits_and_terms
-nofixprebinding
-nomultidefs
-noprebind
-noseglinkedit
-pagezero_size
-prebind
-prebind_all_twolevel_modules
-private_bundle
-read_only_relocs
-sectalign
-sectobjectsymbols
-whyload
-seg1addr
-sectcreate
-sectobjectsymbols
-sectorder
-segaddr
-segs_read_only_addr
-segs_read_write_addr
-seg_addr_table
-seg_addr_table_filename
-seglinkedit
-segprot
-segs_read_only_addr
-segs_read_write_addr
-single_module
-static
-sub_library
-sub_umbrella
-twolevel_namespace
-umbrella
-undefined
-unexported_symbols_list
-weak_reference_mismatches
-whatsloaded

Эти параметры передаются компоновщику Darwin. Подробное описание их содержится на странице руководства компоновщика Darwin.

Далее: Опции DEC Alpha, Предыдущая: Опции CR16, Вверх: Опции подмоделей [Оглавление][Индекс]

© Free Software Foundation
Licensed under the GNU Free Documentation License, Version 1.3.
https://gcc.gnu.org/onlinedocs/gcc-7.5.0/gcc/Darwin-Options.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API