Spec-Zone.ru › GCC 9

3.18.12 Параметры 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

Загружает все члены статических архивов библиотек. Для получения дополнительной информации см. 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 компоновщику. Подробное описание этих параметров приведено в man-странице Darwin компоновщика.

Далее: Параметры DEC Alpha, Предыдущее: Параметры C-SKY, Наверх: Параметры подмоделей [Содержание][Индекс]

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

Spec-Zone.ru

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