.TH vncviewer 1 "" "TigerVNC" "Virtual Network Computing" .SH "نام (NAME)" vncviewer \- نمایشگر VNC برای سامانه پنجره X .SH "خلاصه دستور (SYNOPSIS)" .B vncviewer .RI [ options ] .RI [ host ][: display# ] .br .B vncviewer .RI [ options ] .RI [ host ][:: port ] .br .B vncviewer .RI [ options ] .RI [ unix\ socket ] .br .B vncviewer .RI [ options ] .B \-listen .RI [ port ] .br .B vncviewer .RI [ options ] .RI [ .tigervnc\ file ] .SH "توضیحات (DESCRIPTION)" دستور .B vncviewer یک نمایشگر (کلاینت) برای Virtual Network Computing است. این صفحه راهنما نسخهٔ ۴ را برای سامانه پنجره X مستند می‌کند. اگر نمایشگر را بدون هیچ آرگومانی اجرا کنید، از شما یک سرور VNC برای اتصال درخواست می‌کند. همچنین می‌توانید سرور VNC را به عنوان یک آرگومان مشخص کنید، مانند: .RS vncviewer snoopy:2 .RE که در آن \(aqsnoopy\(aq نام رایانه، و \(aq2\(aq شماره نمایشگر سرور VNC بر روی آن رایانه است. می‌توان نام رایانه یا شماره نمایشگر را حذف کرد. بنابراین برای نمونه \(lq:1\(rq به معنای نمایشگر شمارهٔ ۱ روی همان رایانه است، و \(lqsnoopy\(rq به معنای \(lqsnoopy:0\(rq یعنی نمایشگر ۰ روی رایانهٔ \(lqsnoopy\(rq است. به عنوان روش سریع دیگری برای آغاز اتصال به یک سرور VNC، یک فایل پیکربندی \&.tigervnc را به عنوان آرگومان به نمایشگر مشخص کنید، مانند: .RS vncviewer ./some.tigervnc .RE که در آن \(aq./some.tigervnc\(aq یک فایل پیکربندی معتبر و موجود TigerVNC است. نام فایل باید شامل یک جداکنندهٔ مسیر باشد. گزینه‌های اضافی را نیز می‌توان مشخص کرد، اما فایل پیکربندی ارائه‌شده هرگونه پارامتر دارای تداخل را بازنویسی خواهد کرد. اگر ارتباط با سرور VNC با موفقیت برقرار شود، برای احراز هویت از شما گذرواژه درخواست خواهد شد. همچنین می‌توانید \(aqVNC_USERNAME\(aq و \(aqVNC_PASSWORD\(aq را به متغیرهای محیطی اضافه کنید. در صورت درست بودن گذرواژه، پنجره‌ای باز می‌شود که میزکار سرور VNC را نمایش می‌دهد. .SH "انتخاب خودکار پروتکل (AUTOMATIC PROTOCOL SELECTION)" نمایشگر سرعت اتصال به سرور را بررسی کرده و کدگذاری و قالب پیکسل (سطح رنگ) را به طور مناسب انتخاب می‌کند. این ویژگی استفاده از برنامه را بسیار ساده‌تر از نسخه‌های پیشین می‌سازد که در آن‌ها کاربر مجبور بود آرگومان‌های مبهم و پیچیده‌ای را در خط فرمان تعیین کند. نمایشگر معمولاً با این فرض آغاز به کار می‌کند که اتصال کند است، بنابراین از کدگذاری با بهترین میزان فشرده‌سازی استفاده می‌کند. اگر مشخص شود که سرعت اتصال به اندازه کافی بالا است، به کدگذاری دیگری تغییر وضعیت می‌دهد که فشرده‌سازی کمتری دارد اما پردازش آن سریع‌تر است، و در نتیجه تعامل روان‌تری فراهم می‌کند. نمایشگر در حالت عادی در حالت تمام‌رنگی آغاز به کار می‌کند، اما در صورت ناکافی بودن پهنای باند به حالت کم‌رنگ تغییر وضعیت می‌دهد. با این حال، این تغییر تنها هنگام ارتباط با سرورهایی رخ می‌دهد که از نسخهٔ پروتکل 3.8 یا جدیدتر پشتیبانی می‌کنند، زیرا بسیاری از سرورهای قدیمی توانایی تغییر ایمن حالت رنگ را ندارند. انتخاب خودکار را می‌توان با تنظیم پارامتر \fBAutoSelect\fP روی مقدار false یا از طریق کادر گفتگوی گزینه‌ها غیرفعال کرد. .SH "میان‌برهای صفحه‌کلید (KEYBOARD SHORTCUTS)" نمایشگر را می‌توان با کلیدهای ترکیبی مشخصی کنترل کرد که به جای ارسال رویدادهای صفحه‌کلید به نشست راه‌دور، اقدامات ویژه‌ای را فراخوانی می‌کنند. به طور پیش‌فرض فشردن Ctrl+Alt به همراه کلیدی دیگر به عنوان میان‌بر صفحه‌کلید برای نمایشگر تفسیر می‌شود، اما این رفتار را می‌توان با استفاده از پارامتر \fBShortcutModifiers\fP تغییر داد. میان‌برهای ممکن برای صفحه‌کلید عبارتند از: .TP Ctrl+Alt کنترل صفحه‌کلید را رها می‌کند و اجازه می‌دهد از کلیدهای سیستمی به صورت محلی استفاده شود. . .TP Ctrl+Alt+G کنترل صفحه‌کلید را در دست می‌گیرد و اجازه می‌دهد کلیدهای سیستمی (مانند Alt+Tab) به نشست راه‌دور فرستاده شوند. . .TP Ctrl+Alt+Enter حالت تمام‌صفحه را فعال یا غیرفعال می‌کند. . .TP Ctrl+Alt+M یک منوی بازشو (popup) باز می‌کند که می‌تواند اقدامات اضافی گوناگونی مانند خروج از نمایشگر یا باز کردن کادر گفتگوی گزینه‌ها را انجام دهد. . .TP Ctrl+Alt+Space میان‌برهای صفحه‌کلید را موقتاً نادیده می‌گیرد و اجازه می‌دهد همان کلیدهای ترکیبی به نشست راه‌دور فرستاده شوند. ..SH "حالت تمام‌صفحه (FULL-SCREEN MODE)" حالت تمام‌صفحه پشتیبانی می‌شود. این قابلیت به‌ویژه هنگام اتصال به یک صفحه‌نمایش دوردست که هم‌اندازهٔ صفحه‌نمایش محلی شماست مفید است. اگر صفحه‌نمایش دوردست بزرگ‌تر باشد، می‌توانید با حرکت دادن موش و برخورد آن به لبه‌های صفحه، تصویر را پیمایش کنید. .SH "گزینه‌ها (پارامترها) (OPTIONS (PARAMETERS))" می‌توانید با دادن \fB\-h\fP به‌عنوان یک گزینهٔ خط فرمان به vncviewer، فهرستی از پارامترها را دریافت کنید. پارامترها را می‌توان با -\fIparam\fP فعال یا با -\fIparam\fP=0 غیرفعال کرد. پارامترهایی که مقدار می‌پذیرند را می‌توان به صورت -\fIparam\fP \fIvalue\fP مشخص نمود. دیگر قالب‌های معتبر عبارتند از \fIparam\fP\fB=\fP\fIvalue\fP -\fIparam\fP=\fIvalue\fP --\fIparam\fP=\fIvalue\fP. نام پارامترها به بزرگی یا کوچکی حروف حساس نیستند. بسیاری از پارامترها همچنین می‌توانند به صورت گرافیکی از طریق کادر گفتگوی گزینه‌ها تنظیم شوند. این کادر از طریق منوی بالاپر (popup) یا از کادر گفتگوی «Connection details» در دسترس است. .TP .B \-AcceptClipboard پذیرش تغییرات کلیپ‌بورد از سرور. پیش‌فرض فعال است. . .TP .B \-AlertOnFatalError نمایش یک کادر گفتگو در صورت بروز هرگونه خطای مهلک پیش از خروج. پیش‌فرض فعال است. . .TP .B \-AlwaysCursor نمایش نشانگر محلی هنگامی که سرور یک نشانگر نامرئی ارسال می‌کند. پیش‌فرض غیرفعال است. . .TP .B \-AutoSelect استفاده از انتخاب خودکار کدگذاری و قالب پیکسل (پیش‌فرض فعال است). معمولاً نمایشگر سرعت اتصال به سرور را می‌سنجد و کدگذاری و قالب پیکسل مناسب را انتخاب می‌کند. با \fB-AutoSelect=0\fP آن را غیرفعال کنید. . .TP .B \-CompressLevel \fIlevel\fP استفاده از سطح مشخص‌شده برای فشرده‌سازی بدون‌اتلاف. 0 = کم، 9 = زیاد. پیش‌فرض 2 است. . .TP .B \-CursorType \fItype\fP تعیین نوع نشانگر برای زمانی که نشانگر محلی نمایش داده می‌شود. باید «Dot» یا «System» باشد. در صورت غیرفعال بودن AlwaysCursor نادیده گرفته می‌شود. پیش‌فرض «Dot» است. . .TP .B \-CustomCompressLevel استفاده از سطح فشرده‌سازی سفارشی مطابق آنچه توسط \fBCompressLevel\fP مشخص شده است. پیش‌فرض غیرفعال است. . .TP .B \-DesktopSize \fIwidth\fPx\fIheight\fP کلاینت به جای حفظ اندازهٔ موجود صفحه‌نمایش دوردست، هنگام اتصال تلاش می‌کند به اندازهٔ مشخص‌شده تغییر کند. اگر سرور از پیام SetDesktopSize پشتیبانی نکند، صفحه‌نمایش اندازهٔ اصلی خود را حفظ خواهد کرد. . .TP .B \-display \fIXdisplay\fP مشخص کردن نمایشگر X که پنجرهٔ TigerVNC باید در آن نمایان شود. . .TP .B \-DotWhenNoCursor (DEPRECATED) (منسوخ‌شده) نمایش نشانگر نقطه‌ای هنگامی که سرور نشانگر نامرئی می‌فرستد. با \fB-AlwaysCursor\fP و \fB-CursorType=Dot\fP جایگزین شده است. . .TP .B \-EmulateMiddleButton شبیه‌سازی کلید وسط موش با فشردن هم‌زمان کلیدهای چپ و راست موش. پیش‌فرض غیرفعال است. . .TP .B \-FullColor, \-FullColour به سرور VNC اعلام می‌کند که پیکسل‌های تمام‌رنگ را در بهترین قالب برای این نمایشگر ارسال کند. این حالت پیش‌فرض است. . .TP .B \-FullScreen راه‌اندازی در حالت تمام‌صفحه. . .TP .B \-FullScreenAllMonitors (DEPRECATED) (منسوخ‌شده) استفاده از همهٔ نمایشگرهای محلی به جای فقط نمایشگر فعلی هنگام رفتن به حالت تمام‌صفحه. با \fB-FullScreenMode=all\fP جایگزین شده است. . .TP .B \-FullScreenMode \fImode\fP مشخص کردن این‌که کدام نمایشگرها در حالت تمام‌صفحه استفاده شوند. مقدار باید یکی از «Current»، «Selected» (مشخص‌شده توسط \fB-FullScreenSelectedMonitors\fP) یا «All» باشد. پیش‌فرض «Current» است. . .TP .B \-FullScreenSelectedMonitors \fImonitors\fP این گزینه نمایشگرهای مورد استفاده همراه با \fB-FullScreenMode=selected\fP را مشخص می‌کند. نمایشگرها بر اساس پیکربندی سیستم از چپ به راست، و در صورت وجود تداخل، از بالا به پایین مرتب می‌شوند. بنابراین برای مثال «1,2,3» بدین معناست که نمایشگرهای اول، دوم و سوم با شمارش از چپ باید استفاده شوند. پیش‌فرض «1» است. . .TP .B \-FullscreenSystemKeys تسخیر خودکار تمام ورودی‌های صفحه‌کلید هنگام ورود به حالت تمام‌صفحه و ارسال مستقیم کلیدهای ویژه (مانند Alt+Tab) به سرور. . .TP .B \-geometry \fIgeometry\fP موقعیت اولیهٔ پنجرهٔ اصلی TigerVNC. قالب به این صورت است: .B \fIwidth\fPx\fIheight\fP+\fIxoffset\fP+\fIyoffset\fP ، که در آن علامت‌های «+» را می‌توان با علامت‌های «\-» جایگزین کرد تا فاصله از سمت راست و/یا از پایین صفحه تعیین شود. این فاصله‌ها اختیاری هستند و پنجره به طور پیش‌فرض توسط مدیر پنجره جای‌گذاری می‌شود. . .TP .B \-GnuTLSPriority \fIpriority\fP رشتهٔ اولویت GnuTLS که الگوریتم‌های دست‌تکانی نشست TLS را کنترل می‌کند. برای مقادیر ممکن به راهنمای GnuTLS مراجعه کنید. پیش‌فرض \fBNORMAL\fP است. . .TP .B \-listen \fI[port]\fP باعث می‌شود vncviewer روی درگاه مشخص‌شده (پیش‌فرض 5500) برای اتصالات معکوس از سوی سرور VNC گوش فرادهد. WinVNC از اتصالات معکوس که با استفاده از گزینهٔ منوی «Add new client» یا گزینهٔ خط فرمان «\-connect» آغاز می‌شوند پشتیبانی می‌کند. Xvnc از اتصالات معکوس به کمک برنامه‌ای به نام .B vncconfig پشتیبانی می‌کند. . .TP .B \-Log \fIlogname\fP:\fIdest\fP:\fIlevel\fP[, ...] تنظیمات گزارش اشکال‌زدایی (debug log) را پیکربندی می‌کند. \fIdest\fP در حال حاضر می‌تواند \fBstderr\fP یا \fBstdout\fP باشد، و \fIlevel\fP مقداری بین 0 تا 100 است که 100 به معنای پرجزئیات‌ترین خروجی است. \fIlogname\fP معمولاً \fB*\fP به معنای همه است، اما اگر نام «LogWriter» یک فایل منبع خاص را بدانید می‌توانید آن را مشخص کنید. پیش‌فرض \fB*:stderr:30\fP است. . .TP .B \-LowColorLevel, \-LowColourLevel \fIlevel\fP سطح رنگ کاهش‌یافته را برای استفاده در پیوندهای ارتباطی کند انتخاب می‌کند. \fIlevel\fP می‌تواند مقداری از 0 تا 2 داشته باشد؛ 0 یعنی 8 رنگ، 1 یعنی 64 رنگ (پیش‌فرض)، و 2 یعنی 256 رنگ. توجه داشته باشید که تصمیم‌گیری دربارهٔ استفاده از سطح رنگ کاهش‌یافته توسط vncviewer انجام می‌شود. اگر می‌خواهید vncviewer را وادار به استفاده از سطح رنگ کاهش‌یافته کنید، از پارامتر \fB-AutoSelect=0\fP استفاده نمایید. . .TP .B \-MaxCutText \fIbytes\fP حداکثر اندازهٔ به‌روزرسانی کلیپ‌بورد که از یک سرور پذیرفته می‌شود. پیش‌فرض \fB262144\fP است. . .TP .B \-Maximize بزرگ‌نمایی پنجرهٔ نمایشگر. . .TP .B \-NoJpeg غیرفعال‌سازی فشرده‌سازی بااتلاف JPEG. پیش‌فرض غیرفعال است. . .TP .B \-passwd, \-PasswordFile \fIpassword-file\fP اگر در فایل‌سیستمی قرار دارید که به شما دسترسی به فایل گذرواژهٔ مورد استفادهٔ سرور را می‌دهد، می‌توانید آن را در اینجا مشخص کنید تا از تایپ کردن آن بی‌نیاز شوید. این فایل معمولاً \fI$XDG_CONFIG_HOME/tigervnc/passwd\fP یا در صورت تنظیم نبودن آن، \fI~/.config/tigervnc/passwd\fP خواهد بود. . .TP .B \-PointerEventInterval \fItime\fP زمان به میلی‌ثانیه برای محدودسازی نرخ رویدادهای متوالی نشانگر. پیش‌فرض 17 میلی‌ثانیه (60 هرتز) است. . .TP .B \-PreferredEncoding \fIencoding\fP این گزینه کدگذاری ترجیحی را برای استفاده از میان یکی از مقادیر «Tight»، «JPEG»، «ZRLE»، «Hextile»، «H.264» یا «Raw» مشخص می‌کند. . .TP .B \-QualityLevel \fIlevel\fP سطح کیفیت JPEG. 0 = کم، 9 = زیاد. اگر \fB-AutoSelect\fP روشن باشد ممکن است به طور خودکار تنظیم شود. پیش‌فرض 8 است. . .TP .B \-ReconnectOnError نمایش یک کادر گفتگو به هنگام بروز هرگونه خطا و ارائهٔ امکان تلاش دوباره برای برقراری اتصال. در صورتی که این گزینه غیرفعال باشد، هیچ کادر گفتگویی برای اتصال مجدد ارائه نخواهد شد. پیش‌فرض فعال است. ..TP .B \-RemoteResize تغییر اندازه پویای میزکار دوردست همگام با تغییر اندازه پنجره کارخواه محلی. توجه داشته باشید که این ویژگی ممکن است با تمام کارگزارهای VNC کار نکند. . .TP .B \-SecurityTypes \fIsec-types\fP مشخص کردن اینکه از کدام طرح‌های امنیتی برای احراز هویت با کارگزار استفاده شود. مقادیر معتبر فهرستی جداشده با ویرگول از \fBNone\fP، \fBVncAuth\fP، \fBPlain\fP، \fBTLSNone\fP، \fBTLSVnc\fP، \fBTLSPlain\fP، \fBX509None\fP، \fBX509Vnc\fP، \fBX509Plain\fP، \fBRA2\fP، \fBRA2ne\fP، \fBRA2_256\fP و \fBRA2ne_256\fP هستند. پیش‌فرض، تلاش برای استفاده از تمام طرح‌های پشتیبانی‌شده است. . .TP .B \-SendClipboard ارسال تغییرات کلیپ‌بورد به کارگزار. پیش‌فرض فعال است. . .TP .B \-SendPrimary ارسال گزینش اصلی (primary selection) به همراه گزینش کلیپ‌بورد به کارگزار. پیش‌فرض فعال است. . .TP .B \-SetPrimary تنظیم گزینش اصلی (primary selection) به همراه گزینش کلیپ‌بورد. پیش‌فرض فعال است. . .TP .B \-Shared هنگامی که به یک کارگزار VNC متصل می‌شوید، به‌طور معمول تمام اتصالات موجود دیگر بسته می‌شوند. این گزینه درخواست می‌کند که آن‌ها باز بمانند و به شما امکان می‌دهد میزکار را با شخصی که هم‌اکنون از آن استفاده می‌کند به اشتراک بگذارید. . .TP .B \-ShortcutModifiers \fIkeys\fP ترکیب کلیدهای تبدیل (modifier keys) که به‌جای ارسال به نشست دوردست، کنش‌های ویژه‌ای را در نمایشگر فعال می‌کند. مقادیر ممکن ترکیبی از \fBCtrl\fP، \fBShift\fP، \fBAlt\fP و \fBSuper\fP هستند. پیش‌فرض \fBCtrl,Alt\fP است. . .TP .B \-UseIPv4 استفاده از IPv4 برای اتصالات ورودی و خروجی. پیش‌فرض فعال است. . .TP .B \-UseIPv6 استفاده از IPv6 برای اتصالات ورودی و خروجی. پیش‌فرض فعال است. . .TP \fB\-via\fR \fIgateway\fR ایجاد خودکار تونل رمزگذاری‌شده TCP به ماشین \fIgateway\fR پیش از برقراری اتصال، و اتصال به \fIhost\fR از طریق آن تونل (مخصوص TigerVNC). به‌طور پیش‌فرض، این گزینه با فرض اینکه باینری کارخواه SSH در مسیر /usr/bin/ssh قابل دسترسی است، فوروارد پورت محلی SSH را اجرا می‌کند. توجه داشته باشید که هنگام استفاده از گزینه \fB\-via\fR، نام ماشین میزبان باید به همان صورتی که برای ماشین درگاه (gateway) شناخته‌شده است مشخص شود؛ برای مثال "localhost" به \fIgateway\fR اشاره دارد، نه ماشینی که vncviewer روی آن اجرا شده است. متغیر محیطی \fIVNC_VIA_CMD\fR می‌تواند دستور پیش‌فرض تونل را لغو کند: \fB/usr/bin/ssh\ \-f\ \-L\ "$L":"$H":"$R"\ "$G"\ sleep\ 20\fR. دستور تونل با متغیرهای محیطی \fIL\fR، \fIH\fR، \fIR\fR و \fIG\fR اجرا می‌شود که به ترتیب مقادیر شماره پورت محلی، میزبان دوردست، شماره پورت در میزبان دوردست و ماشین درگاه (gateway) را می‌گیرند. . .TP .B \-ViewOnly مشخص می‌کند که هیچ رویداد صفحه‌کلید یا موشواره‌ای نباید به کارگزار ارسال شود. این گزینه هنگامی که می‌خواهید یک میزکار را بدون مداخله مشاهده کنید مفید است؛ اغلب باید با .B \-Shared ترکیب شود. . .TP .B \-X509CA \fIpath\fP مسیر گواهی CA برای استفاده هنگام احراز هویت کارگزارهای دوردست با استفاده از هر یک از طرح‌های امنیتی X509 (مانند X509None، X509Vnc و غیره). باید در قالب PEM باشد. پیش‌فرض \fI$XDG_CONFIG_HOME/tigervnc/x509_ca.pem\fP یا \fI~/.config/tigervnc/x509_ca.pem\fP است. . .TP .B \-X509CRL \fIpath\fP مسیر فهرست ابطال گواهی (CRL) برای استفاده به همراه \fB-X509CA\fP. این مورد نیز باید در قالب PEM باشد. پیش‌فرض \fI$XDG_CONFIG_HOME/tigervnc/x509_crl.pem\fP یا \fI~/.config/tigervnc/x509_crl.pem\fP است..SH "فایل‌ها (FILES)" .TP \fI$XDG_CONFIG_HOME/tigervnc/default.tigervnc\fP .TQ \fI$HOME/.config/tigervnc/default.tigervnc\fP گزینه‌های پیکربندی پیش‌فرض. این فایل باید خط نخست «جادویی» (magic) به صورت \(lqTigerVNC Configuration file Version 1.0\(rq (بدون علامت نقل‌قول) داشته باشد، که در ادامه جفت‌های ساده‌ی = به انتخاب شما قرار می‌گیرند. تنظیمات در دسترس همان مواردی هستند که در این صفحه راهنما نشان داده شده‌اند. .TP \fI$XDG_CONFIG_HOME/tigervnc/x509_ca.pem\fP .TQ \fI$HOME/.config/tigervnc/x509_ca.pem\fP گواهی مرجع صدور گواهی (CA) پیش‌فرض برای احراز هویت سرورها. .TP \fI$XDG_CONFIG_HOME/tigervnc/x509_crl.pem\fP .TQ \fI$HOME/.config/tigervnc/x509_crl.pem\fP فهرست ابطال گواهی (CRL) پیش‌فرض. .TP \fI$XDG_DATA_HOME/tigervnc/x509_known_hosts\fP .TQ \fI$HOME/.local/share/tigervnc/x509_known_hosts\fP پایگاه‌داده میزبان‌های شناخته‌شده برای احراز هویت مبتنی بر گواهی. .TP \fI$XDG_STATE_HOME/tigervnc/tigervnc.history\fP .TQ \fI$HOME/.local/state/tigervnc/tigervnc.history\fP فایل تاریخچه برای نام‌های میزبانی که اخیراً به آن‌ها متصل شده‌اید. .SH "همچنین ببینید (SEE ALSO)" .BR Xvnc (1), .BR vncpasswd (1), .BR vncconfig (1), .BR vncsession (8) .br https://www.tigervnc.org .SH "نویسندگان (AUTHORS)" Tristan Richardson، شرکت RealVNC Ltd. و دیگران. .PP پروتکل VNC در ابتدا توسط تیم RealVNC در Olivetti Research Ltd / AT&T Laboratories Cambridge توسعه داده شد. قابلیت‌های افزوده TightVNC توسط Constantin Kaplinsky پیاده‌سازی شدند. افراد بسیار دیگری نیز از آن زمان تاکنون در توسعه، آزمون و پشتیبانی مشارکت داشته‌اند. این راهنما بخشی از مجموعه نرم‌افزاری TigerVNC است.