.Dd October 12, 2020
.Dt GS-SFTP 1
.Os
.Sh "نام (NAME)"
.Nm gs-sftp
.Nd پروتکل انتقال امن فایل از طریق Global Socket.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm gs-sftp
.Op Fl lTR
.Op Fl s Ar secret
.Op Fl k Ar keyfile
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک اسکریپت پوششی (wrapper) برای gs-netcat است. این ابزار به دو کاربر اجازه می‌دهد تا یک اتصال امن SFTP را از طریق Global Socket Relay Network (GSRN) برقرار کنند. این قابلیت در سناریویی که هر دو کاربر پشت NAT/Firewall هستند و امکان اتصال مستقیم به یکدیگر را ندارند، بسیار کاربردی است.
.Pp
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl s Ar secret
گذرواژه‌ای که توسط کاربر انتخاب می‌شود. هر دو کاربر برای برقراری اتصال باید از یک گذرواژه یکسان استفاده کنند.
.It Fl k Ar FILE
فایلی حاوی گذرواژه.
.It Fl l
حالت کارگزار (server). حالت پیش‌فرض کارخواه (client) است.
.It Fl R
کارگزار (\-l) را در حالت فقط‌خواندنی قرار می‌دهد. تلاش‌ها برای باز کردن فایل‌ها جهت نوشتن، و همچنین سایر عملیاتی که وضعیت سیستم‌فایل را تغییر می‌دهند، رد خواهند شد.
.It Fl T
استفاده از TOR. ابزار
.Nm
از طریق TOR به GSRN متصل خواهد شد. این گزینه نیازمند نصب و در حال اجرا بودن TOR است. IP و PORT سرور TOR را می‌توان با استفاده از متغیرهای محیط تنظیم کرد.
.El
.Pp
برای گزینه‌های بیشتر،
.Xr gs-netcat 1
را ببینید.
.Sh "مثال‌ها (EXAMPLES)"
.Nm مثال ۱
\- گوش دادن سرور SFTP برای کارخواه‌ها با استفاده از گذرواژه \(aqMySecret\(aq:
.Dl $ gs-sftp -s MySecret -l
.Pp
اتصال کارخواه sftp با استفاده از همان گذرواژه:
.Dl $ gs-sftp -s MySecret 
.Pp
.Sh "محیط (ENVIRONMENT)"
برای فهرستی از متغیرهای محیط پشتیبانی‌شده،
.Xr gs-netcat 1
را ببینید.
.Pp
.Sh "همچنین ببینید (SEE ALSO)"
.Xr gsocket 1 ,
.Xr gs-netcat 1 ,
.Xr sftp 1
.Pp
.Sh "گزارش باگ‌ها (BUGS)"
تلاش شده است تا
.Nm
در تمام حالت‌های گوناگون خود «کار درست را انجام دهد». اگر فکر می‌کنید تحت هر شرایطی رفتار نادرستی از خود نشان می‌دهد، لطفاً به من (skyper@thc.org) اطلاع دهید و بگویید که به نظر شما چگونه باید رفتار کند.