Distcc/Cross-Compiling/ru

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

Введение
is a tool that lets you share the burden of software compiling across several networked computers. As long as the networked boxes are all using the same toolchain built for the same processor architecture, no special setup is required.

This guide provides instructions on how to configure distcc to compile for different architectures.

Устанавливаем необходимые утилиты
First, you will need to emerge on all the machines that will be involved in the compiling process. is a tool that makes building cross-architecture toolchains easy. Its usage is straightforward: will build a full cross-toolchain targeting the Sparc architecture. This includes binutils, gcc, glibc, and linux-headers.

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, поскольку символьные ссылки при обновлении перезаписываются. Можно сделать это с помощью файла, примерно такого:

Then create this file:

Give it the proper permissions:

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

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

Troubleshooting
This section covers a number of common problems when using 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. ).

Another solution is to uninstall and re-install compiler tools, using the  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 CFLAGS 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: