.TH vncconfig 1 "" "TigerVNC" "Virtual Network Computing"
.SH "نام (NAME)"
vncconfig \- پیکربندی و واپایش سرور VNC
.SH "خلاصه دستور (SYNOPSIS)"
.B vncconfig
.RI [ parameters ] 
.br
.B vncconfig
.RI [ parameters ] 
.B \-connect \fP[\fB-view-only\fP]
.IR host [: port ]
.br
.B vncconfig
.RI [ parameters ] 
.B \-disconnect
.br
.B vncconfig
.RI [ parameters ] 
.RB [ -set ] 
.IR Xvnc-param = value " ..."
.br
.B vncconfig
.RI [ parameters ] 
.B \-list
.br
.B vncconfig
.RI [ parameters ] 
\fB\-get\fP \fIXvnc-param\fP
.br
.B vncconfig
.RI [ parameters ] 
\fB\-desc\fP \fIXvnc-param\fP
.SH "توضیحات (DESCRIPTION)"
دستور
.B vncconfig
برای پیکربندی و واپایش یک نمونهٔ در حال اجرای Xvnc، یا هر سرور X دیگری که افزونهٔ VNC را داشته باشد به کار می‌رود. توجه داشته باشید که نمی‌توان از آن برای واپایش سرورهای VNC پیش از نسخهٔ ۴ استفاده کرد.

هنگامی که بدون هیچ گزینه‌ای اجرا شود، به صورت یک برنامهٔ «کمکی» (helper) برای Xvnc عمل می‌کند. هدف اصلی آن در این حالت پرسش از کاربر دربارهٔ نحوهٔ مدیریت اتصال‌های جدید است (به شرطی که این ویژگی فعال شده باشد). اگر می‌خواهید همیشه قابلیت پرسش فعال باشد اما میزکار با پنجرهٔ تنظیمات شلوغ نشود، می‌توانید از پرچم
\fB-nowin\fP
استفاده کنید؛ یا به جای آن از گزینهٔ
\fB-iconic\fP
استفاده نمایید تا به طور پیش‌فرض کمینه شود.

هنگامی که در هر حالت دیگری اجرا شود،
\fBvncconfig\fP
یک برنامهٔ تک‌کاره (one-shot) است که برای پیکربندی یا واپایش مناسب Xvnc استفاده می‌شود. از این برنامه می‌توان برای دستور دادن به Xvnc جهت برقراری یا قطع اتصال از نمایشگرهای شنونده، و همچنین تنظیم و دریافت پارامترهای Xvnc بهره گرفت.

توجه داشته باشید که متغیر محیطی DISPLAY یا گزینهٔ
\fB\-display\fP
باید برای واپایش Xvnc به درستی تنظیم شده باشند. اگر آن را روی یک سرور معمولی X (یا روی نسخهٔ ۳ از Xvnc) اجرا کنید، پیامی خطایی مبنی بر این که افزونهٔ VNC وجود ندارد دریافت خواهید کرد.

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-connect \fP[\fB-view-only\fP] \fIhost\fP[:\fIport\fP]
به سرور Xvnc دستور می‌دهد یک اتصال «معکوس» به یک نمایشگر شنوندهٔ VNC ایجاد کند (معمولاً اتصال‌ها برعکس برقرار می‌شوند، یعنی نمایشگر به سرور متصل می‌شود). آرگومان \fIhost\fP میزبانی است که نمایشگر شنونده روی آن در حال اجراست. اگر روی درگاه پیش‌فرض ۵۵۰۰ گوش نمی‌دهد، می‌توانید \fIhost:port\fP را به جای آن مشخص کنید. گزینهٔ \fB-view-only\fP مشخص می‌کند که سرور باید تمام رویدادهای صفحه‌کلید یا ماوس ارسالی توسط کلاینت را نادیده بگیرد.
.
.TP
.B \-desc \fIXvnc-param\fP
توضیح کوتاهی دربارهٔ پارامتر مشخص‌شدهٔ Xvnc چاپ می‌کند.
.
.TP
.B \-disconnect
باعث می‌شود Xvnc اتصال خود را با تمام نمایشگرها قطع کند تا میزکار VNC در هیچ‌کجا نمایش داده نشود.
.
.TP
.B \-get \fIXvnc-param\fP
مقدار فعلی پارامتر مشخص‌شدهٔ Xvnc را چاپ می‌کند.
.
.TP
.B \-list
فهرست تمامی پارامترهای پشتیبانی‌شده توسط Xvnc را نمایش می‌دهد.
.
.TP
[\fB-set\fP] \fIXvnc-param\fP=\fIvalue\fP
یک پارامتر Xvnc را به مقدار ارائه‌شده تنظیم می‌کند. توجه داشته باشید که برخی از پارامترهای Xvnc تنها یک‌بار در هنگام راه‌اندازی خوانده می‌شوند، بنابراین تغییر دادن آن‌ها از این طریق ممکن است تأثیری نداشته باشد.

.SH "پارامترها (PARAMETERS)"
دستور
.B vncconfig
همچنین پارامترهای مخصوص به خود را دارد که می‌توان در خط فرمان آن‌ها را تنظیم کرد. این‌ها نباید با پارامترهای Xvnc که با گزینه‌های
\fB-set\fP، \fB-get\fP، \fB-list\fP
و
\fB-desc\fP
مدیریت می‌شوند اشتباه گرفته شوند.

پارامترها را می‌توان با -\fIparam\fP فعال یا با -\fIparam\fP=0 غیرفعال کرد. پارامترهایی که مقدار می‌پذیرند را می‌توان به صورت -\fIparam\fP \fIvalue\fP مشخص نمود. سایر حالت‌های معتبر عبارتند از \fIparam\fP\fB=\fP\fIvalue\fP، -\fIparam\fP=\fIvalue\fP و --\fIparam\fP=\fIvalue\fP. نام پارامترها به بزرگ و کوچکی حروف حساس نیست.

.TP
.B \-display \fIXdisplay\fP
سرور Xvnc را برای واپایش مشخص می‌کند.
.
.TP
.B \-iconic
هنگام اجرا به عنوان برنامهٔ «کمکی»، پنجره در زمان راه‌اندازی کمینه (iconified) می‌شود.
.
.TP
.B \-nowin
هنگام اجرا به عنوان برنامهٔ «کمکی»، هیچ پنجره‌ای نمایش داده نمی‌شود.

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

.SH "نویسندگان (AUTHORS)"
Tristan Richardson، شرکت .RealVNC Ltd و دیگران.

پروتکل VNC در ابتدا توسط تیم RealVNC در شرکت Olivetti Research Ltd / آزمایشگاه‌های کمبریج AT&T توسعه داده شد. افزوده‌های TightVNC توسط Constantin Kaplinsky پیاده‌سازی شدند. افراد بسیار دیگری نیز از آن زمان در توسعه، آزمایش و پشتیبانی مشارکت داشته‌اند. این دفترچه راهنما بخشی از بستهٔ نرم‌افزاری TigerVNC است.