ccontrol - Онлайн в облаке

ПРОГРАММА:

ИМЯ

ccontrol - оболочка для управления distcc, ccache и др.

СИНТАКСИС

GCC ...

cc ...

C ++ ...

сделать ...

ld ...

ccontrol [--section = ] ...

ccontrol [--section = ]

ОПИСАНИЕ

Ассоциация ccontrol(1) программа берет на себя роли компилятора и компоновщика и читает
файл конфигурации, чтобы решить, что делать перед их вызовом. Это особенно полезно
для централизованного управления командами и параметрами, такими как включение DistCC(1) и
CCache(1).

После появления ccontrol(1) вызывается под своим именем без аргументов, выводит
настройки, которые применяются в этом каталоге (если --раздел указано).

Версии названы в честь последнего человека, сообщившего об ошибке.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Обычная стоимость ccontrol(1) вызывается как символическая ссылка на cc, make и т. Д., Поэтому он может идентифицировать
что вызывается, исследуя собственное имя. Он также может быть вызван под собственным
name, и в этом случае могут быть указаны аргументы, специфичные для ccontrol. Первый не вариант
аргумент будет использоваться для идентификации вызова, например. "ccontrol gcc ...".

Следующие параметры поддерживаются при вызове как ccontrol:

--section =
Это рассматривается как «текущий каталог» для целей оценки
конфигурационный файл. Поскольку все настоящие каталоги должны начинаться с символа "/" с использованием аргумента
чего нет, это хороший способ переопределить конфигурацию для этого конкретного
призыв.

КОНФИГУРАЦИЯ ФАЙЛОВ

Файл конфигурации ccontrol - это $ HOME / .ccontrol / config. Если это невозможно прочитать (и
написано), все ваши компиляции потерпят неудачу. Наличие нескольких разных
файлы конфигурации в этом каталоге и сделать по умолчанию символическую ссылку.

СИНТАКСИС

Файл конфигурации состоит из разделов, начинающихся с заголовка «[путь]», за которыми следует
записи "имя = значение" с отступом. Первый раздел обычно обозначается «[*]», чтобы настроить
по умолчанию. По крайней мере, вы должны установить значения «cc», «c ++», «make» и «ld».

ccontrol будет читать каждый раздел, соответствующий текущему каталогу, поэтому вы можете переопределить
значения для каждого каталога. Заголовок «[путь]» каждого раздела выполнен в стиле оболочки.
подстановочный знак (см. земной шар(7)), который указывает каталог или каталоги, к которым он относится. Как правило
это будет заканчиваться знаком «*», чтобы включить все подкаталоги.

Все пути, начинающиеся с "~", относятся к домашнему каталогу пользователя. Путь может быть
указан как каталог, и в этом случае ccontrol добавит имя программы в
каталог.

Доступны следующие настройки:

cc
Последовал = указывает путь к компилятору, который будет вызываться, когда ccontrol
вызывается как «cc» или «gcc». ccontrol не сможет компилировать программы на C, если это не установлено.

C ++
Последовал = указывает путь к компилятору, который будет вызываться, когда ccontrol
вызывается как «c» или «g». ccontrol не сможет компилировать программы на C ++, если это не установлено.

ld
Последовал = указывает путь компоновщика, который будет вызываться при вызове ccontrol
как "ld". ccontrol не сможет связывать программы, если он не установлен.

сделать
Последовал = указывает путь к двоичному файлу, который будет вызываться при вызове ccontrol
как «сделать». ccontrol не сможет выполнить, если он не установлен.

CCache
Последовал = указывает путь к "ccache" и указывает, что ccache должен использоваться
где это уместно. Если за ним следует запрещать, или не установлен, ccache не будет использоваться.

DistCC
Последовал = указывает путь к «distcc» и указывает, что будет использоваться distcc.
где это уместно. Если за ним следует запрещать, или не установлен, или distcc-hosts не установлен,
distcc не будет использоваться.

