.TH X0VNCSERVER 1 "" "TigerVNC" "TigerVNC Manual"
.SH "نام (NAME)"
x0vncserver \- کارگزار TigerVNC برای نمایشگرهای X
.SH "خلاصه دستور (SYNOPSIS)"
.B x0vncserver
.RI [ options ]
.br
.B x0vncserver -version
.SH "توضیحات (DESCRIPTION)"
دستور
.B x0vncserver
یک کارگزار TigerVNC است که دسترسی از راه دور به هر نمایشگر X را از طریق VNC، TigerVNC یا نمایشگرهای سازگار فراهم می‌کند. بر خلاف
\fBXvnc\fP(1)،
این برنامه یک نمایشگر مجازی ایجاد نمی‌کند؛ بلکه تنها یک کارگزار X موجود (معمولاً همان کارگزاری که به صفحهٔ نمایش فیزیکی متصل است) را به اشتراک می‌گذارد.

در صورتی که کارگزار X موجود از افزونهٔ XDamage پشتیبانی کند، از آن استفاده خواهد شد. در غیر این صورت
.B x0vncserver
به بررسی دوره‌ای (polling) صفحه نمایش برای تشخیص تغییرات روی خواهد آورد.

.SH "گزینه‌ها (OPTIONS)"
دستور
.B x0vncserver
خط فرمان را به عنوان فهرستی از پارامترها به همراه مقادیر اختیاری تفسیر می‌کند.
اجرای \fBx0vncserver \-h\fP فهرستی از تمام پارامترهای معتبر را با توضیحاتی کوتاه نمایش می‌دهد.
تمام پارامترها اختیاری هستند، اما معمولاً باید از پارامتر \fBPasswordFile\fP استفاده کنید (توضیحات آن را در زیر ببینید).
.PP
چندین شیوه برای تعیین پارامترها در خط فرمان وجود دارد (در اینجا از «\fISomeParameter\fP» به عنوان یک نام پارامتر نمونه استفاده شده است):

.TP
.B -\fISomeParameter\fP
فعال‌سازی پارامتر، روشن کردن ویژگی. این شیوه را می‌توان برای پارامترهایی به کار برد که صرفاً ویژگی خاصی را فعال یا غیرفعال می‌کنند.
.
.TP
.B -\fISomeParameter\fP=0
غیرفعال‌سازی پارامتر، خاموش کردن ویژگی.
.
.TP
.B -\fISomeParameter\fP=\fIvalue\fP
اختصاص مقدار \fIvalue\fP مشخص‌شده به پارامتر. خط تیرهٔ ابتدایی می‌تواند حذف شود، یا در صورت تمایل دو بار تکرار شود (مشابه گزینه‌های طولانی سبک گنو).
.PP
نام پارامترها به حروف بزرگ و کوچک حساس نیست و ترتیب قرارگیری آن‌ها در خط فرمان دلخواه است.

.SH "پارامترها (PARAMETERS)"

