3.19.12 Darwin Options ¶

Эти параметры определены для всех архитектур, работающих под операционной системой 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

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

-arch_errors_fatal

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

-bind_at_load

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

-bundle

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

-bundle_loader executable

Этот параметр определяет executable, который загрузит выходной файл сборки, который компонуется. Для получения дополнительной информации см. man 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.