Distcc/Cross-Compiling/ru

Данное руководство покажет, как настроить distcc для кросс-компиляции между различными архитектурами процессоров.

Введение
— это инструмент, который позволяет распределить компиляцию программ по нескольким компьютерам в сети. Если соединенные по сети машины используют один toolchain и имеют одинаковую процессорную архитектуру, то для работы  никаких особенных настроек не потребуется. Но что делать, если нужно компилировать под разные архитектуры на разных компьютерах? Это руководство покажет, как настроить, чтобы компилировать код для разных архитектур.

This guide will show you how to configure  to compile for different architectures.

Устанавливаем необходимые утилиты
Сперва нужно установить  на всех машинах, которые будут вовлечены в процесс компиляции. — это инструмент, облегчающий сборку кросс-платформенных toolchain’ов. Изначально он был написан Joshua Kinard, затем переписан с нуля Mike Frysinger. Использовать его просто:  соберет полный cross-toolchain для архитектуры Sparc. Он включает binutils, gcc, glibc и linux-headers. Если вам понадобится справка, попробуйте запустить. Очевидно, что нужно установить подходящий cross-toolchain на все вспомогательные машины.

You will need to emerge the proper cross-toolchain on all the helper boxes. If you need more help, try running.

Если вы хотите произвести более точную настройку cross-toolchain’а, то вот скрипт, который генерирует команду с точными версиями toolchain-пакетов для сборки на вспомогательных машинах (скрипт нужно запускать на целевой машине).

Затем необходимо установить  на все машины, которые будут вовлечены в процесс. Это включает и машину, на которой будет запущен emerge, и машины с кросс-компиляторами. Посмотрите документацию Gentoo по Distcc для более подробной информации по настройке и использованию.

Подархитектуры Intel x86
Если вы проводите кросс-компиляцию между различными субархитектурами процессоров Intel x86 (например, i586 и i686), то, как и в других случаях, вам нужно собрать полный cross-toolchain для желаемого CHOST, иначе компиляция завершится неудачей. Это потому, что субархитектурам i586 и i686 соответствуют разные CHOST, несмотря на то что обе относятся к "x86". Помните об этом, когда собираете свои cross-toolchain’ы. Если, например, целевая платформа — i586, то потребуется собрать cross-toolchain’ы для i586 на вспомогательных i686-машинах.

SPARC
При использовании  может появиться одна из следующих ошибок:

Если это происходит, попробуйте использовать другую команду:

Настройка distcc для корректной кросс-компиляции
При настройках distcc по умолчанию кросс-компиляция не будет работать как положено. Проблема в том, что многие сборки вызывают просто  вместо полного имени компилятора (например,  ). Когда такая сборка распределяется на вспомогательную машину с distcc, вызывается нативный компилятор вместо вашего абсолютно нового кросс-компилятора.

К счастью, для этой небольшой проблемы существует обходное решение. Все, что требуется, это оберточный скрипт и несколько символьных ссылок на компьютере, с которого вызывается. Будем использовать в качестве примера компьютер архитектуры Sparc. Ниже, где бы вы ни видели текст, подразумевается ваш CHOST (  для AMD64, к примеру). Каталог после первой установки distcc выглядит следующим образом:

Проделаем следующие шаги:

Затем создадим новый скрипт на этой машине. Запустите свой любимый текстовый редактор и создайте файл со следующим текстом, сохранив его как. Помните о том, что CHOST (в данном случае ) нужно заменить на реальный CHOST данного компьютера, т. е. того, на котором будет запускаться emerge.

Далее, сделаем скрипт исполнимым и создадим соответствующие символьные ссылки:

После этого будет выглядеть следующим образом:

Далее нужно позаботиться о том, чтобы обертки оставались доступными после обновлений distcc, поскольку символьные ссылки при обновлении перезаписываются. Можно сделать это с помощью файла, примерно такого:

Поздравляем! Теперь у вас (надеемся) есть работающая установка cross-distcc.

Как это работает
При вызове  проверяет, как его вызвали (например, ,  , и т. п.). Затем, когда distcc распределяет компиляцию на вспомогательную машину, он передает название, с которым был вызван. Далее, демон distcc на вспомогательной машине ищет исполняемый файл с подобным именем. Если он видит только, то будет искать  , что, скорее всего, будет нативным компилятором вспомогательной машины. Это сработает только если на ней такая же архитектура, как и на компьютере, с которого запускался. Когда отправляется полное имя компилятора, (например, ), путаница исключена.

Troubleshooting
This section covers a number of common problems when using distcc for cross-compiling.

Remote host distccd COMPILE ERRORS
When receiving the message  within a remote host's  file, see the above notes concerning specifying the correct architecture name (ie. crossdev -t $TARGET).

Another solution is to uninstall and re-install crossdev compiler tools, using the crossdev --clean option, or ensuring no longer exists, and then completely reinstall the cross compiler.

It might also be wise to edit the remote host's, and ensure the contents of the  variable are similar on all computers or hosts performing compiler operations.

Failed to exec $TARGET-uknown-linux-gnu-gcc: No such file or directory
The wrapper scripts might fail to execute, even with correct permissions:

To resolve this, make sure to have the wrapper script created with the complete name of the architecture target: