.\" Copyright (C) 2010 NVIDIA Corporation.
.\" WARNING: THIS FILE IS AUTO-GENERATED!  Edit nvidia-settings.1.m4 instead.
.\" Define the .URL macro and then override it with the www.tmac package if it
.\" exists.
.de URL
\\$2 \(la \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.TH nvidia\-settings 1 "2018-03-20" "nvidia\-settings 610.57.04"
.SH "نام (NAME)"
nvidia\-settings \- پیکربندی درایور گرافیک NVIDIA
.SH "خلاصه دستور (SYNOPSIS)"
.BI "nvidia\-settings [" "options" "]"
.br
.BI "nvidia\-settings [" "options" "] \-\-no\-config"
.br
.BI "nvidia\-settings [" "options" "] \-\-load\-config\-only"
.br
.BI "nvidia\-settings [" "options" "] {\-\-query=" attr " | \-\-assign=" attr = value "} ..."
.br
.BI "nvidia\-settings [" "options" "] \-\-glxinfo"
.PP
گزینه‌ها:
.BI "[\-vh] [\-\-config=" configfile "] [\-c " ctrl-display "]"
.br
.I "         \fB[\-\-verbose=\fP{\fInone \fP|\fI errors \fP|\fI deprecations \fP|\fI warnings \fP|\fI all\fP}\fB]"
.br
.I "         \fB[\-\-describe=\fP{\fIall \fP|\fI list \fP|\fI attribute_name\fP}\fB]"
.PP
.I attr
دارای ساختار زیر است:
.ti +5
.IB DISPLAY / attribute_name [ display_devices ]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B nvidia\-settings
ابزاری برای پیکربندی درایور گرافیک NVIDIA است.
این ابزار از طریق ارتباط با درایور X مربوط به NVIDIA، و بر حسب نیاز با استعلام و به‌روزرسانی وضعیت‌ها عمل می‌کند.
این ارتباط از طریق افزونه‌های X شامل NV-CONTROL، GLX، XVideo و RandR انجام می‌شود.
.PP
مقدارهایی مانند روشنایی و گاما، ویژگی‌های XVideo، دما و تنظیمات OpenGL را می‌توان از طریق
.B nvidia\-settings
استعلام و پیکربندی کرد.
.PP
هنگامی که
.B nvidia\-settings
شروع به کار می‌کند، تنظیمات فعلی را از فایل پیکربندی خود خوانده و آن تنظیمات را به کارساز X ارسال می‌کند.
سپس، یک رابط کاربری گرافیکی (GUI) را برای پیکربندی تنظیمات فعلی نمایش می‌دهد.
هنگامی که
.B nvidia\-settings
خارج می‌شود، تنظیمات فعلی را از کارساز X استعلام کرده و آن‌ها را در فایل پیکربندی ذخیره می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-v, \-\-version"
چاپ نسخهٔ
.B nvidia\-settings
و خروج.
.TP
.BI "\-h, \-\-help"
چاپ اطلاعات نحوهٔ استفاده و خروج.
.TP
.BI "\-\-config=" "CONFIG"
استفاده از فایل پیکربندی
.I CONFIG
به جای مقدار پیش‌فرض
.I ~/.nvidia\-settings\-rc

.TP
.BI "\-c " "CTRL-DISPLAY" ", \-\-ctrl-display=" "CTRL-DISPLAY"
کنترل نمایشگر (display) مشخص‌شده در X. اگر این گزینه داده نشود،
.B nvidia\-settings
نمایشگر تعیین‌شده توسط
.B '\-\-display'
را کنترل خواهد کرد؛ اگر آن هم مشخص نشده باشد، متغیر محیطی
.I $DISPLAY
استفاده می‌شود.
.TP
.BI "\-l, \-\-load-config-only"
بارگذاری فایل پیکربندی، ارسال مقادیر تعیین‌شده در آن به کارساز X و سپس خروج. این حالت عملکرد، برای مثال، جهت قرار دادن در فایل xinitrc شما مفید است.
.TP
.BI "\-n, \-\-no-config"
عدم بارگذاری فایل پیکربندی. این حالت عملکرد زمانی مفید است که
.B nvidia\-settings
به دلیل وجود مشکل در اعمال تنظیمات فایل پیکربندی، در راه‌اندازی دچار مشکل می‌شود.
.TP
.BI "\-r, \-\-rewrite-config-file"
نوشتن پیکربندی کارساز X در فایل پیکربندی و خروج، بدون راه‌اندازی رابط کاربری گرافیکی. بخش «مثال‌ها» را ببینید.
.TP
.BI "\-V " "VERBOSE" ", \-\-verbose=" "VERBOSE"
میزان اطلاعات چاپ‌شده را کنترل می‌کند. مقادیر معتبر عبارتند از:
.B 'none'
(پیام‌های وضعیت چاپ نشوند)،
.B 'errors'
(چاپ پیام‌های خطا)،
.B 'deprecations'
(چاپ پیام‌های خطا و منسوخ‌شدگی)،
.B 'warnings'
(چاپ پیام‌های خطا، منسوخ‌شدگی و هشدار) و
.B 'all'
(چاپ پیام‌های خطا، منسوخ‌شدگی، هشدار و سایر پیام‌های اطلاع‌رسانی). به‌طور پیش‌فرض،
.B 'deprecations'
تنظیم شده است.
.TP
.BI "\-a " "ASSIGN" ", \-\-assign=" "ASSIGN"
آرگومان
.I ASSIGN
برای گزینهٔ خط فرمان
.B '\-\-assign'
دارای این ساختار است:

  {DISPLAY}/{attribute name}[{display devices}]={value}

این آرگومان، ویژگی {attribute name} را روی نمایشگر X با نام {DISPLAY} به مقدار {value} اختصاص می‌دهد. {DISPLAY} از نحو معمول {host}:{display}.{screen} متغیر محیطی DISPLAY پیروی کرده و اختیاری است؛ در صورتی که مشخص نشود، طبق همان قاعدهٔ گزینهٔ
.B \-\-ctrl\-display
به‌طور ضمنی در نظر گرفته می‌شود. اگر صفحهٔ X مشخص نشده باشد، انتساب به تمام صفحه‌های X اعمال می‌شود. توجه داشته باشید که علامت '/' تنها زمانی نیاز است که {DISPLAY} وجود داشته باشد.

علاوه بر این، {DISPLAY} می‌تواند شامل یک مشخصهٔ هدف باشد تا انتساب به چیزی غیر از یک صفحهٔ X هدایت شود. مشخصهٔ هدف درون قلاب‌ها قرار می‌گیرد و شامل نام نوع هدف، یک دونقطه و شناسهٔ هدف است. نام نوع هدف می‌تواند یکی از موارد
.B "screen", "gpu", "framelock", "fan", "thermalsensor", "svp",
یا
.B "dpy";
باشد؛ شناسهٔ هدف نیز نمایانگر اندیس مربوط به فهرست هدف‌ها (برای آن نوع هدف) است. مشخصهٔ هدف می‌تواند در {DISPLAY} در هر جایی که صفحهٔ X قابل استفاده است، با پیروی از نحو {host}:{display}[{target_type}:{target_id}] به کار رود. برای کسب اطلاعات دربارهٔ این‌که کدام انواع هدف را می‌توان با چه ویژگی‌هایی به کار برد، خروجی دستور زیر را مشاهده کنید:

  nvidia\-settings \-q all 

برای دیدن فهرست هدف‌ها برای هر نوع هدف، خروجی دستور زیر را مشاهده کنید:

   nvidia\-settings \-q screens \-q gpus \-q framelocks \-q fans \-q thermalsensors \-q svps \-q dpys 

بخش [{display devices}] نیز اختیاری است؛ اگر مشخص نشود، ویژگی به تمام دستگاه‌های نمایشگر اختصاص داده می‌شود.

چند مثال:

  \-a FSAA=5
  \-a localhost:0.0/DigitalVibrance[CRT\-0]=0
  \-\-assign="SyncToVBlank=1"
  \-a [gpu:0]/DigitalVibrance[DFP\-1]=63

.TP
.BI "\-q " "QUERY" ", \-\-query=" "QUERY"
آرگومان
.I QUERY
برای گزینهٔ خط فرمان
.B '\-\-query'
دارای این ساختار است:

  {DISPLAY}/{attribute name}[{display devices}]

این گزینه مقدار فعلی ویژگی {attribute name} را روی نمایشگر X با نام {DISPLAY} استعلام می‌کند. نحو آن مانند گزینهٔ
.B '\-\-assign'
است، بدون '=
.B {value}'
'؛ به منظور استعلام فهرستی از صفحه‌های X، پردازنده‌های گرافیکی (GPUs)، دستگاه‌های Frame Lock، سامانه‌های رایانش بصری (Visual Computing Systems)، دستگاه‌ها، فن‌ها، حسگرهای حرارتی، فرستنده‌گیرنده‌های 3D Vision Pro یا دستگاه‌های نمایشگر موجود در نمایشگر X با نام {DISPLAY}، به ترتیب گزینه‌های
.B '\-q screens', '\-q gpus', '\-q framelocks', '\-q fans'
، '\-q thermalsensors' ،'\-q svps' یا '\-q dpys' را تعیین کنید. جهت استعلام تمامی ویژگی‌ها،
.B '\-q all'
را مشخص نمایید.
.TP
.BI "\-t, \-\-terse"
هنگام استعلام مقادیر ویژگی‌ها با گزینهٔ خط فرمان '\-\-query'، تنها مقدار فعلی چاپ شود، نه توضیحات مفصل‌تر دربارهٔ ویژگی، مقادیر معتبر آن و مقدار فعلی‌اش.
.TP
.BI "\-d, \-\-display-device-string"
هنگام چاپ مقادیر ویژگی در پاسخ به گزینهٔ '\-\-query'، اگر مقدار ویژگی یک ماسک دستگاه نمایشگر باشد، مقدار به جای یک ماسک بیتی هگزادسیمال (مانند 0x00010001)، به صورت فهرستی از دستگاه‌های نمایشگر (مانند "CRT\-0, DFP\-0") چاپ شود.
.TP
.BI "\-g, \-\-glxinfo"
چاپ اطلاعات GLX برای نمایشگر X و خروج.
.TP
.BI "\-E, \-\-eglinfo"
چاپ اطلاعات EGL برای نمایشگر X و خروج.
.TP
.BI "\-k, \-\-vulkaninfo"
چاپ اطلاعات Vulkan برای نمایشگر X و خروج.
.TP
.BI "\-e " "DESCRIBE" ", \-\-describe=" "DESCRIBE"
اطلاعاتی دربارهٔ یک ویژگی خاص چاپ می‌کند. برای فهرست کردن توضیحات تمام ویژگی‌ها مقدار 'all' را تعیین کنید. برای فهرست کردن نام‌های ویژگی‌ها بدون توضیحات، 'list' را مشخص نمایید.
.TP
.BI "\-p " "PAGE" ", \-\-page=" "PAGE"
آرگومان
.I PAGE
برای گزینهٔ خط فرمان
.B '\-\-page'
صفحهٔ خاصی را در رابط کاربری nvidia\-settings انتخاب می‌کند تا به محض شروع nvidia\-settings نمایش داده شود. مقادیر معتبر، نام‌های صفحات در نمای درختیِ سمت چپِ رابط کاربری nvidia\-settings هستند؛ برای مثال:

  \-\-page="X Screen 0"

از آنجا که برخی نام‌های صفحات یکتا نیستند (برای نمونه، یک صفحهٔ "PowerMizer" در زیر هر GPU وجود دارد)، می‌توان به‌صورت اختیاری نام صفحهٔ والد X Screen یا GPU را پیش از نام صفحه، همراه با یک ویرگول اضافه کرد؛ برای مثال:

  \-\-page="GPU 0 \- (Quadro 6000), PowerMizer"

نخستین صفحه‌ای که نام آن با آرگومان
.I PAGE
مطابقت داشته باشد استفاده خواهد شد. به‌طور پیش‌فرض، صفحهٔ "System Information" نمایش داده می‌شود.
.TP
.BI "\-L, \-\-list-targets-only"
هنگام انجام استعلام ویژگی (از طریق گزینهٔ خط فرمان '\-\-query') یا انتساب یک ویژگی (از طریق گزینهٔ خط فرمان '\-\-assign' یا هنگام بارگذاری فایل ~/.nvidia\-settings\-rc)، nvidia\-settings یک یا چند هدف را که ویژگی باید روی آن‌ها استعلام/انتساب شود شناسایی می‌کند.

گزینهٔ '\-\-list\-targets\-only' باعث می‌شود nvidia\-settings اهدافی را که عملیات استعلام/انتساب قرار بود روی آن‌ها انجام شود فهرست کرده و بدون انجام واقعی عملیات(ها)، خارج شود.
.TP
.BI "\-w, \-\-write-config, \-\-no\-write-config"
ذخیرهٔ فایل پیکربندی هنگام خروج (به‌طور پیش‌فرض فعال است)..TP
.BI "\-i, \-\-use-gtk2"
در صورتی که به رابط کاربری نیاز باشد، nvidia\-settings را وادار می‌کند تا برای رابط کاربری گرافیکی از کتابخانه GTK+ 2 استفاده کند. این گزینه تنها در سیستم‌هایی در دسترس است که nvidia\-settings در آن‌ها از هر دو رابط کاربری GTK+ 2 و GTK+ 3 پشتیبانی می‌کند.

.TP
.BI "\-I " "GTK-LIBRARY" ", \-\-gtk-library=" "GTK-LIBRARY"
کتابخانه رابط کاربری گرافیکی مورد نظر را در صورتی که به رابط کاربری nvidia\-settings نیاز باشد، مشخص می‌کند. این مقدار می‌تواند مسیر دقیق کتابخانه یا دایرکتوری حاوی کتابخانه‌ای با نام مناسب باشد. اگر این مقدار مسیر دقیق کتابخانه باشد، گزینه 'use\-gtk2' نادیده گرفته می‌شود.

.SH "راهنمای کاربر (USER GUIDE)"
.SS Contents
1.	طرح‌بندی رابط کاربری گرافیکی nvidia\-settings
.br
2.	نحوه تعامل OpenGL با nvidia\-settings
.br
3.	بارگذاری خودکار تنظیمات
.br
4.	رابط خط فرمان
.br
5.	نام‌های نمایشگر X در فایل پیکربندی
.br
6.	اتصال به سرورهای X از راه دور
.br
7.	مجوزها
.br
8.	کارهای آینده (TODO)
.br
.SS 1. طرح‌بندی رابط کاربری گرافیکی nvidia\-settings
رابط کاربری گرافیکی (GUI)
.B nvidia\-settings
به همراه فهرستی از دسته‌بندی‌های گوناگون در سمت چپ سازمان‌دهی شده است.
در هر لحظه تنها یک مورد از فهرست می‌تواند انتخاب شود و دسته‌بندی انتخاب‌شده تعیین می‌کند کدام «صفحه» در سمت راست رابط گرافیکی
.B nvidia\-settings
نمایش داده شود.
.PP
فهرست دسته‌بندی‌ها به صورت درختی سازمان‌دهی شده است: هر صفحه نمایشگر X (X screen) زیردسته‌های مربوط به خود را در زیرمجموعه‌اش در بر دارد.
به همین ترتیب، دسته‌بندی Display Devices برای یک صفحه نمایشگر، شامل تمامی دستگاه‌های نمایش فعالِ زیر آن است.
علاوه بر هر صفحه نمایشگر X، دسته‌بندی سطح‌بالای دیگر «nvidia\-settings Configuration» است که رفتار خود برنامه
.B nvidia\-settings
را پیکربندی می‌کند.
.PP
در امتداد بخش پایینی رابط گرافیکی
.B nvidia\-settings
از چپ به راست موارد زیر قرار دارند:
.TP
1)
یک نوار وضعیت که جدیدترین گزینه تغییر‌یافته را نشان می‌دهد؛
.TP
2)
یک دکمه Help که وضعیت نمایش پنجره راهنما را تغییر می‌دهد؛ پنجره‌ای که توضیحات مفصلی درباره گزینه‌های موجود در صفحه جاری ارائه می‌دهد؛ و
.TP
3)
یک دکمه Quit برای خروج از
.B nvidia\-settings.
.PP
بیشتر گزینه‌ها در سرتاسر
.B nvidia\-settings
بلافاصله اعمال می‌شوند.
استثناهای قابل‌توجه، گزینه‌های OpenGL هستند که فقط هنگام آغاز به کار یک برنامه OpenGL، توسط OpenGL خوانده می‌شوند.
.PP
جزئیات مربوط به گزینه‌های هر صفحه از
.B nvidia\-settings
در پنجره راهنما در دسترس است.
.SS 2. نحوه تعامل OpenGL با nvidia\-settings
.PP
هنگامی که یک برنامه کاربردی OpenGL شروع به کار می‌کند، مقادیر جاری را از درایور X بارگیری کرده و سپس محیط را می‌خواند (ببینید:
.I APPENDIX E: OPENGL ENVIRONMENT VARIABLE SETTINGS
در فایل README).
تنظیمات سرور X مقادیر پیش‌فرض OpenGL را بازنویسی می‌کنند، و تنظیمات محیط نیز مقادیر سرور X را بازنویسی می‌نمایند.
.PP
برای مثال، به‌طور پیش‌فرض OpenGL از تنظیم FSAA درخواست‌شده توسط برنامه استفاده می‌کند (معمولاً برنامه‌ها هیچ FSAAای درخواست نمی‌کنند).
تنظیم FSAA مشخص‌شده در
.B nvidia\-settings
درخواست برنامه OpenGL را بازنویسی خواهد کرد.
به همین ترتیب، متغیر محیطی
.B __GL_FSAA_MODE
تنظیم FSAA برنامه و همچنین هرگونه تنظیم FSAA تعیین‌شده در
.B nvidia\-settings
را بازنویسی می‌کند.
.PP
توجه داشته باشید که یک برنامه کاربردی OpenGL تنها در زمان شروع به کار تنظیمات را از سرور X دریافت می‌کند؛ بنابراین اگر تغییری در مقدار OpenGL در
.B nvidia\-settings
ایجاد کنید، تنها بر برنامه‌های کاربردی OpenGL اعمال خواهد شد که پس از آن نقطه زمانی اجرا شوند.
.SS 3. بارگذاری خودکار تنظیمات
درایور X شرکت NVIDIA مقادیر تنظیم‌شده با
.B nvidia\-settings
را بین اجراهای سرور X (یا حتی بین ورود به سیستم و خروج از X با
.BR xdm (1)،
.B gdm
یا
.B kdm
) حفظ نمی‌کند.
این رفتار عمدی است، زیرا کاربران مختلف ممکن است ترجیحات متفاوتی داشته باشند؛ از این رو این تنظیمات بر اساس هر کاربر در یک فایل پیکربندی واقع در دایرکتوری خانگی کاربر ذخیره می‌شوند.
.PP
نام این فایل پیکربندی
.IR ~/.nvidia\-settings\-rc .
است. می‌توانید نام فایل پیکربندی متفاوتی را با گزینه خط فرمان
.B \-\-config
مشخص کنید.
.PP
پس از اینکه
.B nvidia\-settings
را یک بار اجرا کردید و یک فایل پیکربندی ایجاد نمودید، می‌توانید در آینده هر زمان دستور زیر را اجرا کنید:
.sp
.ti +5
nvidia\-settings \-\-load\-config\-only
.sp
تا این تنظیمات را مجدداً به سرور X ارسال کند.
برای مثال، می‌توانید دستور بالا را در فایل
.I ~/.xinitrc
خود قرار دهید تا تنظیمات شما هنگام ورود به X به‌طور خودکار اعمال شوند.
.PP
فایل
.I .xinitrc
شما، که کنترل می‌کند چه برنامه‌های کاربردی X باید هنگام ورود به X (یا با دستور startx) شروع شوند، ممکن است چیزی شبیه به این باشد:
.nf

     nvidia\-settings \-\-load\-config\-only &
     xterm &
     evilwm

.fi
یا:
.nf

     nvidia\-settings \-\-load\-config\-only &
     gnome\-session

.fi
اگر از قبل فایل
.I ~/.xinitrc
ندارید، این احتمال وجود دارد که
.BR xinit (1)
از یک فایل xinitrc در سطح کل سیستم استفاده می‌کند.
این فایل سراسری سیستم معمولاً در اینجا قرار دارد:
.nf

     /etc/X11/xinit/xinitrc

.fi
برای استفاده از آن و در عین حال ارسال تنظیمات توسط
.B nvidia\-settings ،
می‌توانید یک فایل
.I ~/.xinitrc
با محتویات زیر ایجاد کنید:
.nf

     nvidia\-settings \-\-load\-config\-only &
     . /etc/X11/xinit/xinitrc

.fi
مدیران سیستم ممکن است ترجیح دهند دستور بارگذاری
.B nvidia\-settings
را مستقیماً در اسکریپت xinitrc سراسری سیستم قرار دهند.
.PP
لطفاً برای جزئیات بیشتر در خصوص پیکربندی فایل
.I ~/.xinitrc
خود، به صفحه راهنمای
.BR xinit (1)
مراجعه کنید..SS 4. رابط خط فرمان (Command Line Interface)
برنامهٔ
.B nvidia\-settings
دارای یک رابط خط فرمان غنی است: تمام مشخصه‌هایی که با واسط گرافیکی (GUI) قابل دستکاری هستند، از طریق خط فرمان نیز قابل پرس‌وجو و تنظیم می‌باشند.
نحو خط فرمان برای پرس‌وجو و انتساب مشخصه‌ها با فایل پیکربندی
.I .nvidia\-settings\-rc
مطابقت دارد.
.PP
گزینهٔ
.B \-\-query
می‌تواند برای پرس‌وجوی مقدار فعلی مشخصه‌ها به کار رود.
این کار همچنین مقادیر معتبر مشخصه را گزارش می‌دهد.
شما می‌توانید دستور
.B nvidia\-settings \-\-query all
را برای دریافت فهرستی کامل از مشخصه‌های موجود، مقدار کنونی‌شان، مقادیر معتبر برای هر مشخصه، و انواع هدف‌هایی که می‌توان مشخصه‌ها را از طریق آن‌ها آدرس‌دهی کرد (مانند صفحه‌های X یا GPUها) اجرا کنید.
علاوه بر این، مشخصه‌های فردی می‌توانند به این صورت مشخص شوند:
.nf

        nvidia\-settings \-\-query Overlay

