Документация Engee

Компиляция кода на C в Engee при помощи GCC

Среди встроенных инструментов платформы Engee присутствуют в том числе и средства для работы со сгенерированным кодом. В этом примере мы изучим, как скомпилировать код и вызвать его из скрипта Engee.

Больше о выполнении внешних программ в среде Engee можно узнать из документации.

Инструменты компиляции в Engee

Engee исполняет модели и программы на Unix-совместимом ядре, пользуясь свойственными лишь Engee библиотеками и инструментами. В поставке ядра операционной системы присутствует достаточно сторонних инструментов, что делает возможным создание специфических пользовательских путей разработки и тестирования ПО и моделей.

В Engee инженеры могут использовать множество инструментов из стандартной поставки ядра Unix, например:

  • gcc – компилятор кода на Си

  • g++ – компилятор кода на C++

Кроме этих, в поставке обычно присутствует очень много дополнительных утилит и интерпретаторов для разных языков программирования (python, perl…​).

Выполним следующую ячейку, чтобы узнать версию компилятора gcc (а заодно проверить его работоспособность):

;gcc -v
Using built-in specs.
COLLECT_GCC=gcc
COLLECT_LTO_WRAPPER=/usr/lib/gcc/x86_64-linux-gnu/12/lto-wrapper
OFFLOAD_TARGET_NAMES=nvptx-none:amdgcn-amdhsa
OFFLOAD_TARGET_DEFAULT=1
Target: x86_64-linux-gnu
Configured with: ../src/configure -v --with-pkgversion='Debian 12.2.0-14' --with-bugurl=file:///usr/share/doc/gcc-12/README.Bugs --enable-languages=c,ada,c++,go,d,fortran,objc,obj-c++,m2 --prefix=/usr --with-gcc-major-version-only --program-suffix=-12 --program-prefix=x86_64-linux-gnu- --enable-shared --enable-linker-build-id --libexecdir=/usr/lib --without-included-gettext --enable-threads=posix --libdir=/usr/lib --enable-nls --enable-clocale=gnu --enable-libstdcxx-debug --enable-libstdcxx-time=yes --with-default-libstdcxx-abi=new --enable-gnu-unique-object --disable-vtable-verify --enable-plugin --enable-default-pie --with-system-zlib --enable-libphobos-checking=release --with-target-system-zlib=auto --enable-objc-gc=auto --enable-multiarch --disable-werror --enable-cet --with-arch-32=i686 --with-abi=m64 --with-multilib-list=m32,m64,mx32 --enable-multilib --with-tune=generic --enable-offload-targets=nvptx-none=/build/gcc-12-bTRWOB/gcc-12-12.2.0/debian/tmp-nvptx/usr,amdgcn-amdhsa=/build/gcc-12-bTRWOB/gcc-12-12.2.0/debian/tmp-gcn/usr --enable-offload-defaulted --without-cuda-driver --enable-checking=release --build=x86_64-linux-gnu --host=x86_64-linux-gnu --target=x86_64-linux-gnu
Thread model: posix
Supported LTO compression algorithms: zlib zstd
gcc version 12.2.0 (Debian 12.2.0-14)

На момент создания этого примера, система Engee позволяла пользоваться цепочкой компиляции gcc версии 12.2.0, хотя нам эта команда нужна скорее для отладочных целей – чтобы убедиться, что компилятор установлен и работет.

Компиляция кода в Engee

На всякий случай, перейдем в ту же папку, где расположен этот пример:

cd( @__DIR__ )

В этой демонстрации мы запустим простую программу, которая всего лишь печатает информационное сообщение.

Вот код программы, которую мы будем компилировать и запускать:

#include <stdio.h>

int main (void)
{
  printf ("Hello, world!\n");
  return 0;
}

Чтобы получить исполняемый файл из исходного кода, который находится в файле hello.c, достаточно выполнить следующую команду:

;gcc -Wall hello.c -o hello

В результате в рабочей папке этого примера образовывается исполняемый файл hello, который можно запустить с аргументами из командной строки или из скрипта.

Выполнение скомпилированного кода

Каким образом получить вывод этого кода в скрипте или в командной строке? Первый вариант состоит в том, чтобы выполнить команду в режиме shell. Таким образом можно получить вывод, но не поместить его в переменную.

;./hello
Hello, world!

Аналогично работает команда run, но ее отличие заключается в том, что она создает процесс, исполнением которого можно управлять.

run( `./hello` )
Hello, world!
Process(`./hello`, ProcessExited(0))

Если результат работы скомпилированного файла нужно поместить в переменную, можно воспользоваться командами read или readchomp (этот вариант команды устраняет символы переноса строки):

c = readchomp( `./hello` )
"Hello, world!"

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

Другой вариант состоит в том, чтобы скомпилировать код с ключом -shared, сделать из него библиотеку функций и передавать в него любые бинарные параметры при помощи @ccall.

Наконец, не самый технологичный, но очень надежный вариант состоит в том, чтобы производить обмен данными через файлы, находящиеся в файловом хранилище.

Заключение

В Engee инженеры могут пользоваться как высокоуровневыми инструментами, такими как инспектор данных, интерактивные скрипты и холст для моделирования, так и самыми низкоуровневыми командами ядра операционной системы.