.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.TH "putty" "1" "2004\(hy03\(hy24" "PuTTY\ tool\ suite" "PuTTY\ tool\ suite"
.SH "نام (NAME)"
.PP
\fBputty\fP \- کلاینت گرافیکی SSH، Telnet، Rlogin و SUPDUP برای سامانه X
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.nf
\fBputty\fP\ [\ \fIoptions\fP\ ]\ [\ \fIhost\fP\ ]
.fi
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه \fBputty\fP یک کلاینت گرافیکی SSH، Telnet، Rlogin و SUPDUP برای X است. این برنامه یک پورت مستقیم از کلاینت SSH ویندوزی با همین نام است.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های خط فرمانی که توسط \fBputty\fP پشتیبانی می‌شوند عبارتند از:
.IP "\fB\-\-display\fP \fIdisplay\-name\fP"
نمایشگر X را که \fBputty\fP باید در آن باز شود مشخص می‌کند. (توجه داشته باشید که این گزینه دارای دو علامت خط تیره است، در حالی که هیچ‌یک از گزینه‌های دیگر این‌طور نیستند. دلیل این امر اضافه شدن خودکار این گزینه توسط GTK است. پوزش می‌خواهیم.)
.IP "\fB\-fn\fP \fIfont-name\fP"
فونت مورد استفاده برای متن معمولی نمایش‌یافته در ترمینال را مشخص می‌کند. برای مثال، \fB\-fn\ fixed\fP یا \fB\-fn\ "Monospace\ 12"\fP.
.IP "\fB\-fb\fP \fIfont-name\fP"
فونت مورد استفاده برای متن برجسته (bold) نمایش‌یافته در ترمینال را مشخص می‌کند. اگر منبع \fBBoldAsColour\fP روی 1 (پیش‌فرض) تنظیم شده باشد، متن برجسته به جای فونت متفاوت با رنگ‌های متفاوتی نمایش داده می‌شود، بنابراین این گزینه نادیده گرفته خواهد شد. اگر \fBBoldAsColour\fP روی 0 یا 2 تنظیم شده باشد و شما فونت برجسته‌ای تعیین نکنید، \fBputty\fP فونت معمولی را دوباره روی خود چاپ می‌کند (overprint) تا ضخیم‌تر به نظر برسد.
.IP "\fB\-fw\fP \fIfont-name\fP"
فونت مورد استفاده برای نویسه‌های با عرض دوگانه (معمولاً متون چینی، ژاپنی و کره‌ای) نمایش‌یافته در ترمینال را مشخص می‌کند.
.IP "\fB\-fwb\fP \fIfont-name\fP"
فونت مورد استفاده برای نویسه‌های با عرض دوگانه و برجسته (معمولاً متون چینی، ژاپنی و کره‌ای) را مشخص می‌کند. همانند \fB-fb\fP، این گزینه نیز نادیده گرفته می‌شود مگر اینکه منبع \fBBoldAsColour\fP روی 0 یا 2 تنظیم شده باشد.
.IP "\fB\-geometry\fP \fIgeometry\fP"
اندازه ترمینال را بر حسب سطرها و ستون‌های متن مشخص می‌کند. برای اطلاعات بیشتر در مورد نحوِ مشخصات geometry، راهنمای \fBX\fP(\fI7\fP) را ببینید.
.IP "\fB\-sl\fP \fIlines\fP"
تعداد خطوط تاریخچه پیمایش (scrollback) را برای نگهداری در بالای ترمینال مشخص می‌کند.
.IP "\fB\-fg\fP \fIcolour\fP"
رنگ پیش‌زمینه مورد استفاده برای متن معمولی را مشخص می‌کند.
.IP "\fB\-bg\fP \fIcolour\fP"
رنگ پس‌زمینه مورد استفاده برای متن معمولی را مشخص می‌کند.
.IP "\fB\-bfg\fP \fIcolour\fP"
رنگ پیش‌زمینه مورد استفاده برای متن برجسته را مشخص می‌کند، در صورتی که منبع \fBBoldAsColour\fP روی 1 (پیش‌فرض) یا 2 تنظیم شده باشد.
.IP "\fB\-bbg\fP \fIcolour\fP"
رنگ پیش‌زمینه مورد استفاده برای متن برجسته با تصویر معکوس (reverse-video) را مشخص می‌کند، در صورتی که منبع \fBBoldAsColour\fP روی 1 (پیش‌فرض) یا 2 تنظیم شده باشد. (بهتر است این رنگ را نسخه برجسته رنگ پس‌زمینه در نظر بگیرید؛ بنابراین تنها زمانی ظاهر می‌شود که متن \fIبا\fP رنگ پس‌زمینه نمایش داده شود.)
.IP "\fB\-cfg\fP \fIcolour\fP"
رنگ پیش‌زمینه مورد استفاده برای متنی که زیر مکان‌نما قرار گرفته است را مشخص می‌کند.
.IP "\fB\-cbg\fP \fIcolour\fP"
رنگ پس‌زمینه مورد استفاده برای متنی که زیر مکان‌نما قرار گرفته است را مشخص می‌کند. به عبارت دیگر، این رنگ اصلی مکان‌نما است.
.IP "\fB\-title\fP \fItitle\fP"
عنوان اولیه پنجره ترمینال را مشخص می‌کند. (این مقدار تحت کنترل کارساز قابل تغییر است.)
.IP "\fB\-sb\-\fP or \fB+sb\fP"
به \fBputty\fP می‌گوید که نوار پیمایش را نمایش ندهد.
.IP "\fB\-sb\fP"
به \fBputty\fP می‌گوید که نوار پیمایش را نمایش دهد: این گزینه نقطه مقابل \fB\-sb\-\fP است. این حالت پیش‌فرض است: احتمالاً تنها در صورتی نیاز به تعیین صریح آن خواهید داشت که پیش‌فرض را با استفاده از منبع \fBScrollBar\fP تغییر داده باشید.
.IP "\fB\-log\fP \fIlogfile\fP, \fB\-sessionlog\fP \fIlogfile\fP"
این گزینه باعث می‌شود \fBputty\fP تمامی خروجی ترمینال را علاوه بر نمایش در ترمینال، در یک فایل نیز ثبت کند.
.IP "\fB\-sshlog\fP \fIlogfile\fP"