.fi
نام یک مشخصه می‌تواند با نام یک نمایشگر X (یا X Display) و یک اسلش روبه‌جلو (/) پیشوندگذاری شود تا نمایشگر X متفاوتی را مشخص کند؛ مانند:
.nf

        nvidia\-settings \-\-query localhost:0.0/Overlay

.fi
همچنین نام یک مشخصه می‌تواند فقط با شمارهٔ صفحه و یک اسلش روبه‌جلو پیشوندگذاری شود:
.nf

        nvidia\-settings \-\-query 0/Overlay

.fi
که در این صورت از نمایشگر پیش‌فرض X استفاده خواهد شد، اما می‌توانید مشخص کنید که پرس‌وجو به کدام صفحهٔ X هدایت شود (اگر کارساز X شما دارای چندین صفحهٔ X باشد).
اگر هیچ صفحهٔ X مشخص نشود، آنگاه مقدار مشخصه برای تمام هدف‌های معتبر آن مشخصه (مانند GPUها، صفحه‌های X نمایشگر و غیره) پرس‌وجو خواهد شد.
.PP
مشخصه‌ها می‌توانند از طریق «انواع هدف» (target types) آدرس‌دهی شوند.
یک نوع هدف نشان‌دهندهٔ شیئی است که هنگام پرس‌وجوی یک مشخصه مورد پرسش قرار می‌گیرد.
نوع هدف پیش‌فرض، یک صفحهٔ X است، اما دیگر انواع هدف ممکن عبارت‌اند از GPUها، دستگاه‌های Frame Lock، سیستم‌های محاسبات بصری (Visual Computing Systems)، فن‌ها، حسگرهای دما، فرستنده‌گیرنده‌های 3D Vision Pro و دستگاه‌های نمایشگر.
.PP
انواع هدف، میزان جزئیات و دقت متفاوتی برای انجام پرس‌وجوها و انتساب‌ها در اختیارتان می‌گذارند.
از آنجا که صفحه‌های X می‌توانند چندین GPU را پوشش دهند (در حالت‌های Xinerama یا SLI)، و چندین صفحهٔ X می‌توانند بر روی یک GPU واحد وجود داشته باشند، گاهی اوقات آدرس‌دهی مشخصه‌ها از طریق GPU به جای صفحهٔ X سودمند است.
.PP
مشخصات هدف درون قلاب‌ها (براکت‌ها) قرار می‌گیرد و می‌تواند شامل نام نوع هدف، یک دونقطه، و شناسهٔ هدف (target id) باشد.
نام نوع هدف می‌تواند یکی از موارد
.B screen,
.B gpu,
.B framelock,
.B fan,
.B thermalsensor,
.B svp,
یا
.B dpy
باشد؛ شناسهٔ هدف، اندیس آن در فهرست هدف‌ها (برای آن نوع هدف) است.
مشخصات هدف را می‌توان در هر جایی از دستورهای پرس‌وجو و انتساب که صفحهٔ X به کار می‌رود استفاده کرد؛ مشخصات هدف می‌تواند به تنهایی در سمت چپ اسلش، یا به عنوان بخشی از نام نمایشگر X به کار رود.
.PP
برای نمونه، پرس‌وجوهای زیر صفحهٔ X شمارهٔ 0 را روی localhost آدرس‌دهی می‌کنند:
.nf

        nvidia\-settings \-\-query 0/VideoRam
        nvidia\-settings \-\-query localhost:0.0/VideoRam
        nvidia\-settings \-\-query [screen:0]/VideoRam
        nvidia\-settings \-\-query localhost:0[screen:0]/VideoRam