distcc-хосты
Последовал = указывает используемые серверы distcc в соответствии со средой DISTCC_HOSTS
переменная в DistCC(1). С последующим запрещать отключает distcc.

distc ++ - хосты
То же, что и distcc-hosts, но применяется только к компиляциям. Если не установлен, distcc-hosts
используется. Таким образом, вы можете отключить distcc для компиляций C, установив distc ++ - hosts
запрещать".

процессоры
Последовал = и количество процессоров, установленное на количество имеющихся у вас процессоров (по умолчанию
«1»). ccontrol использует это для настройки степени параллелизма.

непараллельный
Последовал = и список подстановочных знаков, разделенных пробелами, подавляет параллельное выполнение для
any make target соответствует одному из них. Эта опция нужна, потому что ccontrol(1)
обычно заставляет сделать(1) выполнять все действия параллельно, но это может сбивать с толку
когда возникает ошибка, и ломает плохо написанные make-файлы. С последующим запрещать,
включает параллельную сборку для всех целей: это полезно для повторного включения параллельной сборки в
подкаталог.

хороший
Последовал = и уровень приоритета от -19 до 20, заставляет ccontrol пытаться установить
приоритет этого значения. По умолчанию 10.

включают
Последовал = указывает файл, который нужно включить в текущую точку. Эффект точно
как если бы содержимое включенного файла было буквально вставлено. Может использоваться в файле
уровень для включения разделов. Также может использоваться внутри разделов для включения раздела
фрагменты.

добавить марку
Последовал = указывает аргумент, добавляемый к каждому вызову сделать, Это может
можно указать несколько раз, чтобы добавить несколько аргументов. С последующим запрещать удаляет любые
аргументы, указанные ранее.

добавить env
Последовал = указывает устанавливаемую переменную среды, например "add env =
CCACHE_DIR =/ Tmp". Это можно указать несколько раз, чтобы задать несколько сред.
переменные. С последующим запрещать удаляет все ранее указанные аргументы.

подробный
Сам по себе указывает на то, что ccontrol(1) выплевывать много дерьма до стандартной ошибки
о том, что он делает с вашей невинной командной строкой.

файл блокировки
Укажите конкретный файл блокировки для использования.

ПРИМЕРЫ

Это минимальный файл конфигурации:

[*]
cc = / usr / bin / gcc
c ++ = / usr / bin / g ++
лд = / usr / bin / ld
сделать = / usr / bin / make

Если у вас есть несколько мест (например, ноутбук), обычно используется «глобальный» файл.
который включен в каждый файл конфигурации, например:

# Файл конфигурации, когда я на работе. Множество хостов distcc!
включить = ~ / .ccontrol / глобальный

[*]
distcc-hosts = snab рой1 рой3 рой4 рой5 фанданго2 минго
distc ++ - hosts = snab mingo

Вот полный файл конфигурации с несколькими распространенными сценариями:

[*]
копия = /usr/bin/gcc-4.0
c ++ = /usr/bin/g++-4.0
лд = / usr / bin / ld
сделать = / usr / bin / make
# Закомментируйте это снова для отладки
# подробный
distcc = / usr / bin / distcc
distcc-hosts = snab рой1 рой3 рой4 рой5 фанданго2 минго
distc ++ - hosts = snab mingo
ccache = / usr / bin / ccache
# make check обычно не следует запускать параллельно
no-parallel = проверить

# Веснот не компилируется с g ++ 4.0
[* веснот *]
c ++ = /usr/bin/g++-3.4

# Глупые сторонние модули не собираются параллельно.
[/ usr / src / modules / *]
без параллели = *

# Использование distcc при тестировании module-init-tools вызывает странные эффекты.
[* модуль-инициализация-инструменты * / тесты / *]
distcc отключить

Используйте ccontrol онлайн с помощью сервисов onworks.net