.Dd October 12, 2020
.Dt BLITZ 1
.Os
.Sh "نام (NAME)"
.Nm blitz
.Nd انتقال امن فایل‌ها بین دو ایستگاه کاری از طریق NAT/دیواره آتش.
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm blitz
.Op Fl lT
.Op Fl s Ar secret
.Op Fl k Ar keyfile
.Op Fl f Ar list
.Op Fl o Ar RSOPT=
.Op Ar files ...
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک اسکریپت پوششی (wrapper script) برای gs-netcat و rsync است. این ابزار امکان ارسال فایل‌ها از یک ایستگاه کاری به ایستگاه کاری دیگر را از طریق شبکه بازپخش سوکت سراسری (GSRN) فراهم می‌کند.
.Pp
یک کاربرد معمول زمانی است که هر دو ایستگاه کاری توسط یک دیواره آتش (Firewall) یا NAT از یکدیگر جدا شده‌اند و قادر به برقراری ارتباط مستقیم بین یکدیگر نیستند.
.Pp
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl l
حالت سرور. حالت پیش‌فرض کلاینت است.
.It Fl s Ar secret
گذرواژه‌ای که توسط کاربر انتخاب شده است. هر دو کاربر برای اتصال باید از یک گذرواژه یکسان استفاده کنند.
.It Fl k Ar FILE
فایلی حاوی گذرواژه.
.It Fl f Ar FILE
خواندن فهرست نام‌های فایل از FILE. اگر FILE برابر \- باشد، فهرست از ورودی استاندارد خوانده خواهد شد.
.It Fl o Ar RSOPT=
گزینه‌های ارسالی به rsync. برای گزینه‌های موجود،
.Xr rsync(1) 
را ببینید.
.It Fl T
استفاده از TOR. ابزار
.Nm
از طریق TOR به GSRN متصل خواهد شد. این گزینه نیازمند نصب و در حال اجرا بودن TOR است. نشانی IP و PORT سرور TOR را می‌توان با استفاده از متغیرهای محیطی تعیین کرد.
.El
.Pp
برای گزینه‌های بیشتر،
.Xr gs-netcat(1)
را ببینید.
.Sh "مثال‌ها (EXAMPLES)"
گوش دادن برای کلاینت‌ها با گذرواژه 'MySecret':
.Dl $ mkdir /tmp/foo && cd /tmp/foo
.Dl $ blitz -s MySecret -l
.Pp
کپی کردن 'file.dat' به /tmp/foo/file.dat روی سرور:
.Dl $ blitz -s MySecret file.dat
.Pp
کپی کردن '/etc/ssh/ssh*config' به /tmp/foo/etc/ssh/ روی سرور:
.Dl $ blitz -s MySecret /etc/ssh/ssh*config
.Pp
همچنین امکان محدود کردن اطلاعات مسیری که به عنوان دایرکتوری‌های ضمنی برای هر مسیر مشخص‌شده فرستاده می‌شود، وجود دارد. شما می‌توانید مانند نمونه زیر، یک نقطه و یک ممیز در مسیر مبدأ درج کنید:
.Pp
.Dl $ blitz -s MySecret /etc/./ssh/ssh*config
فایل‌های دریافت‌شده به جای /tmp/foo/etc/ssh در /tmp/foo/ssh/ ذخیره خواهند شد.
.Pp
کپی بازگشتی و محدود کردن پهنای باند به 10kB/sec:
.Dl $ blitz -s MySecret -o 'RSOPT=--bwlimit=10' /usr/./share
.Pp
کپی کردن کل سیستم‌فایل ریشه:
.Dl $ blitz -s MySecret -o 'RSOPT=-x' /
.Pp
کپی کردن فایل‌های مشخص خوانده‌شده از ورودی استاندارد:
.Dl $ find\ . -name '*.conf' | blitz -s MySecret -f \-
.Pp
اجرای یک سرور همیشگی (دیمن) از طریق TOR:
.Dl $ blitz -s MySecret -l -D -T
.Pp
.Sh "محیط (ENVIRONMENT)"
برای دیدن فهرست متغیرهای محیطی پشتیبانی‌شده،
.Xr gs-netcat(1)
را ببینید.
.Pp
.Sh "همچنین ببینید (SEE ALSO)"
.Xr gsocket(1) ,
.Xr gs-netcat(1) ,
.Xr gs-sftp(1) ,
.Xr gs-mount(1) ,
.Xr rsync(1)
.Pp
.Sh "گزارش باگ‌ها (BUGS)"
تلاش‌های زیادی انجام شده است تا
.Nm
در تمام حالت‌های مختلف خود «کار درست را انجام دهد». اگر احساس می‌کنید تحت هر شرایطی رفتاری نادرست دارد، لطفاً به (skyper@thc.org) اطلاع دهید و بگویید از نظر شما چگونه باید رفتار کند.