.fi
برای آدرس‌دهی GPU 0 به جای آن، می‌توانید از هر یک از موارد زیر استفاده کنید:
.nf

        nvidia\-settings \-\-query [gpu:0]/VideoRam
        nvidia\-settings \-\-query localhost:0[gpu:0]/VideoRam

.fi
توجه داشته باشید که اگر مشخصات هدف ذکر شده باشد، بر هر صفحهٔ X مشخص‌شده در نام نمایشگر به عنوان هدف پردازش اولویت خواهد داشت و آن را بازنویسی می‌کند.
برای نمونه، پرس‌وجوی زیر GPU 0 را آدرس‌دهی می‌کند و نه صفحهٔ X شمارهٔ 1 را:
.nf

	nvidia\-settings \-\-query localhost:0.1[gpu:0]/VideoRam

.fi
.PP
می‌توان به جای شناسهٔ هدف، از نام هدف استفاده کرد؛ در این حالت، تمام هدف‌هایی که نام منطبق دارند پردازش می‌شوند.
.PP
برای نمونه، پرس‌وجوی DigitalVibrance از دستگاه نمایشگر DVI-I-1 می‌تواند به این صورت انجام شود:
.nf

	nvidia\-settings \-\-query [dpy:DVI\-I\-1]/DigitalVibrance

