Spec-Zone.ru › GCC 12

3.19.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

Этот параметр указывает исполняемый_файл, который загрузит выходной файл сборки, который идёт на компоновку. См. справку 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-12.2.0/gcc/Darwin-Options.html

Spec-Zone.ru

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