FS_SHELL İş Bloku

FS_SHELL İş Bloku, bir veya daha fazla uzak komutu etkileşimli bir kabukta çalıştırır.

Dikkat: Sistem komutları uzak sistemi tehlikeye atmak veya zarar verebilir. Ayrıca, uyarı olmadan mevcut dosyalar üzerine yazılabilir.

Dosya sistemi önce FS_INIT kullanılarak başlatılmış olmalıdır. Tüm işlemler asenkron olarak her oluşturulan depolama aracına göre gerçekleştirilir.

RUN Girişi

Bir pozitif kenarda belirtilen komut çalıştırılır.

DEV Girişi

Belirtilen aygıttan hangi dosyalara erişileceğini tanımlar. Aygıt proje başına kullanılır ve Proje ▸ Dış Depolama konumunda sağ tıklama menüsünden yönetilebilir.

PATH Girişi

Depolama aracındaki dizine giden yolu belirtir. Yol, desteklendiği durumda bir Unix dosya yoluna karşılık gelir ve UTF-8 formatında gösterilir:

Dizin/Altdizin

Bir yolun kullanılması isteğe bağlıdır. Eğer ayarlanmışsa, bu dizine geçiş başarılı olmalıdır, aksi takdirde çalıştırılacak komut yürütülmez.

CMD Girişi

Çalıştırılacak tüm komutları tanımlar. Tüm komutlar bir satır sonu ile sonlandırılmalıdır. Örneğin: "ls\n". Eğer bir satır sonu kullanılırsa, komut muhtemelen yürütülmez. Komutlar sunucudan geri bildirim alınmasının ardından satır satır yürütülür.

Tüm komutların çalıştırılmasının ardından, bağlantıyı hemen sonlandırmak ve değerleri döndürmek için bir "exit\n" gönderilmelidir. Ardından başka bir komut gönderilmesin, çünkü ERROR çıkışı TRUE olarak ayarlanır.

Not: Eğer bağlantı beklenmedik şekilde sonlandırılır ve bir komut gönderilmezse, ERROR çıkışı TRUE olarak ayarlanır.

PTY Girişi

Konsol türü (Sanal Terminal) tanımlar. Bazı aygıtlar için bu parametre zorunludur. Örnekler: "vanilla", "exec", "vt100", "vt102", "ansi", "xterm" vb. Eğer bir değer tanımlanmazsa, varsayılan olarak "vanilla" kullanılır.

"exec" değeri SSH komutu aracılığıyla işletim sisteminden talep eder. Bu sayede daha modern yöntemler kullanılabilir. Ancak bu yöntem biraz daha verimsizdir. ENV girişi bağlantıdan önce ayarlanır, bu nedenle muhtemelen göz ardı edilirse de. SIZE girişi bu yöntemde göz ardı edilir.

Eğer ek SSH parametreleri iletilmesi gerekirse, bunlar her biri yeni bir satırda "exec" sonrası eklenebilir. Parametreler büyük/küçük harfe duyarlıdır ve aşağıdaki örnekte belirtilen şekilde verilir. Bu örnek, eski aygıtlar için RSA algoritmasını etkinleştirir.

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

Aşağıda kullanılan SSH parametreleri:

exec için SSH Parametreleri Örnek Değer
KexAlgorithms +diffie-hellman-group1-sha1
Ciphers +aes128-cbc
HostKeyAlgorithms +ssh-rsa
PubkeyAcceptedAlgorithms +ssh-rsa
ConnectTimeout 10
ServerAliveInterval 30
ServerAliveCountMax 3

Not: Daha fazla ayrıntı için lütfen dış belgelendirmeye bakınız: https://linux.die.net/man/5/ssh_config (İngilizce)

ENV Girişi

Aktif çevre değişkenlerini tanımlar. Birden fazla değişkene ihtiyacınız varsa, her birini yeni bir satırda tanımlayabilirsiniz. Örnek:

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

SIZE Girişi

Terminalin boyutunu tanımlar. Varsayılan olarak karakter cinsinden belirtilir, ancak piksel olarak da tanımlanabilir. Örneğin: "80x25" veya "640x480px". Eğer bir değer tanımlanmazsa, varsayılan olarak "80x25" kullanılır.

RECV_PT Girişi

T# formatında her komut için verilerin alınması için bir zaman aşımını tanımlar. Eğer bir zaman aşımı tanımlanmazsa, varsayılan olarak T#150ms kullanılır. Bu değer yeterli değilse, muhtemelen veriler çıktıyı verirken birkaç komut yürütülür.

TIMEOUT Girişi

T# formatında tüm komutların çalıştırılması için bir zaman aşımı ayarlar. Bu zaman aşımına ulaşıldığında bağlantı sonlandırılır ve değeri döndürülür. Bu durumda ERROR TRUE olarak ayarlanır. Zaman aşımı, bağlantının kurulması ve kimlik doğrulaması tamamlandıktan sonra değerlendirilir. Eğer PTY girişi "exec" olarak ayarlanmışsa, yürütme süresi tüm süre için değerlendirilir. Eğer bir zaman aşımı tanımlanmazsa, varsayılan olarak T#300s kullanılır.

DONE Çıkışı

Başarılı olduğunda çıkış, bir sonraki işlemi gerçekleştirmek için bir impuls döndürür. Impuls, hatanın oluştuğu durumda bile işlem tamamlandığında gerçekleşir.

RETURN Çıkışı

Komutun başarılı bir şekilde yürütülmesi durumunda geri dönüş değerini döndürür. Değer daha sonra kullanılmak üzere saklanır.

Not: Lütfen konsolun çıktısını biçimlendirdiğini unutmayın. Bu nedenle kontrol karakterleri veya ikili veriler de içerebilir.

RETER Çıkışı

Komutun başarısız bir şekilde yürütülmesi durumunda geri dönüş değerini döndürür. SSH'de bu STDERR olarak da bilinir. Değer daha sonra kullanılmak üzere saklanır.

Not: Lütfen konsolun çıktısını biçimlendirdiğini unutmayın. Bu nedenle kontrol karakterleri veya ikili veriler de içerebilir.

ERROR Çıkışı

Hata durumunda bir hata mesajı içeren metin döndürür. Bu FALSE ise, herhangi bir hata oluştuğu anlamına gelir. Durum daha sonra kullanılmak üzere saklanır.

Mümkün nedenler:

  • Depolama aracının hizmeti başlatılmamış.
  • Depolama başlatılmamış.
  • Giriş bilgileri geçersiz.
  • Uzak sunucuya ulaşılamadı.
  • Depolama araç mevcut değil.
  • Belirtilen yol geçersiz.
  • Depolama aracına yazılamaz.
  • Depolamada yer kalmamış veya depolama yazma koruması altındadır.
  • Tüm komutların gönderilmesi öncesinde bağlantı beklenmedik şekilde sonlandırıldı.
  • Tanımlanan zaman aşımı ulaşıldı.

Bakınız