.fi
هنگامی که نام هدف تعیین می‌شود، نام نوع هدف می‌تواند حذف شود، اگرچه این کار باید با احتیاط انجام گیرد زیرا نام در میان تمام انواع هدف جستجو و تطبیق داده خواهد شد.
مثال بالا را می‌توان به این صورت نوشت:
.nf

	nvidia\-settings \-\-query [DVI\-I\-1]/DigitalVibrance

.fi
نام هدف همچنین می‌تواند صرفاً نام یک نوع هدف باشد، که در این حالت تمام هدف‌های آن نوع پرس‌وجو خواهند شد.
.PP
برای نمونه، پرس‌وجوی BusRate برای تمام GPUها می‌تواند به این صورت انجام شود:
.nf

	nvidia\-settings \-\-query [gpu]/BusRate

.fi
.PP
مشخصات هدف همچنین می‌تواند شامل یک توصیف‌کنندهٔ هدف (target qualifier) باشد.
این ویژگی برای محدود کردن پردازش به زیرمجموعه‌ای از هدف‌ها بر پایهٔ رابطه(های) موجود با دیگر هدف‌ها سودمند است.
توصیف‌کنندهٔ هدف با افزودن نام نوع هدف، یک دونقطه، شناسهٔ هدف، و یک نقطه به عنوان پیشوند به مشخصات موجود تعیین می‌شود.
تنها یک توصیف‌کننده می‌تواند مشخص شود.
.PP
برای نمونه، پرس‌وجوی RefreshRate از تمام دستگاه‌های DFP روی GPU 1 می‌تواند به این صورت انجام شود:
.nf

	nvidia\-settings \-\-query [GPU:1.DPY:DFP]/RefreshRate