.IP "\fB\-sshrawlog\fP \fIlogfile\fP"
برای اتصالات SSH، این گزینه‌ها موجب می‌شوند \fBputty\fP جزئیات پروتکل را در یک فایل ثبت کند. (برخی از این داده‌ها ممکن است حساس باشند، هرچند به صورت پیش‌فرض تلاش می‌شود تا از ثبت گذرواژه‌های آشکار خودداری شود.)
.RS
.PP
گزینه \fB\-sshlog\fP بسته‌های رمزگشایی‌شده SSH و سایر رویدادها (مواردی که \fB\-v\fP چاپ می‌کند) را ثبت می‌کند. گزینه \fB\-sshrawlog\fP علاوه بر این، داده‌های خام بسته‌های رمزگذاری‌شده را نیز ثبت می‌کند.
.RE
.IP "\fB\-logoverwrite\fP"
اگر \fBputty\fP طوری پیکربندی شده باشد که روی یک فایل لاگ موجود بنویسد، فایل موجود را حذف و رونویسی می‌کند.
.IP "\fB\-logappend\fP"
اگر \fBputty\fP طوری پیکربندی شده باشد که روی یک فایل لاگ موجود بنویسد، داده‌های لاگ جدید را به انتهای فایل موجود اضافه می‌کند.
.IP "\fB\-cs\fP \fIcharset\fP"
این گزینه مجموعه‌نویسه‌ای را مشخص می‌کند که \fBputty\fP باید فرض کند نشست بر پایه آن کار می‌کند. این مجموعه‌نویسه برای تفسیر تمام داده‌های دریافت‌شده از نشست به کار می‌رود و هر ورودی‌ای که تایپ کرده یا در \fBputty\fP جای‌گذاری (paste) کنید، پیش از ارسال به نشست به این مجموعه‌نویسه تبدیل خواهد شد.
.RS
.PP
هر نام مجموعه‌نویسه‌ای که در سرآیند MIME معتبر باشد (و توسط \fBputty\fP پشتیبانی شود) در اینجا نیز معتبر خواهد بود (برای نمونه «\fBISO-8859-1\fP»، «\fBwindows-1252\fP» یا «\fBUTF-8\fP»). همچنین هر کدگذاری نویسه‌ای که در توصیف منطقی فونت X معتبر باشد مجاز است (برای نمونه «\fBibm-cp437\fP»).
.PP
رفتار پیش‌فرض \fBputty\fP استفاده از همان کدگذاری نویسه فونت اصلی خود است. اگر فونت یونی‌کد (\fBiso10646-1\fP) ارائه دهید، به طور پیش‌فرض از مجموعه‌نویسه UTF-8 استفاده خواهد کرد.
.PP
نام‌های مجموعه‌نویسه نسبت به بزرگی و کوچکی حروف حساس نیستند.
.RE
.IP "\fB\-nethack\fP"
به \fBputty\fP دستور می‌دهد تا حالت صفحه‌کلید عددی NetHack را فعال کند، که در آن بخش اعداد صفحه‌کلید کلیدهای جهت‌نمای NetHack یعنی \fBhjklyubn\fP را تولید می‌کند. این ویژگی به شما امکان می‌دهد با بخش اعداد به بازی NetHack بپردازید بدون اینکه نیازی به استفاده از گزینه \fBnumber_pad\fP در NetHack باشد (که مستلزم فشردن «\fBn\fP» پیش از هر شمارش تکرار است). بنابراین می‌توانید با بخش اعداد جابه‌جا شوید و شمارش تکرار را با کلیدهای عددی معمولی وارد نمایید.
.IP "\fB\-help\fP, \fB\-\-help\fP"
پیامی حاوی خلاصه گزینه‌های موجود را نمایش می‌دهد.
.IP "\fB\-pgpfp\fP"
اثر انگشت‌های کلیدهای اصلی PGP مربوط به PuTTY را جهت کمک به تأیید صحت فایل‌های جدید منتشرشده توسط تیم PuTTY نمایش می‌دهد.
.IP "\fB\-load\fP \fIsession\fP"
یک نشست ذخیره‌شده را بر اساس نام بارگیری می‌کند. این قابلیت به شما امکان می‌دهد یک نشست ذخیره‌شده را مستقیماً از خط فرمان بدون نیاز به ورود اولیه به کادر پیکربندی اجرا کنید.
.IP "\fB\-ssh\fP, \fB\-telnet\fP, \fB\-rlogin\fP, \fB\-supdup\fP, \fB\-raw\fP, \fB-ssh-connection\fP, \fB\-serial\fP"
پروتکلی را که \fBputty\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 \fIusername\fP"
نام کاربری مورد استفاده هنگام ورود به کارساز را مشخص می‌کند.
.IP "\fB\-L\fP \fB[\fP\fIsrcaddr\fP\fB:]\fP\fIsrcport\fP\fB:\fP\fIdesthost\fP\fB:\fP\fIdestport\fP"
یک هدایت پورت محلی (local port forwarding) برقرار می‌کند: به \fIsrcport\fP (یا در صورت تعیین، \fIsrcaddr\fP:\fIsrcport\fP) گوش می‌دهد و هر اتصالی را از طریق اتصال SSH به نشانی مقصد \fIdesthost\fP:\fIdestport\fP هدایت می‌کند. تنها در SSH کار می‌کند.
.IP "\fB\-R\fP \fB[\fP\fIsrcaddr\fP\fB:]\fP\fIsrcport\fP\fB:\fP\fIdesthost\fP\fB:\fP\fIdestport\fP"
یک هدایت پورت دوردست (remote port forwarding) برقرار می‌کند: از کارساز SSH می‌خواهد به \fIsrcport\fP (یا در صورت تعیین، \fIsrcaddr\fP:\fIsrcport\fP) گوش دهد و هر اتصالی را از طریق ارتباط SSH بازگرداند تا کلاینت آن‌ها را به نشانی مقصد \fIdesthost\fP:\fIdestport\fP ارسال کند. تنها در SSH کار می‌کند.
.IP "\fB\-D\fP [\fIsrcaddr\fP:]\fIsrcport\fP"
هدایت پورت پویا (dynamic port forwarding) را برقرار می‌کند. کلاینت به \fIsrcport\fP (یا در صورت تعیین، \fIsrcaddr\fP:\fIsrcport\fP) گوش می‌دهد و یک کارساز SOCKS پیاده‌سازی می‌کند. بدین ترتیب می‌توانید برنامه‌های پشتیبانی‌کننده از SOCKS را به این پورت هدایت کنید تا آن‌ها به طور خودکار از اتصال SSH برای تونل کردن تمام اتصالات خود استفاده کنند. تنها در SSH کار می‌کند.
.IP "\fB\-P\fP \fIport\fP"
پورتی را که باید برای اتصال به کارساز استفاده شود مشخص می‌کند.
.IP "\fB\-A\fP, \fB\-a\fP"
فوروارد عامل SSH (SSH agent forwarding) را فعال (\fB\-A\fP) یا غیرفعال (\fB\-a\fP) می‌کند. در حال حاضر این قابلیت تنها با OpenSSH و SSH-1 کار می‌کند.
.IP "\fB\-X\fP, \fB\-x\fP"
فوروارد سامانه X11 را فعال (\fB\-X\fP) یا غیرفعال (\fB\-x\fP) می‌کند.
.IP "\fB\-T\fP, \fB\-t\fP"
تخصیص یک شبه‌ترمینال (pseudo-terminal) در سمت کارساز را فعال (\fB\-t\fP) یا غیرفعال (\fB\-T\fP) می‌کند.
.IP "\fB\-C\fP"
فشرده‌سازی بر پایه zlib را روی اتصال فعال می‌کند.
.IP "\fB\-1\fP, \fB\-2\fP"
نسخه پروتکل SSH را روی 1 یا 2 انتخاب می‌کند.
.IP "\fB-4\fP, \fB-6\fP"
استفاده از IPv4 یا IPv6 را برای اتصالات شبکه اجباری می‌کند.
.IP "\fB\-i\fP \fIkeyfile\fP"
فایل کلید خصوصی برای احراز هویت کاربر. برای کلیدهای SSH-2، این فایل کلید باید در قالب PPK برنامه PuTTY باشد، نه قالب OpenSSH یا موارد دیگر.
.RS
.PP
اگر از یک عامل احراز هویت استفاده می‌کنید، می‌توانید یک کلید \fIعمومی\fP را نیز در اینجا مشخص کنید (در قالب RFC 4716 یا OpenSSH)، تا مشخص شود از کدام کلیدهای عامل باید استفاده گردد.
.RE
.IP "\fB\-noagent\fP"
تلاشی برای استفاده از عامل احراز هویت جهت احراز هویت محلی انجام نمی‌دهد. (این مورد روی فوروارد عامل تأثیری ندارد.)
.IP "\fB\-agent\fP"
امکان استفاده از عامل احراز هویت را فراهم می‌کند. (این گزینه تنها برای نادیده گرفتن تنظیمات ثبت‌شده در یک نشست ذخیره‌شده لازم است.)
.IP "\fB\-no\-trivial\-auth\fP"
اتصال را از هر کارساز SSH که بدون درخواست هرگونه گذرواژه، امضا یا توکن احراز هویت را بپذیرد قطع می‌کند. (ممکن است بخواهید این گزینه را برای کارسازی که همواره انتظار دارید شما را اعتبارسنجی کند فعال کنید؛ به عنوان نمونه جهت اطمینان از اینکه عبارت عبور (passphrase) فایل کلید خود را ناخواسته در یک کارساز به خطر افتاده که اعلان عبارت عبور PuTTY را جعل کرده وارد نکنید.)
.IP "\fB\-hostkey\fP \fIkey\fP"
یک کلید عمومی میزبان قابل قبول را مشخص می‌کند. این گزینه می‌تواند چندین بار مشخص شود؛ هر کلید می‌تواند یک اثر انگشت (\fBSHA256:AbCdE...\fP، \fB99:aa:bb:...\fP و غیره) یا یک بلوک دودویی (blob) کدگذاری‌شده با base64 در قالب یک‌خطی OpenSSH باشد.
.RS
.PP
مشخص کردن این گزینه، مدیریت خودکار کلیدهای میزبان را لغو می‌کند؛ \fIتنها\fP کلید(های) مشخص‌شده در خط فرمان پذیرفته خواهند شد (مگر اینکه یک نشست ذخیره‌شده نیز کلیدهای میزبان را لغو کرده باشد که در این صورت به آن‌ها افزوده می‌شود) و در حافظه موقت (cache) کلیدهای میزبان چیزی نوشته نخواهد شد.
.RE
.IP "\fB\-sercfg\fP \fIconfiguration-string\fP"
پارامترهای پیکربندی پورت سریال را در حالت \fB-serial\fP مشخص می‌کند. مقدار \fIconfiguration-string\fP باید فهرستی از پارامترهای پیکربندی باشد که با کاما از هم جدا شده‌اند، به شرح زیر:
.RS
.IP "\fB\(bu\fP"
هر تک‌رقم از 5 تا 9 تعداد بیت‌های داده (data bits) را تنظیم می‌کند.
.IP "\fB\(bu\fP"
مقادیر «\fB1\fP»، «\fB1.5\fP» یا «\fB2\fP» تعداد بیت‌های توقف (stop bits) را تنظیم می‌کنند.
.IP "\fB\(bu\fP"
هر رشته عددی دیگر به عنوان نرخ باود (baud rate) تفسیر می‌شود.
.IP "\fB\(bu\fP"
یک حرف کوچک انگلیسی توازن (parity) را مشخص می‌کند: «\fBn\fP» برای none (هیچ)، «\fBo\fP» برای odd (فرد)، «\fBe\fP» برای even (زوج)، «\fBm\fP» برای mark و «\fBs\fP» برای space.
.IP "\fB\(bu\fP"
یک حرف بزرگ انگلیسی کنترل جریان (flow control) را مشخص می‌کند: «\fBN\fP» برای none (هیچ)، «\fBX\fP» برای XON/XOFF، «\fBR\fP» برای RTS/CTS و «\fBD\fP» برای DSR/DTR.
.RE
.SH "نشست‌های ذخیره‌شده (SAVED SESSIONS)"
.PP
نشست‌های ذخیره‌شده در زیرپوشه \fB.putty/sessions\fP درون دایرکتوری خانگی شما ذخیره می‌شوند.
.SH "اطلاعات بیشتر (MORE INFORMATION)"
.PP
برای اطلاعات بیشتر درباره PuTTY، احتمالاً بهترین کار مراجعه به دفترچه راهنما در وبگاه زیر است:
.PP
\fBhttps://www.chiark.greenend.org.uk/~sgtatham/putty\fP
.SH "گزارش باگ‌ها (BUGS)"
.PP
این صفحه راهنما چندان کامل نیست.