Toimintosarja FS_SHELL

Toimintosarja FS_SHELL suorittaa yhden tai useamman etäkomennon interaktiivisessa shellissä.

Huomio: Järjestelmäkomennot voivat vaarantaa tai vahingoittaa etäjärjestelmää. Lisäksi olemassa olevat tiedostot voidaan ylikirjoittaa ilman varoitusta.

Tiedostojärjestelmän on oltava alustettu aiemmin FS_INIT-toiminnolla. Kaikki operaatiot suoritetaan asynkronisesti jokaiselle luodulle tallennusvälineelle.

Syöte RUN

Positiivisen reunan kohdalla annettu komento suoritetaan.

Syöte DEV

Määrittää laitteen, josta halutaan päästä käsiksi tiettyihin tiedostoihin. Laite käytetään projektin mukaan ja sitä voidaan hallita kontekstivalikosta Projekti ▸ Ulkoinen tallennus.

Syöte PATH

Määrittää polun tallennusvälineen hakemistoon. Polku vastaa Unix-tiedostopolkua UTF-8-muodossa, jos se on tuettu. Polku esitetään seuraavasti:

Kansio/Alikansio

Polun käyttö on valinnainen. Jos se on asetettu, on vaihdon tähän hakemistoon oltava onnistunut, muuten suoritettava komento ei suoriteta.

Syöte CMD

Määrittää kaikki suoritettavat komennot. Kaikki komennot on päättävä rivin loppuun. Esimerkiksi: "ls\n". Jos rivin lopetusta ei käytetä, komento todennäköisesti ei suoriteta. Komennot suoritetaan palvelimen vastauksen jälkeen rivi kerrallaan.

Kaikkien komennojen suorittamisen jälkeen pitää lähettää lopuksi "exit\n", jotta yhteys katkaistaan välittömästi ja arvot palautetaan. Sen jälkeen ei tulisi lähettää enää mitään komentoa, muuten lähtö ERROR asetetaan TRUE.

Huomio: Jos yhteys katkaistaan odottamatta ja komento ei lähetä, lähtö ERROR asetetaan TRUE.

Syöte PTY

Määrittää konsolin tyyppin (Pseudo-Terminal). Joillekin laitteille tämä parametri on pakollinen. Esimerkkejä: "vanilla", "exec", "vt100", "vt102", "ansi", "xterm" jne. Jos arvoa ei määritetä, käytetään "vanilla".

Arvo "exec" suorittaa pyynnön SSH-komennolla käyttöjärjestelmästä. Tällä tavalla käytetään nykyaikaisempia menetelmiä. Tämä menetelmä on kuitenkin hieman vähemmän tehokas. Syöte ENV asetetaan ennen yhteyttä, joten se voi olla mahdollisesti ohitettu. Syöte SIZE ohitetaan tässä menetelmässä.

Jos lisää SSH-parametreja on annettava, ne voidaan lisätä uuteen riviin "exec" jälkeen. Parametrit ovat kirjainkohtaisia ja niitä käytetään seuraavan esimerkin mukaisesti. Tämä esimerkki aktivoi RSA-algoritmin vanhemmille laitteille.

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

Seuraavat parametrit ovat käytettävissä:

SSH-parametrit execille Esimerkkiarvo
KexAlgorithms +diffie-hellman-group1-sha1
Ciphers +aes128-cbc
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa
ConnectTimeout 10
ServerAliveInterval 30
ServerAliveCountMax 3

Huomio: Lisätietoja löytyy ulkoisesta dokumentaatiosta: https://linux.die.net/man/5/ssh_config (Englanti)

Syöte ENV

Määrittää aktiiviset ympäristömuuttujat. Useiden muuttujien määrittämiseksi voidaan määritellä yksi rivi kerrallaan. Esimerkki:

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

Syöte SIZE

Määrittää terminaalin koon. Oletusarvoisesti tämä annetaan merkkeinä, mutta se voi olla myös pikseleissä. Esimerkiksi: "80x25" tai "640x480px". Jos arvoa ei määritetä, käytetään "80x25".

Syöte RECV_PT

Määrittää aikakatkon vastaanottamaan tietoja per komento muodossa T#. Jos aikakatkoa ei määritetä, käytetään T#150ms. Jos tämä arvo on liian matala, useat komennot todennäköisesti suoritetaan tietojen tuoton aikana.

Syöte TIMEOUT

Asettaa aikakatkon muodossa T# kaikkien komennojen suorittamiseen. Kun tämä saavutetaan, yhteys katkaistaan ja arvo palautetaan. Tällöin ERROR asetetaan TRUE. Aikakatko arvioidaan yhdistymisen jälkeen ja tunnistuksen jälkeen. Jos syöte PTY on asetettu "exec", suoritusaika arvioidaan koko ajanjakson aikana. Jos aikakatkoa ei määritetä, käytetään T#300s.

Lähdö DONE

Lähdön palauttaa onnistumisen yhteydessä impulssin seuraavan operaation suorittamiseksi. Impulssi tapahtuu prosessin päättymisen yhteydessä, myös jos virhe on tapahtunut.

Lähdö RETURN

Palauttaa komennon paluuarvon onnistuneen suorituksen jälkeen. Arvo tallennetaan myöhemmin käytettäväksi.

Huomio: Huomaa, että konsoli muotoilee tulostuksen. Tämän vuoksi siinä voi olla myös ohjausmerkkejä tai binääritietoa.

Lähdö RETERR

Palauttaa komennon paluuarvon epäonnistuneen suorituksen jälkeen. SSH:ssä tätä kutsutaan STDERRiksi. Arvo tallennetaan myöhemmin käytettäväksi.

Huomio: Huomaa, että konsoli muotoilee tulostuksen. Tämän vuoksi siinä voi olla myös ohjausmerkkejä tai binääritietoa.

Lähdö ERROR

Palauttaa virhetapauksessa tekstin virheilmoituksella. Tämä on FALSE, jos virhettä ei ole tapahtunut. Tila tallennetaan myöhemmin käytettäväksi.

Mahdolliset syyt:

  • Tallennusvälineen palvelu ei ole käynnistetty.
  • Tallennus ei ole alustettu.
  • Kirjautumistiedot ovat virheellisiä.
  • Etäpalvelinta ei voitu saavuttaa.
  • Tallennusvälinettä ei ole olemassa.
  • Määritetty polku on virheellinen.
  • Tallennusvälineelle ei voi kirjoittaa.
  • Ei enää tallennustilaa tai tallennus on suojattu kirjoituksilta.
  • Yhteys katkaistiin odottamatta ennen kaikkien komennojen lähettämistä.
  • Määritetty aikakatko saavutettiin.

Katso Myös