Функциональный блок FS_EXEC

Функциональный блок FS_EXEC выполняет одно или несколько удаленных команд без оболочки.

Внимание: Системные команды могут угрожать или повредить удаленную систему. Кроме того, уже существующие файлы могут быть перезаписаны без предупреждения.

Файловая система должна быть предварительно инициализирована с помощью FS_INIT. Все операции выполняются асинхронно для каждого созданного носителя.

Вход RUN

При положительном фронте выполняется указанная команда.

Вход DEV

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

Вход PATH

Указывает путь к каталогу на носителе. Путь соответствует пути файла Unix в формате UTF-8, если он поддерживается. Путь представлен следующим образом:

Папка/Подпапка

Использование пути является необязательным. Если он установлен, то переход в этот каталог должен быть успешным, иначе выполняемая команда не будет выполнена.

Вход CMD

Определяет выполняемую команду.

Вход PTY

Определяет тип консоли (псевдотерминал). Для некоторых устройств этот параметр обязателен. Примеры: "vt100", "vt102", "ansi", "xterm" и т.д.

Примечание: Если используется PTY, каждая команда должна завершаться символом новой строки, например: "ls\n". Учтите также, что консоль форматирует вывод. Таким образом, могут содержаться управляющие символы или бинарные данные.

Вход ENV

Определяет активные переменные окружения. Чтобы указать несколько переменных, можно определить по одной на строку. Пример:

LANG=en_US.UTF-8
LC_ALL=en_US.UTF-8

Вход SIZE

Определяет размер терминала. По умолчанию он указывается в символах, но может быть также определен в пикселях. Например: "80x25" или "640x480px". Если значение не определено, используется "80x25".

Выход DONE

Выход возвращает импульс при успехе, чтобы выполнить следующую операцию. Импольс происходит по завершении процесса, даже если произошла ошибка.

Выход RETURN

Возвращает результат команды при успешном выполнении. Значение сохраняется для последующего использования.

Выход RETERR

Возвращает результат команды при ошибочном выполнении. При SSH также называется STDERR. Значение сохраняется для последующего использования.

Выход ERROR

В случае ошибки возвращает текст с сообщением об ошибке. Он FALSE, если ошибка не возникла. Состояние сохраняется для последующего использования.

Возможные причины:

  • Сервис носителя не был запущен.
  • Хранилище не было инициализировано.
  • Данные для входа недействительны.
  • Удаленный сервер недоступен.
  • Носитель не существует.
  • Указанный путь недействителен.
  • На носитель нельзя записать.
  • Нет свободного места на носителе или носитель защищен от записи.

См. также