.TP
.B \-AcceptKeyEvents
پذیرش رویدادهای فشرده شدن و رها شدن کلیدها از سمت کلاینت‌ها. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-AcceptPointerEvents
پذیرش رویدادهای حرکت و دکمه‌های اشاره‌گر از کلاینت‌ها. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-AcceptSetDesktopSize
پذیرش درخواست‌ها برای تغییر اندازهٔ میزکار. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-AlwaysShared
در نظر گرفتن اتصالات ورودی همواره به صورت اشتراکی (shared)، صرف‌نظر از تنظیمی که کلاینت مشخص کرده است. مقدار پیش‌فرض خاموش (off) است.
.
.TP
.B \-BlacklistThreshold \fIcount\fP
تعداد دفعات مجاز تلاش برای اتصال احراز هویت‌نشده از هر میزبان پیش از قرار گرفتن آن در فهرست سیاه. مقدار پیش‌فرض 5 است.
.
.TP
.B \-BlacklistTimeout \fIseconds\fP
مدت‌زمان وقفهٔ اولیه (به ثانیه) هنگام قرار گرفتن یک میزبان در فهرست سیاه. میزبان تا زمان پایان این مهلت نمی‌تواند مجدداً برای اتصال تلاش کند. مقدار پیش‌فرض 10 است.
.
.TP
.B \-CompareFB \fImode\fP
انجام مقایسهٔ پیکسلی روی بافر فریم (framebuffer) برای کاهش به‌روزرسانی‌های غیرضروری. می‌تواند \fB0\fP (خاموش)، \fB1\fP (همیشه) یا \fB2\fP (خودکار) باشد. مقدار پیش‌فرض \fB2\fP است.
.
.TP
.B \-desktop \fIdesktop-name\fP
هر میزکار نامی دارد که ممکن است توسط نمایشگر کلاینت نشان داده شود. مقدار پیش‌فرض آن "<user>@<hostname>" است.
.
.TP
.B \-DisconnectClients
قطع اتصال کلاینت‌های موجود در صورتی که یک اتصال ورودی غیراشتراکی باشد. مقدار پیش‌فرض روشن (on) است. اگر \fBDisconnectClients\fP نادرست (false) باشد، در حالی که کلاینتی فعال است اتصال غیراشتراکی جدید رد خواهد شد. در صورت ترکیب با \fBNeverShared\fP، بدین معناست که در هر لحظه تنها یک کلاینت مجاز است.
.
.TP
.B \-display \fIdisplay\fP
نام نمایشگر X. در صورت عدم تعیین، مقدار پیش‌فرض آن متغیر محیطی DISPLAY خواهد بود.
.
.TP
.B \-FrameRate \fIfps\fP
حداکثر تعداد به‌روزرسانی‌های ارسالی به هر کلاینت در ثانیه. اگر صفحه نمایش سریع‌تر به‌روزرسانی شود، آن تغییرات تجمیع شده و در قالب یک به‌روزرسانی واحد به کلاینت فرستاده می‌شوند. توجه داشته باشید که این گزینه فقط حداکثر نرخ را کنترل می‌کند و ممکن است در صورت محدودیت منابع، کلاینت نرخ پایین‌تری دریافت کند. مقدار پیش‌فرض \fB60\fP است.
.
.TP
.B \-Geometry \fIgeometry\fP
این گزینه محدودهٔ صفحه‌ای را که به کلاینت‌های VNC نشان داده خواهد شد مشخص می‌کند. قالب آن به صورت
.B \fIwidth\fPx\fIheight\fP+\fIxoffset\fP+\fIyoffset\fP
است، که در آن علامت‌های «+» می‌توانند با علامت‌های «\-» جایگزین شوند تا جابه‌جایی‌ها از سمت راست و/یا از پایین صفحه تعیین گردند. تعیین جابه‌جایی‌ها اختیاری است و به طور پیش‌فرض مقدار +0+0 (گوشهٔ بالا سمت چپ) در نظر گرفته می‌شود. اگر این آرگومان خالی باشد، تمام صفحه به کلاینت‌های VNC نشان داده می‌شود (حالت پیش‌فرض).
.
.TP
.B \-GnuTLSPriority \fIpriority\fP
رشتهٔ اولویت GnuTLS که الگوریتم‌های دست‌تکانی نشست TLS را کنترل می‌کند. برای مشاهدهٔ مقادیر ممکن به کتابچه راهنمای GnuTLS مراجعه کنید. مقدار پیش‌فرض \fBNORMAL\fP است.
.
.TP
.B \-HostsFile \fIfilename\fP
این پارامتر امکان مشخص کردن نام فایلی حاوی قوانین کنترل دسترسی IP را فراهم می‌کند. فایل باید شامل یک قانون در هر خط باشد و قالب قانون یکی از موارد زیر است: +\fIaddress\fP/\fIprefix\fP (پذیرش اتصال‌ها از گروه آدرس مشخص‌شده)، -\fIaddress\fP/\fIprefix\fP (رد اتصال‌ها) یا ?\fIaddress\fP/\fIprefix\fP (پرسش از کاربر محلی). نخستین قانونی که با آدرس IP مطابقت داشته باشد، اقدام لازم را تعیین خواهد کرد. قوانینی که تنها شامل علامت اقدام (+، - یا ?) باشند با هر آدرس IP تطابق می‌یابند. مقدار \fIPrefix\fP اختیاری است و به صورت تعداد بیت‌ها مشخص می‌شود (برای مثال /24). مقدار پیش‌فرض، پذیرش اتصال از تمامی آدرس‌های IP است.
.
.TP
.B \-IdleTimeout \fIseconds\fP
تعداد ثانیه‌هایی که پس از آن یک اتصال VNC بدون فعالیت (بیکار) قطع خواهد شد. مقدار پیش‌فرض 0 است، به این معنی که اتصال‌های بیکار هرگز قطع نمی‌شوند.
.
.TP
.B \-ImprovedHextile
استفاده از الگوریتم فشرده‌سازی بهبودیافته برای کدگذاری Hextile که به بهای مصرف کمی بیشتر زمان پردازنده (CPU)، به نسبت فشرده‌سازی بهتری دست می‌یابد. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-interface \fIIP address\fP
گوش دادن روی یک رابط شبکه مشخص. به طور پیش‌فرض x0vncserver روی تمام رابط‌های شبکه در دسترس گوش می‌دهد.
.
.TP
.B \-localhost
تنها اجازهٔ اتصال از همان ماشین (میزبان محلی) را می‌دهد. در صورتی که از SSH استفاده می‌کنید و می‌خواهید اتصال‌های غیر SSH را از سایر میزبان‌ها مسدود کنید بسیار مفید است.
.
.TP
.B \-Log \fIlogname\fP:\fIdest\fP:\fIlevel\fP[, ...]
تنظیمات لاگ اشکال‌زدایی را پیکربندی می‌کند. مقدار \fIdest\fP در حال حاضر می‌تواند \fBstderr\fP، \fBstdout\fP یا \fBsyslog\fP باشد، و \fIlevel\fP بین 0 تا 100 است که 100 به معنای پرجزئیات‌ترین خروجی است. مقدار \fIlogname\fP معمولاً \fB*\fP به معنای همه است، اما اگر نام "LogWriter" آن را بدانید می‌توانید فایل منبع خاصی را هدف قرار دهید. مقدار پیش‌فرض \fB*:stderr:30\fP است.
.
.TP
.B \-MaxConnectionTime \fIseconds\fP
خاتمه دادن به برنامه هنگامی که یک کلاینت به مدت \fIN\fP ثانیه متصل بوده است. مقدار پیش‌فرض 0 است.
.
.TP
.B \-MaxDisconnectionTime \fIseconds\fP
خاتمه دادن به برنامه هنگامی که هیچ کلاینتی به مدت \fIN\fP ثانیه متصل نبوده است. مقدار پیش‌فرض 0 است.
.
.TP
.B \-MaxIdleTime \fIseconds\fP
خاتمه دادن به برنامه پس از \fIN\fP ثانیه عدم فعالیت کاربر. مقدار پیش‌فرض 0 است.
.
.TP
.B \-MaxProcessorUsage \fIpercent\fP
حداکثر درصد زمان پردازنده (CPU) که هنگام بررسی دوره‌ای صفحه نمایش مصرف می‌شود. مقدار پیش‌فرض 35 است.
.
.TP
.B \-NeverShared
هرگز اتصالات ورودی را به صورت اشتراکی در نظر نمی‌گیرد، صرف‌نظر از تنظیمی که کلاینت مشخص کرده باشد. مقدار پیش‌فرض خاموش (off) است.
.
.TP
.B \-pam_service \fIname\fP, \-PAMService \fIname\fP
نام سرویس PAM برای احراز هویت کاربران هنگام استفاده از هر یک از انواع امنیتی "Plain". مقدار پیش‌فرض \fBvnc\fP است.
.
.TP
.B \-Password \fIpassword\fP
کدگذاری دودویی مبهم‌شده از گذرواژه‌ای که کلاینت‌ها برای دسترسی به کارگزار باید ارائه دهند. استفاده از این پارامتر ناامن است، به جای آن از پارامتر \fBPasswordFile\fP استفاده کنید.
.
.TP
.B \-PasswordFile \fIpasswd-file\fP, \-rfbauth \fIpasswd-file\fP
فایل گذرواژه برای احراز هویت VNC. هیچ مقدار پیش‌فرضی وجود ندارد و باید فایل گذرواژه را صریحاً مشخص کنید. فایل گذرواژه باید با ابزار \fBvncpasswd\fP(1) ایجاد شود. این فایل هر بار که اتصالی برقرار می‌شود بازخوانی می‌گردد، بنابراین می‌توان آن را به صورت درجا تغییر داد.
.
.TP
.B \-PlainUsers \fIuser-list\fP
فهرستی از نام‌های کاربری جدا شده با کاما که مجاز به احراز هویت از طریق هر یک از انواع امنیتی "Plain" (مانند Plain، TLSPlain و غیره) هستند. مقدار \fB*\fP را برای مجاز ساختن هر کاربری جهت احراز هویت با استفاده از این نوع امنیتی مشخص کنید. مقدار \fB%u\fP را برای اجازه به کاربری که فرایند کارگزار را اجرا کرده است مشخص کنید. مقدار پیش‌فرض، رد کردن تمام کاربران است.
.
.TP
.B \-PollingCycle \fImilliseconds\fP
تعداد میلی‌ثانیه‌ها در هر چرخهٔ سرکشی (polling). بازهٔ واقعی ممکن است برای برآورده ساختن تنظیم \fBMaxProcessorUsage\fP به صورت پویا تنظیم شود. مقدار پیش‌فرض 30 است.
.
.TP
.B \-Protocol3.3
استفادهٔ همیشگی از پروتکل نسخه 3.3 جهت سازگاری عقبروی با کلاینت‌های ناسازگار. مقدار پیش‌فرض خاموش (off) است.
.
.TP
.B \-QueryConnect
از کاربر میزکار می‌خواهد تا اتصالات ورودی را صریحاً بپذیرد یا رد کند. مقدار پیش‌فرض خاموش (off) است.
.
.TP
.B \-QueryConnectTimeout \fIseconds\fP
تعداد ثانیه‌های نمایش کادر گفتگوی پذیرش اتصال پیش از رد کردن آن. مقدار پیش‌فرض \fB10\fP است.
.
.TP
.B \-RawKeyboard
ارسال مستقیم رویدادهای صفحه‌کلید و جلوگیری از نگاشت آن‌ها به چیدمان صفحه‌کلید فعلی. این عمل عملاً باعث می‌شود صفحه‌کلید به جای چیدمان تنظیم‌شده در کلاینت، بر اساس چیدمان پیکربندی‌شده روی کارگزار رفتار کند. مقدار پیش‌فرض خاموش (off) است.
.
.TP
.B \-AcceptCutText
پذیرش به‌روزرسانی‌های کلیپ‌بورد از کلاینت‌ها. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-SetPrimary
تنظیم انتخاب PRIMARY علاوه بر انتخاب CLIPBOARD. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-MaxCutText \fIbytes\fP
حداکثر اندازهٔ مجاز برای یک به‌روزرسانی ورودی کلیپ‌بورد (به بایت). مقدار پیش‌فرض \fB262144\fP است.
.
.TP
.B \-SendCutText
ارسال تغییرات کلیپ‌بورد به کلاینت‌ها. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-SendPrimary
ارسال انتخاب PRIMARY علاوه بر انتخاب CLIPBOARD به کلاینت‌ها. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-RemapKeys \fImapping
یک نگاشت صفحه‌کلید را تنظیم می‌کند.
.I mapping
یک رشته از نگاشت‌های نویسه‌ای جدا شده با کاما به فرم
.IR char -> char ،
یا
.IR char <> char
است، که در آن
.I char
یک نماد کلید (keysym) در مبنای شانزده است. برای مثال، جهت تعویض جای نمادهای " و @ می‌توانید مورد زیر را تعیین کنید:

