3 Опции командной строки GCC ¶

При вызове GCC обычно происходит предварительная обработка, компиляция, ассемблирование и компоновка. «Общие опции» позволяют остановить этот процесс на промежуточной стадии. Например, опция -c указывает на то, что компоновщик не должен запускаться. Тогда выходными данными являются объектные файлы, созданные ассемблером. См. Опции, определяющие тип выходных данных.

Другие опции передаются одному или нескольким этапам обработки. Некоторые опции управляют препроцессором, другие — самим компилятором. Еще другие опции управляют ассемблером и компоновщиком; большинство из них здесь не документированы, так как вы редко их используете.

Большинство опций командной строки, которые можно использовать с GCC, полезны для программ на C; если опция полезна только с другим языком (обычно C++), об этом прямо говорится в описании. Если описание определённой опции не упоминает язык исходного кода, эту опцию можно использовать со всеми поддерживаемыми языками.

Обычный способ запуска GCC — это запуск исполняемого файла gcc, или machine-gcc при кросс-компиляции, или machine-gcc-version для запуска определённой версии GCC. При компиляции программ на C++ следует вызывать GCC как g++ вместо этого. См. Компиляция программ на C++, для получения информации о различиях в поведении между gcc и g++ при компиляции программ на C++.

Программа gcc принимает опции и имена файлов в качестве операндов. Многие опции имеют многобуквенные имена; поэтому несколько однобуквенных опций не могут быть объединены: -dv сильно отличается от «-d -v».

Можно смешивать опции и другие аргументы. В большинстве случаев порядок использования значения не имеет. Порядок имеет значение, когда используется несколько опций одного типа; например, если вы указываете -L более одного раза, каталоги просматриваются в указанном порядке. Также важно расположение опции -l.

Многие опции имеют длинные имена, начинающиеся с ‘-f’ или с ‘-W’ — например, -fmove-loop-invariants, -Wformat и т. д. Большинство из них имеют положительную и отрицательную формы; отрицательная форма -ffoo — -fno-foo. В этом руководстве документирована только одна из этих двух форм, которая не является по умолчанию.

Некоторые опции принимают один или несколько аргументов, обычно отделённых от имени опции пробелом или знаком равенства (‘=’). Если не указано иное, аргумент может быть либо числовым, либо строковым. Числовые аргументы, как правило, должны быть небольшими целыми положительными десятичными или шестнадцатеричными числами. Шестнадцатеричные аргументы должны начинаться с префикса ‘0x’. Аргументы к опциям, которые указывают порог размера какого-либо типа, могут быть произвольно большими десятичными или шестнадцатеричными целыми числами, за которыми следует суффикс единицы измерения размера, обозначающий кратную величину байтов, таких как kB и KiB для килобайта и кибибайта соответственно, MB и MiB для мегабайта и мебибайта, GB и GiB для гигабайта и гибибайта и т. д. Такие аргументы в последующем тексте обозначаются как byte-size. Обратитесь к стандартам NIST, IEC и другим соответствующим национальным и международным стандартам для полного перечня и объяснений двоичных и десятичных префиксов размера байтов.

См. Индекс опций для индекса опций GCC.

• Краткое описание опций
• Опции, определяющие тип выходных данных
• Компиляция программ на C++
• Опции, определяющие диалект C
• Опции, определяющие диалект C++
• Опции, определяющие диалекты Objective-C и Objective-C++
• Опции форматирования сообщений об ошибках
• Опции для запроса или подавления предупреждений
• Опции, управляющие статическим анализом
• Опции отладки программы
• Опции управления оптимизацией
• Опции инструментирования программы
• Опции управления препроцессором
• Передача опций ассемблеру
• Опции компоновки
• Опции для поиска каталогов
• Опции для правил генерации кода
• Опции разработчика GCC
• Машинно-зависимые опции
• Указание подпроцессов и переключателей, которые им нужно передать
• Переменные среды, влияющие на GCC
• Использование предварительно скомпилированных заголовков