.fi
به همین ترتیب، یک نام هدف ساده (یا نام نوع هدف) نیز می‌تواند به عنوان توصیف‌کننده استفاده شود.
برای نمونه، برای پرس‌وجوی BusType از تمام GPUهایی که دارای DFP هستند، می‌توان این‌گونه عمل کرد:
.nf

	nvidia\-settings \-\-query [DFP.GPU]/BusType

.fi
.PP
خروجی دستور
.nf

        nvidia\-settings \-\-query all

.fi
را ببینید تا بدانید چه انواع هدفی می‌توانند برای هر مشخصه استفاده شوند.
همچنین خروجی دستور
.nf

        nvidia\-settings \-\-query screens \-\-query gpus \-\-query framelocks \-\-query fans \-\-query thermalsensors \-\-query svps \-\-query dpys

.fi
را برای فهرستی از هدف‌های هر نوع هدف ببینید.
.PP
برای فعال‌سازی پشتیبانی از مشخصه‌های \(lqGPUGraphicsClockOffset\(rq و \(lqGPUMemoryTransferRateOffset\(rq، اطمینان حاصل کنید که گزینهٔ پیکربندی X مربوط به \(lqCoolbits\(rq شامل مقدار \(lq8\(rq در ماسک بیتی (bitmask) خود باشد.
برای جزئیات بیشتر، به مستندات گزینهٔ \(lqCoolbits\(rq در فایل README راه‌انداز NVIDIA مراجعه کنید.
مشخصهٔ رشته‌ای \(lqGPUPerfModes\(rq را برای مشاهدهٔ فهرستی از حالت‌های عملکرد (performance modes) موجود پرس‌وجو کنید:
.PP
.nf

	nvidia\-settings \-\-query GPUPerfModes 

.fi
.PP
هر حالت عملکرد به صورت فهرستی از جفت‌های \(lqtoken=value\(rq که با کاما از هم جدا شده‌اند نشان داده می‌شود.
هر مجموعه از نشانه‌های حالت عملکرد با یک \(lq;\(rq از هم جدا شده‌اند.
نشانهٔ \(lqperf\(rq سطح عملکرد را نشان می‌دهد.
نشانه‌های \(lq*editable\(rq مشخص می‌کنند که کدام دامنه‌ها در آن سطح عملکرد می‌توانند آفست دریافت کنند.
مشخصه‌های \(lqGPUGraphicsClockOffset\(rq و \(lqGPUMemoryTransferRateOffset\(rq به ترتیب با نشانه‌های \(lqnvclock\(rq و \(lqmemtransferrate\(rq از سطوح عملکرد در رشتهٔ \(lqGPUPerfModes\(rq متناظر هستند.
.PP
توجه داشته باشید که مشخصه‌های دستکاری کلاک \(lqGPUGraphicsClockOffset\(rq و \(lqGPUMemoryTransferRateOffset\(rq بر آفست‌های سطوح عملکرد خاصی اعمال می‌شوند.
سطح عملکرد در قلاب‌ها (براکت‌ها) پس از نام مشخصه تعیین می‌شود.
برای نمونه، جهت پرس‌وجوی \(lqGPUGraphicsClockOffset\(rq برای سطح عملکرد 2:
.PP
.nf

	nvidia\-settings \-\-query GPUGraphicsClockOffset[2]

.fi
گزینهٔ
.B \-\-assign
می‌تواند برای انتساب یک مقدار جدید به یک مشخصه به کار رود.
مقادیر معتبر برای یک مشخصه هنگام پرس‌وجوی آن گزارش می‌شوند.
نحو
.B \-\-assign
مشابه با
.B \-\-query
است، با این شرط اضافی که در انتساب‌ها، علامت مساوی و مقدار جدید نیز وجود دارند.
برای نمونه:
.nf

        nvidia\-settings \-\-assign FSAA=2
        nvidia\-settings \-\-assign [CRT\-1]/DigitalVibrance=9
        nvidia\-settings \-\-assign [gpu:0]/DigitalVibrance=0
        nvidia\-settings \-\-assign [gpu:0]/GPUGraphicsClockOffset[2]=10
.fi
.PP
می‌توان چندین پرس‌وجو و انتساب را روی خط فرمان برای یک بار فراخوانی
.B nvidia\-settings
مشخص کرد.
انتساب‌ها به ترتیبی که در خط فرمان وارد شده‌اند پردازش می‌شوند.
اگر چندین انتساب به یک مشخصهٔ یکسان، یا به چندین مشخصه با وابستگی‌ها انجام شود، انتساب‌های بعدی اولویت خواهند داشت.
.PP
اگر هر یک از گزینه‌های
.B \-\-query
یا
.B \-\-assign
به
.B nvidia\-settings
داده شوند، واسط گرافیکی (GUI) نمایش داده نخواهد شد و
.B nvidia\-settings
پس از پردازش انتساب‌ها و/یا پرس‌وجوها خارج می‌شود.
در این حالت، تنظیمات موجود در فایل پیکربندی
.I ~/.nvidia\-settings\-rc
به طور خودکار در کارساز X بارگذاری نمی‌شوند، و فایل پیکربندی
.I ~/.nvidia\-settings\-rc
نیز برای اعمال تغییرات حاصل از انتساب‌های انجام‌شده از طریق گزینهٔ
.B \-\-assign
به طور خودکار به‌روزرسانی نخواهد شد..SS "5. نام‌های X Display در فایل پیکربندی (X Display Names in the Config File)"
در بخش واسط خط فرمان در بالا اشاره شد که می‌توانید یک صفت را بدون هیچ قید X Display، تنها با یک قید X screen یا با یک نام کامل X Display مشخص کنید.
برای نمونه:
.nf

        nvidia\-settings \-\-query FSAA
        nvidia\-settings \-\-query 0/FSAA
        nvidia\-settings \-\-query alpha.example.org:0/FSAA

.fi
در دو حالت نخست، از X Display پیش‌فرض استفاده می‌شود؛ در حالت دوم، می‌توان صفحه (screen) را نسبت به X Display پیش‌فرض بازنویسی کرد، و در حالت سوم، کل X Display پیش‌فرض می‌تواند بازنویسی شود.
.PP
همین امکانات در فایل پیکربندی
.I ~/.nvidia\-settings\-rc
نیز فراهم است.
.PP
برای نمونه، در محیط یک آزمایشگاه رایانه‌ای، ممکن است به هر یک از چندین ایستگاه کاری (workstation) وارد شوید و دایرکتوری خانگی شما روی هر ایستگاه کاری از طریق NFS سوار (mount) شده باشد.
در چنین شرایطی، ممکن است بخواهید فایل
.I ~/.nvidia\-settings\-rc
شما برای همهٔ ایستگاه‌های کاری قابل اعمال باشد.
بنابراین، مایل نخواهید بود که فایل پیکربندی شما هر صفت را با یک نام X Display مقید سازد.
گزینهٔ \(lqInclude X Display Names in the Config File\(rq را در صفحهٔ پیکربندی (Configuration) برنامهٔ
.B nvidia\-settings
بدون علامت (تیک‌نخورده) رها کنید (این حالت پیش‌فرض است).
.PP
ممکن است مواردی وجود داشته باشد که بخواهید صفت‌ها در فایل پیکربندی با نام X Display مقید شوند.
اگر به کاری که انجام می‌دهید آگاهید و می‌خواهید صفت‌های فایل پیکربندی با یک X Display مشخص شوند، گزینهٔ \(lqInclude X Display Names in the Config File\(rq را در صفحهٔ پیکربندی
.B nvidia\-settings
علامت بزنید.
.PP
در محیط معمول کاربران خانگی که در آن دایرکتوری خانگی شما به‌صورت محلی روی یک رایانه قرار دارد و تنها یک X Display را پیکربندی می‌کنید، تفاوتی نمی‌کند که تنظیمات هر صفت با یک نام X Display مقید شده باشد یا خیر.
.SS "6. اتصال به سرورهای X راه دور (Connecting to Remote X Servers)"
برنامهٔ
.B nvidia\-settings
یک کلاینت X است، اما از دو اتصال X جداگانه استفاده می‌کند: یکی برای نمایش رابط گرافیکی (GUI)، و دیگری برای مخابرهٔ درخواست‌های NV-CONTROL.
نیازی نیست این دو اتصال X به یک سرور X یکسان باشند.
برای نمونه، ممکن است
.B nvidia\-settings
را روی رایانهٔ alpha.example.org اجرا کنید، تصویر نمایش را به رایانهٔ beta.example.org بفرستید (export کنید)، اما سرور X روی رایانهٔ gamma.example.org را پیکربندی نمایید:
.nf

        nvidia\-settings \-\-display=beta.example.org:0 \\
            \-\-ctrl\-display=gamma.example.org:0

.fi
اگر
.B \-\-ctrl\-display
مشخص نشده باشد، آن‌گاه X Display مورد نظر برای کنترل همان مقداری است که
.B \-\-display
تعیین می‌کند.
اگر
.B \-\-display
نیز مشخص نشده باشد، متغیر محیطی
.I $DISPLAY
به‌کار گرفته می‌شود.
.PP
با این حال، توجه داشته باشید که باید مجوزهای X به گونه‌ای پیکربندی شده باشند که بتوانید یک اتصال X از رایانه‌ای که
.B nvidia\-settings
را روی آن اجرا می‌کنید (alpha.example.org) به رایانه‌ای که GUI را نمایش می‌دهد (beta.example.org) و رایانه‌ای که X Display آن را پیکربندی می‌کنید (gamma.example.org) برقرار نمایید.
.PP
ساده‌ترین، رایج‌ترین و ناامن‌ترین سازوکار برای این کار، استفاده از \(aqxhost\(aq جهت اجازه دادن به دسترسی از سوی رایانه‌ای است که
.B nvidia\-settings
را روی آن اجرا می‌کنید.
.nf

        (issued from beta.example.org)
        xhost +alpha.example.org

        (issued from gamma.example.org)
        xhost +alpha.example.org

.fi
این کار به همهٔ کلاینت‌های X اجرا شده روی alpha.example.org اجازه می‌دهد تا متصل شده و روی سرور X رایانهٔ beta.example.org نمایش داده شوند و سرور X رایانهٔ gamma.example.org را پیکربندی نمایند.
.PP
لطفاً به صفحات راهنمای
.BR xauth (1)
و
.BR xhost (1)
مراجعه کنید، یا به مستندات سیستم خود دربارهٔ امنیت و برنامه‌های کاربردی X راه دور رجوع نمایید.
همچنین می‌توانید اصطلاحاتی مانند \(lqremote X security\(rq یا \(lqremote X Windows\(rq را در گوگل جستجو کرده و مستنداتی مانند Remote X Apps mini-HOWTO را بررسی نمایید:
.sp
.ti +5
.URL http://www.tldp.org/HOWTO/Remote-X-Apps.html
.sp
همچنین لطفاً توجه داشته باشید که سرور X راه دور که قرار است کنترل شود، باید از راه‌انداز NVIDIA X driver استفاده کند.
.SS "7. مجوزدهی (Licensing)"
کد منبع
.B nvidia\-settings
تحت مجوز GPL منتشر شده است.
تازه‌ترین نسخهٔ رسمی کد منبع در اینجا در دسترس است:
.sp
.ti +5
.URL https://download.nvidia.com/XFree86/nvidia-settings
.sp
توجه داشته باشید که
.B nvidia\-settings
صرفاً یک کلاینت NV-CONTROL است.
این برنامه از افزونهٔ NV-CONTROL سرور X برای برقراری ارتباط با سرور NVIDIA X جهت پرس‌وجوی تنظیمات فعلی و اعمال تغییرات روی آن‌ها استفاده می‌کند.
.PP
شما می‌توانید تغییرات را مستقیماً در
.B nvidia\-settings
ایجاد کنید، یا با استفاده از
.B nvidia\-settings
به‌عنوان نمونه، کلاینت NV-CONTROL اختصاصی خود را بنویسید.
.PP
مستندات مربوط به افزونهٔ NV-CONTROL و کلاینت‌های نمونهٔ بیشتر در بایگانی منبع (tarball)
.B nvidia\-settings
موجود است.
وصله‌ها (patches) را می‌توان به linux\-bugs@nvidia.com ارسال کرد.
.SS "8. کارهای در دست اقدام (TODO)"
همچنان موارد زیادی برای اضافه شدن به
.B nvidia\-settings
وجود دارد که برخی از آن‌ها عبارتند از:
.TP
\-
جعبه‌ابزارهای (toolkits) متفاوت؟
رابط کاربری گرافیکی (GUI) برای
.B nvidia\-settings
به‌روشنی از بخش پشتی (back-end)
.B nvidia\-settings
که فایل پیکربندی و خط فرمان را تجزیه کرده، با سرور X ارتباط برقرار می‌کند و غیره، تفکیک و انتزاع یافته است.
اگر کسی مایل باشد، یک GUI متفاوت در بخش کاربری (front-end) می‌تواند پیاده‌سازی شود.
.TP
\-
نوشتن یک سند طراحی که نحوهٔ طراحی
.B nvidia\-settings
را شرح دهد؛ این کار احتمالاً آشنایی افراد با پایهٔ کد (code base) را آسان‌تر خواهد کرد.
.PP
اگر موارد دیگری وجود دارد که مایلید اضافه شوند (یا بهتر از آن، خودتان می‌خواهید اضافه کنید)، لطفاً با linux\-bugs@nvidia.com تماس بگیرید..SH "فایل‌ها (FILES)"
.TP
.I ~/.nvidia\-settings\-rc
.SH "مثال‌ها (EXAMPLES)"
.TP
.B nvidia\-settings
رابط گرافیکی
.B nvidia\-settings
را راه‌اندازی می‌کند.
.TP
.B nvidia\-settings \-\-load\-config\-only
تنظیمات ذخیره‌شده در
.I ~/.nvidia\-settings\-rc
را بارگذاری کرده و خارج می‌شود.
.TP
.B nvidia\-settings \-\-rewrite\-config\-file
پیکربندی فعلی کارساز X را در فایل
.I ~/.nvidia\-settings\-rc
می‌نویسد و خارج می‌شود.
.TP
.B nvidia\-settings \-\-query FSAA
پرس‌وجوی مقدار تنظیمات full-screen antialiasing.
.TP
.B nvidia\-settings \-\-assign RedGamma=2.0 \-\-assign BlueGamma=2.0 \-\-assign GreenGamma=2.0
تنظیم گامای صفحه‌نمایش روی 2.0.
.SH "نویسندگان (AUTHORS)"
Aaron Plattner
.br
NVIDIA Corporation
.SH "همچنین ببینید (SEE ALSO)"
.BR nvidia\-xconfig (1),
.BR nvidia\-installer (1)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright \(co 2010 NVIDIA Corporation.