.RS 10
RemapKeys=0x22<>0x40
.RE
.
.TP
.B \-RequireUsername
الزام وجود نام کاربری برای انواع امنیتی RSA-AES. مقدار پیش‌فرض خاموش (off) است.
.
.TP
.B \-rfbport \fIport\fP
درگاه TCP که x0vncserver روی آن برای اتصال‌ها از نمایشگرها گوش می‌دهد را مشخص می‌کند (پروتکل مورد استفاده در VNC، تحت عنوان RFB یا "remote framebuffer" شناخته می‌شود). مقدار \fB-1\fP را برای غیرفعال کردن گوش دادن روی درگاه TCP مشخص کنید. درگاه پیش‌فرض در صورت اجرای مستقیم 5900 و در صورت فعال‌سازی توسط یک سوکت systemd برابر -1 است.
.
.TP
.B \-rfbunixmode \fImode\fP
حالت دسترسی (mode) سوکت دامنه یونیکس را مشخص می‌کند. مقدار پیش‌فرض 0600 است.
.
.TP
.B \-rfbunixpath \fIpath\fP
مسیر سوکت دامنه یونیکس را مشخص می‌کند که x0vncserver روی آن برای اتصال‌ها از سمت نمایشگرها گوش می‌دهد. حالت پیش‌فرض، عدم گوش دادن به سوکت دامنه یونیکس است.
.
.TP
.B \-RSAKey \fIpath\fP
مسیر کلید RSA برای انواع امنیتی RSA-AES (\fBRA2\fP، \fBRA2ne\fP، \fBRA2_256\fP و \fBRA2ne_256\fP) در قالب PEM.
.
.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 هستند. مقدار پیش‌فرض \fBTLSVnc,VncAuth\fP است.
.
.TP
.B \-UseBlacklist
رد موقت اتصال‌ها از یک میزبان در صورتی که احراز هویت آن مکرراً با شکست مواجه شود. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-UseIPv4
استفاده از IPv4 برای اتصالات ورودی و خروجی. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-UseIPv6
استفاده از IPv6 برای اتصالات ورودی و خروجی. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-UseSHM
استفاده از افزونهٔ MIT-SHM در صورت در دسترس بودن. استفاده از این افزونه خواندن صفحه را سرعت می‌بخشد. مقدار پیش‌فرض روشن (on) است.
.
.TP
.B \-X509Cert \fIpath\fP
مسیر گواهی X509 در قالب PEM برای استفاده در تمامی انواع امنیتی مبتنی بر X509 (مانند X509None، X509Vnc و غیره).
.
.TP
.B \-X509Key \fIpath\fP
کلید خصوصی متناظر با گواهی ارائه‌شده در \fBX509Cert\fP. این کلید نیز باید در قالب PEM باشد.

.SH "همچنین ببینید (SEE ALSO)"
.BR Xvnc (1),
.BR vncpasswd (1),
.br
https://www.tigervnc.org

.SH "نویسندگان (AUTHORS)"
Constantin Kaplinsky و دیگران.
.PP
نرم‌افزار VNC در ابتدا توسط تیم RealVNC هنگام فعالیت در شرکت Olivetti Research Ltd / AT&T Laboratories Cambridge توسعه داده شد. الحاقات TightVNC توسط Constantin Kaplinsky پیاده‌سازی شدند. از آن زمان تاکنون افراد بسیار دیگری در توسعه، آزمایش و پشتیبانی آن مشارکت داشته‌اند. این راهنما بخشی از مجموعه نرم‌افزاری TigerVNC است.