.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.TH "psftp" "1" "2004\(hy03\(hy24" "PuTTY\ tool\ suite" "PuTTY\ tool\ suite"
.SH "نام (NAME)"
.PP
\fBpsftp\fP \- کلاینت تعاملی SFTP (پروتکل انتقال امن فایل)
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.nf
\fBpsftp\fP\ [\fIoptions\fP]\ [\fIuser\fP\fB@\fP]\fIhost\fP
.fi
.SH "توضیحات (DESCRIPTION)"
.PP
\fBpsftp\fP یک کلاینت متنی و تعاملی برای پروتکل SFTP (انتقال امن فایل) مبتنی بر SSH است.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های خط فرمانی که توسط \fBpsftp\fP پشتیبانی می‌شوند عبارتند از:
.IP "\fB-V\fP"
نمایش اطلاعات نسخه و خروج.
.IP "\fB-pgpfp\fP"
نمایش اثرانگشت کلیدهای اصلی PGP مربوط به PuTTY و خروج، جهت کمک به اعتبارسنجی فایل‌های جدید منتشرشده توسط تیم PuTTY.
.IP "\fB-b\fP \fIbatchfile\fP"
استفاده از batchfile مشخص‌شده.
.IP "\fB-bc\fP"
چاپ دستورهای درون batchfile در خروجی.
.IP "\fB-be\fP"
عدم توقف پردازش batchfile هنگام بروز خطا.
.IP "\fB-v\fP"
نمایش پیام‌های پرگو (verbose).
.IP "\fB-load\fP \fIsession\fP"
بارگذاری تنظیمات از نشست (session) ذخیره‌شده.
.IP "\fB-P\fP \fIport\fP"
اتصال به درگاه \fIport\fP.
.IP "\fB\-proxycmd\fP \fIcommand\fP"
به جای برقراری یک اتصال TCP، از \fIcommand\fP به عنوان پراکسی استفاده می‌شود؛ ترافیک شبکه به ورودی و خروجی استاندارد \fIcommand\fP هدایت خواهد شد. \fIcommand\fP باید یک کلمه واحد باشد، بنابراین احتمالاً به نقل‌قول (quoting) توسط پوسته نیاز خواهد داشت.
.RS
.PP
رشته‌های ویژه \fB%host\fP و \fB%port\fP در \fIcommand\fP با نام میزبان و شماره درگاهی که می‌خواهید به آن متصل شوید جایگزین می‌شوند؛ برای داشتن نویسه واقعی \fB%\fP، عبارت \fB%%\fP را وارد کنید.
.PP
دنباله‌های گریز بک‌اسلش نیز پشتیبانی می‌شوند، مانند دنباله \fB\en\fP که با سطر جدید واقعی جایگزین می‌شود؛ برای داشتن بک‌اسلش واقعی، عبارت \fB\e\e\fP را وارد کنید. (ممکن است پوسته نیز نیاز به گریزدهی بیشتری داشته باشد.)
.PP
(برای جزئیات کامل نشانه‌های پشتیبانی‌شده با پیشوند \fB%\fP و بک‌اسلش به راهنمای اصلی PuTTY مراجعه کنید، هرچند بیشتر آن‌ها احتمالاً در این زمینه چندان کاربردی نیستند.)
.RE
.IP "\fB\-preconnectcommand\fP \fIcommand\fP"
مشخص کردن یک دستور خارجی برای اجرا دقیقاً پیش از برقراری اتصال اصلی شبکه. نحو \fIcommand\fP مشابه \fB-proxycmd\fP است.
.IP "\fB-l\fP \fIuser\fP"
تنظیم نام کاربری دوردست روی \fIuser\fP.
.IP "\fB-batch\fP"
غیرفعال‌سازی اعلان‌های تعاملی.
.IP "\fB-no-sanitise-stderr\fP"
به طور پیش‌فرض، PSFTP نویسه‌های کنترلی را از کانال خطای استاندارد سرور فیلتر می‌کند تا از ارسال توالی‌های گریز سردرگم‌کننده توسط فرآیندهای دوردست جلوگیری کند. این گزینه اجبار می‌کند که کانال خطای استاندارد فیلتر نشود.
.IP "\fB-pwfile\fP \fIfilename\fP"
باز کردن فایل مشخص‌شده و استفاده از نخستین سطر متنی خوانده‌شده از آن به عنوان گذرواژه دوردست.
.IP "\fB-pw\fP \fIpassword\fP"
تنظیم گذرواژه دوردست روی \fIpassword\fP. \fIهشدار:\fP این کار احتمالاً گذرواژه را برای سایر کاربران سیستم محلی (از طریق دستورهایی مانند \*(Aq\fBps\fP\*(Aq یا \*(Aq\fBw\fP\*(Aq) قابل مشاهده می‌کند. به جای آن از \fB-pwfile\fP استفاده کنید.
.IP "\fB-1\fP"
اجبار به استفاده از نسخه ۱ پروتکل SSH.
.IP "\fB-2\fP"
اجبار به استفاده از نسخه ۲ پروتکل SSH.
.IP "\fB-ssh-connection\fP"
اجبار به استفاده از پروتکل \*(Aqbare \fBssh-connection\fP\*(Aq. این مورد تنها هنگام اتصال به سرور \fBpsusan\fP(\fI1\fP) کاربرد دارد، که به احتمال زیاد با یک مسیر مطلق به یک سوکت دامنه یونیکس (Unix-domain socket) به جای \fIhost\fP استفاده می‌شود.
.IP "\fB-ssh\fP"
اجبار به استفاده از پروتکل SSH. (این مورد معمولاً مورد نیاز نیست؛ تنها در صورتی کاربرد دارد که بخواهید پیکربندی دیگری از پروتکل \*(Aqbare \fBssh-connection\fP\*(Aq را بازنویسی کنید.)
.IP "\fB-4\fP, \fB-6\fP"
اجبار به استفاده از IPv4 یا IPv6 برای اتصالات شبکه.
.IP "\fB-C\fP"
فعال‌سازی فشرده‌سازی SSH.
.IP "\fB-i\fP \fIkeyfile\fP"
فایل کلید خصوصی برای احراز هویت کاربر. برای کلیدهای SSH-2، این فایل کلید باید در قالب PPK مربوط به PuTTY باشد، نه در قالب OpenSSH یا موارد دیگر.
.RS
.PP
اگر از یک عامل احراز هویت (authentication agent) استفاده می‌کنید، می‌توانید در اینجا یک کلید \fIعمومی\fP (در قالب RFC 4716 یا OpenSSH) مشخص کنید تا تعیین شود از کدام کلیدِ عامل استفاده شود.
.RE
.IP "\fB\-noagent\fP"
عدم تلاش برای استفاده از عامل احراز هویت.
.IP "\fB\-agent\fP"
اجازه دادن به استفاده از عامل احراز هویت. (این گزینه تنها برای بازنویسی تنظیمات در یک نشست ذخیره‌شده لازم است.)
.IP "\fB\-no\-trivial\-auth\fP"
قطع اتصال از هر سرور SSH که احراز هویت را بدون درخواست هرگونه گذرواژه، امضا یا توکن بپذیرد. (ممکن است بخواهید این گزینه را برای سروری فعال کنید که انتظار دارید همواره شما را به چالش بکشد؛ مثلاً برای اطمینان از اینکه عبارت عبور فایل کلید خود را تصادفاً در سروری نفوذیافته که اعلان عبارت عبور PSFTP را جعل می‌کند، وارد نکنید.)
.IP "\fB\-hostkey\fP \fIkey\fP"
مشخص کردن یک کلید عمومی قابل‌قبول برای میزبان. این گزینه می‌تواند چندین بار مشخص شود؛ هر کلید می‌تواند اثرانگشت (\fBSHA256:AbCdE...\fP، \fB99:aa:bb:...\fP و غیره) یا یک داده حجیم کدگذاری‌شده با base64 در قالب یک‌خطی OpenSSH باشد.
.RS
.PP
مشخص کردن این گزینه، مدیریت خودکار کلیدهای میزبان را لغو می‌کند؛ \fIتنها\fP کلید(های) مشخص‌شده در خط فرمان پذیرفته خواهند شد (مگر اینکه یک نشست ذخیره‌شده نیز کلیدهای میزبان را بازنویسی کند، که در این صورت به آن‌ها افزوده می‌شوند)، و حافظه نهان کلید میزبان نوشته نخواهد شد.
.RE
.IP "\fB\-sshlog\fP \fIlogfile\fP"

.IP "\fB\-sshrawlog\fP \fIlogfile\fP"
این گزینه‌ها باعث می‌شوند \fBpsftp\fP جزئیات پروتکل را در یک فایل لاگ ثبت کند. (برخی از این اطلاعات ممکن است حساس باشند، هرچند به طور پیش‌فرض تلاش می‌شود از نمایش گذرواژه‌های آشکار جلوگیری شود.)
.RS
.PP
گزینه \fB\-sshlog\fP بسته‌های رمزگشایی‌شده SSH و سایر رویدادها (مواردی که با \fB\-v\fP چاپ می‌شوند) را ثبت می‌کند. گزینه \fB\-sshrawlog\fP علاوه بر آن، داده‌های خام بسته رمزگذاری‌شده را نیز ثبت می‌کند.
.RE
.IP "\fB\-logoverwrite\fP"
اگر PSFTP به گونه‌ای پیکربندی شده باشد که روی یک فایل لاگ موجود بنویسد، فایل موجود را دور می‌ریزد (بازنویسی می‌کند).
.IP "\fB\-logappend\fP"
اگر PSFTP به گونه‌ای پیکربندی شده باشد که روی یک فایل لاگ موجود بنویسد، داده‌های لاگ جدید را به فایل موجود ضمیمه می‌کند.
.SH "دستورات (COMMANDS)"
.PP
برای مشاهده فهرست دستورهای موجود در \fBpsftp\fP، دستور \fBhelp\fP را در اعلان \fBpsftp>\fP وارد کنید.
.SH "اطلاعات بیشتر (MORE INFORMATION)"
.PP
برای اطلاعات بیشتر در مورد \fBpsftp\fP احتمالاً بهتر است به راهنمای موجود در صفحه وب PuTTY مراجعه کنید:
.PP
\fBhttps://www.chiark.greenend.org.uk/~sgtatham/putty\fP
.SH "گزارش باگ‌ها (BUGS)"
.PP
این صفحه راهنما چندان کامل نیست. برای مستندات بهتر، پیوند وب بالا را ببینید.