Blok funkce FS_SHELL

Blok funkce FS_SHELL vykonává jedno nebo více vzdálených příkazů v interaktivní shell.

Pozor: Systémové příkazy mohou ohrozit nebo poškodit vzdálený systém. Navíc mohou existující soubory být přepsány bez varování.

Souborový systém musí být předtím inicializován pomocí FS_INIT. Všechny operace se provádějí asynchronně pro každé připojené úložné médium.

Vstup RUN

Při kladném okraji je spuštěn uvedený příkaz.

Vstup DEV

Definuje zařízení, ze kterého se má přístupovat ke souborům. Zařízení se používá pro projekt a může být spravováno v kontextovém menu pod Projekt ▸ Externí úložiště.

Vstup PATH

Zadává cestu k adresáři na úložném médiu. Cesta odpovídá Unixové cestě k souboru v UTF-8 formátu, pokud je podporována. Cesta se zobrazuje takto:

Složka/Podsložka

Použití cesty je volitelné. Pokud byla nastavena, musí být úspěšná změna do tohoto adresáře, jinak nebude spuštěn příkaz.

Vstup CMD

Definuje všechny příkazy, které mají být vykonány. Všechny příkazy musí být ukončeny koncem řádku. Například: "ls\n". Pokud není použit konec řádku, bude příkaz pravděpodobně nevykonán. Příkazy jsou vykonávány po řádcích po zpětné vazbě od serveru.

Po provedení všech příkazů by měl být na konci odeslán "exit\n", aby se okamžitě ukončilo spojení a vrátily hodnoty. Poté nesmí být odeslán žádný další příkaz, jinak bude výstup ERROR nastaven na TRUE.

Poznámka: Pokud je spojení neočekávaně ukončeno a příkaz nebyl odeslán, bude výstup ERROR nastaven na TRUE.

Vstup PTY

Definuje typ konzole (Pseudo-Terminal). Pro některá zařízení je tento parametr povinný. Příklady: "vanilla", "exec", "vt100", "vt102", "ansi", "xterm" atd. Pokud není definována žádná hodnota, použije se "vanilla".

Hodnota "exec" provádí požadavek pomocí SSH příkazu z operačního systému. Tím se používají modernější metody. Tato metoda je však trochu méně efektivní. Vstup ENV je nastaven před spojením, proto může být možná ignorován. Vstup SIZE je při této metodě ignorován.

Pokud musí být přenášeny další SSH parametry, mohou být přidány v novém řádku za "exec". Parametry jsou citlivé na velikost písmen a jsou uvedeny jako v následujícím příkladu. Tento příklad aktivuje algoritmus RSA pro starší zařízení.

exec
HostKeyAlgorithms=+ssh-rsa
PubkeyAcceptedAlgorithms=+ssh-rsa

Následující parametry jsou k dispozici:

SSH parametry pro exec Příklad hodnoty
KexAlgorithms +diffie-hellman-group1-sha1
Ciphers +aes128-cbc
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa
ConnectTimeout 10
ServerAliveInterval 30
ServerAliveCountMax 3

Poznámka: Pro další podrobnosti viz externí dokumentace: https://linux.die.net/man/5/ssh_config (Anglicky)

Vstup ENV

Definuje aktivní proměnné prostředí. Aby bylo možné zadat více proměnných, může být každá z nich definována v novém řádku. Příklad:

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

Vstup SIZE

Definuje velikost terminálu. Výchozí hodnota je v znaků, ale může být také definována v pixelech. Například: "80x25" nebo "640x480px". Pokud není definována žádná hodnota, použije se "80x25".

Vstup RECV_PT

Definuje časový limit pro přijímání dat na příkaz ve formátu T#. Pokud není definován žádný časový limit, použije se T#150ms. Pokud tato hodnota není dostatečně vysoká, pravděpodobně budou vykonávány několik příkazů během výstupu dat.

Vstup TIMEOUT

Nastaví časový limit ve formátu T# pro provedení všech příkazů. Po dosažení tohoto limitu je spojení ukončeno a vrácena hodnota. V tomto případě je ERROR nastaven na TRUE. Časový limit je vyhodnocován po navázání spojení a autentizaci. Pokud byl vstup PTY nastaven na "exec", je doba provedení vyhodnocována pro celý časový interval. Pokud není definován žádný časový limit, použije se T#300s.

Výstup DONE

Výstup při úspěchu vrátí impuls, aby se mohla provést další operace. Impuls nastane při ukončení procesu, i když došlo k chybě.

Výstup RETURN

Vrátí výstup příkazu při úspěšném provedení. Hodnota je uložena pro pozdější použití.

Poznámka: Pozor, že konzol formátuje výstup. Proto mohou být zahrnuty i řídící znaky nebo binární data.

Výstup RETERR

Vrátí výstup příkazu při chybném provedení. U SSH také nazývaný STDERR. Hodnota je uložena pro pozdější použití.

Poznámka: Pozor, že konzol formátuje výstup. Proto mohou být zahrnuty i řídící znaky nebo binární data.

Výstup ERROR

V případě chyby vrátí text s chybovou zprávou. Je FALSE, pokud nevyšlo nic špatně. Stav je uložen pro pozdější použití.

Možné příčiny:

  • Služba úložného média nebyla spuštěna.
  • Úložiště nebylo inicializováno.
  • Přihlašovací údaje jsou neplatné.
  • Vzdálený server nebyl dosažen.
  • Úložné médium neexistuje.
  • Zadaná cesta je neplatná.
  • Na úložné médium nelze zapisovat.
  • Žádný volný prostor na úložišti nebo úložiště je chráněno proti zápisu.
  • Spojení bylo neočekávaně ukončeno, než mohly být odeslány všechny příkazy.
  • Bylo dosaženo definovaného časového limitu.

Viz také