نام (NAME)

nvidia-xconfig - دستکاری فایل‌های پیکربندی سامانه پنجره X برای درایور انویدیا (NVIDIA)

خلاصه دستور (SYNOPSIS)

nvidia-xconfig [ گزینه‌ها ]

توضیحات (DESCRIPTION)

ابزار nvidia-xconfig برنامه‌ای است که برای ارائه کنترل اولیه بر روی گزینه‌های پیکربندی موجود در درایور NVIDIA X طراحی شده است.

ابزار nvidia-xconfig عملیات خود را در چندین مرحله انجام می‌دهد:

1): فایل پیکربندی سامانه X پیدا شده و در حافظه خوانده می‌شود. اگر هیچ فایل پیکربندی یافت نشود، nvidia-xconfig با استفاده از تنظیمات پیش‌فرض یکی از ابتدا تولید می‌کند؛ در این حالت، nvidia-xconfig پیکربندی را در /etc/X11/xorg.conf می‌نویسد.
2): پیکربندی موجود در حافظه برای پشتیبانی از درایور NVIDIA اصلاح می‌شود. این کار شامل تغییر درایور نمایشگر به "nvidia"، حذف دستورات مربوط به بارگذاری ماژول‌های "GLcore" و "dri"، و افزودن دستور بارگذاری ماژول "glx" است.
3): پیکربندی موجود در حافظه بر اساس گزینه‌های مشخص‌شده در خط فرمان تغییر می‌یابد. لطفاً برای توضیحات گزینه‌های فایل پیکربندی NVIDIA X، فایل README انویدیا را ببینید. توجه داشته باشید که nvidia-xconfig هیچ‌گونه اعتبارسنجی روی گزینه‌های فایل پیکربندی X درخواست‌شده در خط فرمان انجام نمی‌دهد؛ اعتبارسنجی گزینه‌های فایل پیکربندی X به درایور NVIDIA X واگذار می‌شود.
4): پیکربندی دوباره در فایلی که از آن خوانده شده بود نوشته می‌شود. یک نسخه پشتیبان از پیکربندی اصلی با پسوند ".backup" ایجاد می‌شود. به عنوان مثال، اگر پیکربندی X شما /etc/X11/xorg.conf باشد، nvidia-xconfig پیش از نوشتن پیکربندی جدید، آن را در /etc/X11/xorg.conf.backup کپی خواهد کرد. از گزینه --post-tree (-T) می‌توان برای چاپ پیکربندی جدید در خروجی استاندارد به صورت درختی استفاده کرد. این گزینه برای مشاهده تغییراتی که nvidia-xconfig انجام خواهد داد بدون دستکاری پیکربندی اصلی، مفید است.

کد منبع nvidia-xconfig تحت مجوز GPL منتشر شده و در اینجا در دسترس است:

⟨ https://download.nvidia.com/XFree86/nvidia-xconfig ⟩

از ارسال وصله‌ها (patches) استقبال می‌شود.

گزینه‌ها (OPTIONS)

-c XCONFIG, --xconfig=XCONFIG: استفاده از XCONFIG به عنوان فایل پیکربندی ورودی X؛ اگر این گزینه مشخص نشود، از همان مسیر جستجوی سرور X برای یافتن فایل پیکربندی X استفاده خواهد شد.
-o OUTPUT-XCONFIG, --output-xconfig=OUTPUT-XCONFIG: استفاده از OUTPUT-XCONFIG به عنوان فایل پیکربندی خروجی X؛ اگر این گزینه مشخص نشود، نام فایل پیکربندی ورودی X به عنوان نام فایل پیکربندی خروجی X نیز استفاده خواهد شد.
-s, --silent: اجرای بی‌صدا؛ هیچ پیامی در خروجی استاندارد چاپ نخواهد شد، به جز پیام‌های هشدار و خطا در خطای استاندارد.
-t, --tree: خواندن فایل پیکربندی X، چاپ داده‌های پیکربندی X در فرمت درختی در خروجی استاندارد و خروج.
-v, --version: چاپ نسخه nvidia-xconfig و خروج.
-h, --help: چاپ اطلاعات کاربرد برای گزینه‌های رایج خط فرمان و خروج.
-A, --advanced-help: چاپ اطلاعات کاربرد برای گزینه‌های رایج و پیشرفته خط فرمان و سپس خروج.

گزینه‌های پیشرفته (ADVANCED OPTIONS)

--acpid-socket-path=ACPID-SOCKET-PATH, --no-acpid-socket-path: تنظیم این گزینه برای مشخص کردن یک مسیر جایگزین برای سوکت دیمن لینوکس ACPI (acpid)، که درایور NVIDIA X برای اتصال به acpid از آن استفاده خواهد کرد.
--add-argb-glx-visuals, --no-add-argb-glx-visuals: فعال یا غیرفعال کردن پشتیبانی از رندر OpenGL درون پنجره‌ها و pixmapهای ۳۲ بیتی ARGB.
--allow-glx-with-composite, --no-allow-glx-with-composite: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "AllowGLXWithComposite".
--busid=BUSID, --no-busid: نوشتن BusID مشخص‌شده در بخش device از فایل پیکربندی X. اگر چندین بخش device وجود داشته باشد، فیلد BusID را به هر یک از آن‌ها اضافه می‌کند. برای افزودن BusID تنها به یک بخش device یا screen خاص، از گزینه‌های '--device' یا '--screen' استفاده کنید.
--preserve-busid, --no-preserve-busid: به طور پیش‌فرض، nvidia-xconfig تنها در صورتی که چندین صفحه X برای سرور X پیکربندی شده باشند BusID موجود در فایل پیکربندی X را حفظ می‌کند. برای اجبار به حفظ یا عدم حفظ BusID و لغو رفتار پیش‌فرض، از '--preserve-busid' یا '--no-preserve-busid' استفاده کنید.
--cool-bits=COOL-BITS, --no-cool-bits: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "Coolbits". تنظیم این گزینه باعث فعال‌سازی پشتیبانی در افزونه NV-CONTROL سامانه X برای دستکاری فرکانس ساعت GPU و تنظیمات کنترل فن GPU می‌شود. مقدار پیش‌فرض 0 است. برای کنترل فن آن را روی 4 تنظیم کنید. هشدار: این کار ممکن است باعث آسیب به سیستم و باطل شدن گارانتی شود.
--composite, --no-composite: فعال یا غیرفعال کردن اکستنشن X با نام "Composite".
--connected-monitor=CONNECTED-MONITOR, --no-connected-monitor: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ConnectedMonitor"؛ تنظیم این گزینه درایور X را مجبور می‌کند طوری رفتار کند که گویی دستگاه‌های نمایشگر مشخص‌شده به GPU متصل هستند.
--connect-to-acpid, --no-connect-to-acpid: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ConnectToAcpid". اگر این گزینه تنظیم شود، درایور NVIDIA X تلاش می‌کند تا به دیمن لینوکس ACPI (acpid) متصل شود. این گزینه را خاموش کنید تا مانع تلاش درایور X برای اتصال به acpid شوید.
--constant-dpi, --no-constant-dpi: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ConstantDPI"، که کنترل می‌کند آیا درایور NVIDIA X با محاسبه مجدد اندازه گزارش‌شده صفحه X بر حسب میلی‌متر هنگام تغییر اندازه صفحه به پیکسل توسط XRandR، مقدار ثابت نقطه در اینچ (DPI) را حفظ کند یا خیر.
--custom-edid=CUSTOM-EDID, --no-custom-edid: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "CustomEDID"؛ تنظیم این گزینه درایور X را وادار به استفاده از EDID مشخص‌شده می‌کند. این گزینه فهرستی از جفت‌های نام دستگاه نمایشگر و نام فایل جداشده با نقطه ویرگول است؛ مانند "CRT-0:mp\did.bin". توجه داشته باشید که نام دستگاه نمایشگر حتی در صورت مشخص شدن تنها یک EDID باید حتماً تعیین شود.
--dac-8bit, --no-dac-8bit: بیشتر کارت‌های Quadro به طور پیش‌فرض از جدول جستجوی رنگ ۱۰ بیتی (LUT) استفاده می‌کنند؛ تنظیم این گزینه روی TRUE این تراشه‌های گرافیکی را مجبور به استفاده از یک LUT هشت بیتی می‌کند.
-d DEPTH, --depth=DEPTH: تنظیم عمق رنگ پیش‌فرض روی DEPTH ؛ مقادیر معتبر برای DEPTH عبارتند از 8، 15، 16، 24 و 30.
--device=DEVICE: ابزار nvidia-xconfig بر روی یک یا چند دستگاه در فایل پیکربندی X عمل می‌کند. اگر این گزینه مشخص شود، از دستگاه با نام DEVICE در فایل پیکربندی X استفاده خواهد شد. در صورت عدم تعیین، تمامی دستگاه‌های درون فایل پیکربندی X استفاده می‌شوند.
--disable-glx-root-clipping, --no-disable-glx-root-clipping: غیرفعال یا فعال کردن برش (clipping) رندرینگ OpenGL به پنجره ریشه از طریق گزینه پیکربندی X با نام "DisableGLXRootClipping".
--damage-events, --no-damage-events: استفاده از رویدادهای سطح سیستم‌عامل برای مطلع کردن سرور X در زمانی که یک کلاینت direct-rendering عملیات رندری را انجام داده که باید روی صفحه ترکیب شود. عملکرد را هنگام استفاده از GLX به همراه افزونه composite بهبود می‌بخشد.
--preserve-driver-name: به طور پیش‌فرض nvidia-xconfig درایور نمایشگر را برای تمام صفحه‌های X پیکربندی‌شده به "nvidia" تغییر می‌دهد؛ این گزینه نام درایور موجود برای هر صفحه X را حفظ می‌کند.
--egpu, --no-egpu: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "AllowExternalGpus".
-a, --enable-all-gpus: حذف تمام صفحه‌های X موجود در پیکربندی فعلی، و سپس پیکربندی یک صفحه X بر روی هر GPU موجود در سیستم شما.
--exact-mode-timings-dvi, --no-exact-mode-timings-dvi: اجبار به مقداردهی اولیه سرور X با زمان‌بندی‌های دقیق مشخص‌شده در ModeLine.
-E FILE, --extract-edids-from-file=FILE: استخراج تمام بلوک‌های بایتی خام EDID موجود در فایل لاگ X مشخص‌شده LOG ؛ بایت‌های خام EDID توسط درایور NVIDIA X هنگام فعال بودن ثبت گزارش با جزئیات بالا با گزینه خط فرمان "-logverbose 6"; سرور X به صورت هگزادسیمال در لاگ X چاپ می‌شوند. هر EDID استخراج‌شده سپس به صورت داده‌های باینری در فایل‌های جداگانه نوشته می‌شود. این فایل‌ها بعداً می‌توانند توسط درایور NVIDIA X از طریق گزینه پیکربندی "CustomEDID" استفاده شوند.
--extract-edids-output-file=FILENAME: هنگام استفاده از گزینه '--extract-edids-from-file'، ابزار nvidia-xconfig هر EDID استخراج‌شده را در یک فایل، معمولاً "edid.bin" در دایرکتوری جاری می‌نویسد. از این گزینه برای مشخص کردن یک نام فایل جایگزین استفاده کنید. توجه داشته باشید که nvidia-xconfig در صورت نیاز یک شماره منحصر‌به‌فرد به انتهای نام فایل EDID می‌افزاید تا از بازنویسی روی فایل‌های موجود جلوگیری کند (مثلاً "edid.bin.1" در صورتی که "edid.bin" از قبل وجود داشته باشد).
--flatpanel-properties=FLATPANEL-PROPERTIES, --no-flatpanel-properties: تنظیم ویژگی‌های صفحه نمایش تخت (flat panel). ویژگی‌های پشتیبانی‌شده عبارتند از 'dithering' و 'ditheringmode'. لطفاً برای جزئیات بیشتر در مورد مقادیر ممکن و نحو، به 'پیوست B: گزینه‌های پیکربندی X' در فایل README انویدیا مراجعه کنید.
--flip, --no-flip: فعال یا غیرفعال کردن ورق زدن (flipping) در OpenGL.
--force-generate: اجبار به تولید یک فایل پیکربندی جدید X، با نادیده گرفتن هر فایل پیکربندی موجود در سیستم. این کار معمولاً توصیه نمی‌شود، زیرا مواردی مانند پروتکل ماوس، چیدمان صفحه‌کلید، مسیرهای قلم‌ها و غیره توسط توزیع یونیکس شما تنظیم می‌شوند. اگرچه nvidia-xconfig می‌تواند برای استنباط این مقادیر تلاش کند، اما بهتر است از فایل پیکربندی X توزیع یونیکس خود به عنوان پایه هر آنچه nvidia-xconfig ایجاد می‌کند استفاده کنید.
--force-stereo-flipping, --no-force-stereo-flipping: به طور معمول، ورق زدن استریو تنها زمانی انجام می‌شود که یک شیء قابل رسم استریو قابل مشاهده باشد. این گزینه ورق زدن استریو را حتی زمانی که هیچ شیء قابل رسم استریویی نمایان نیست اجبار می‌کند.
--handle-special-keys=WHEN, --no-handle-special-keys: تعیین اینکه چه زمانی سرور X باید از گرداننده صفحه‌کلید توکار برای پردازش ترکیب کلیدهای خاص (مانند Ctrl+Alt+Backspace) استفاده کند؛ برای جزئیات به صفحه راهنمای پیکربندی X مراجعه کنید. مقدار WHEN می‌تواند 'Always'، 'Never' یا 'WhenNeeded' باشد.
--include-implicit-metamodes, --no-include-implicit-metamodes: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "IncludeImplicitMetaModes".
--keyboard=KEYBOARD: هنگام تولید یک فایل پیکربندی جدید X (که در صورت پیدا نشدن فایل پیکربندی سیستمی یا مشخص شدن گزینه '--force-generate' رخ می‌دهد)، به جای تلاش برای بررسی سیستم جهت یافتن نوع صفحه‌کلید، از KEYBOARD به عنوان نوع صفحه‌کلید استفاده شود. برای فهرستی از انواع صفحه‌کلیدهای ممکن، گزینه '--keyboard-list' را ببینید.
--keyboard-driver=DRIVER: در اکثر موارد nvidia-xconfig می‌تواند به طور خودکار درایور صفحه‌کلید مناسب (یا 'kbd' یا 'keyboard') را تعیین کند. از این گزینه برای بازنویسی آنچه nvidia-xconfig شناسایی می‌کند استفاده کنید. معمولاً اگر از سرور X.Org استفاده می‌کنید 'kbd'، و اگر از سرور XFree86 استفاده می‌کنید از 'keyboard' استفاده کنید.
--keyboard-list: چاپ انواع صفحه‌کلیدهای موجود و شناخته‌شده توسط گزینه '--keyboard' در خروجی استاندارد و سپس خروج.
--layout=LAYOUT: ابزار nvidia-xconfig بر روی یک Server Layout درون فایل پیکربندی X عمل می‌کند. اگر این گزینه مشخص شود، از چیدمان با نام LAYOUT در فایل پیکربندی X استفاده خواهد شد. در صورت عدم تعیین، اولین Server Layout در فایل پیکربندی X استفاده می‌شود.
--mode=MODE: افزودن حالت مشخص‌شده به فهرست حالت‌ها.
--mode-debug, --no-mode-debug: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ModeDebug"؛ در صورت فعال بودن، این گزینه باعث می‌شود درایور X جزئیات کاملی درباره اعتبارسنجی حالت در فایل لاگ X چاپ کند.
--mode-list=MODELIST: حذف تمام حالت‌های موجود از فهرست حالت‌های پیکربندی X و افزودن حالت(های) مشخص‌شده در رشته MODELIST
--remove-mode=MODE: حذف حالت مشخص‌شده از فهرست حالت‌ها.
--metamodes=METAMODES: افزودن گزینه پیکربندی MetaMode در X با مقدار METAMODES که جایگزین هر گزینه MetaMode موجود در فایل پیکربندی X خواهد شد.
--mouse=MOUSE: هنگام تولید یک فایل پیکربندی جدید X (که در صورت پیدا نشدن فایل پیکربندی سیستمی یا مشخص شدن گزینه '--force-generate' رخ می‌دهد)، به جای تلاش برای بررسی سیستم جهت یافتن نوع ماوس، از MOUSE به عنوان نوع ماوس استفاده شود. برای فهرستی از انواع ماوس‌های ممکن، گزینه '--mouse-list' را ببینید.
--mouse-list: چاپ انواع ماوس‌های موجود و شناخته‌شده توسط گزینه '--mouse' در خروجی استاندارد و سپس خروج.
--multisample-compatibility, --no-multisample-compatibility: فعال یا غیرفعال کردن استفاده از بافرهای چندنمونه‌برداری (multisample) جداگانه جلو و عقب.
--nvidia-cfg-path=PATH: کتابخانه nvidia-cfg برای برقراری ارتباط با ماژول هسته NVIDIA جهت پرس‌وجوی ویژگی‌های اولیه هر GPU در سیستم استفاده می‌شود. این کتابخانه معمولاً فقط زمانی توسط nvidia-xconfig استفاده می‌شود که چندین صفحه X پیکربندی شوند. این گزینه به nvidia-xconfig می‌گوید که کجا به دنبال این کتابخانه بگردد (در صورتی که نتواند خود آن را پیدا کند). این گزینه در حالت عادی نباید مورد نیاز باشد.
--only-one-x-screen: غیرفعال کردن همه صفحه‌های X به جز یکی.
--overlay, --no-overlay: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "Overlay".
--cioverlay, --no-cioverlay: فعال یا غیرفعال کردن همپوشانی شاخص رنگ (color index overlay).
--overlay-default-visual, --no-overlay-default-visual: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "OverlayDefaultVisual".
--transparent-index=INDEX, --no-transparent-index: پیکسلی که هنگام استفاده از اورلی‌های شاخص رنگ به عنوان شفاف استفاده می‌شود. مقادیر معتبر برای TRANSPARENT-INDEX از 0 تا 255 هستند.
-T, --post-tree: مانند گزینه '--tree'، اما کل فرآیند اعمال به‌روزرسانی‌های درخواستی کاربر روی پیکربندی X را طی می‌کند، پیش از آنکه پیکربندی نهایی را در قالب درختی در خروجی استاندارد چاپ کند. در عمل، این گزینه صرفاً باعث می‌شود پیکربندی به جای نوشتن نتایج در فایل، به صورت درخت در خروجی استاندارد چاپ شود.
--power-connector-check, --no-power-connector-check: غیرفعال یا فعال کردن گزینه پیکربندی X با نام "NoPowerConnectorCheck".
--probe-all-gpus, --no-probe-all-gpus: غیرفعال یا فعال کردن گزینه پیکربندی X با نام "ProbeAllGpus".
--query-gpu-info: چاپ اطلاعات درباره تمام پردازنده‌های گرافیکی NVIDIA شناخته‌شده در سیستم.
--registry-dwords=REGISTRY-DWORDS, --no-registry-dwords: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "RegistryDwords".
--render-accel, --no-render-accel: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "RenderAccel".
--render-extension, --no-render-extension: غیرفعال یا فعال کردن گزینه پیکربندی X با نام "NoRenderExtension".
--screen=SCREEN: ابزار nvidia-xconfig بر روی یک یا چند صفحه در یک Server Layout در فایل پیکربندی X عمل می‌کند. اگر این گزینه مشخص شود، از صفحه با نام SCREEN در فایل پیکربندی X استفاده خواهد شد. در صورت عدم تعیین، تمامی صفحه‌های درون Server Layout انتخاب‌شده در فایل پیکربندی X استفاده خواهند شد.
--separate-x-screens, --no-separate-x-screens: یک GPU که از چندین دستگاه نمایشگر هم‌زمان پشتیبانی می‌کند، می‌تواند این دستگاه‌ها را در یک صفحه X واحد یا به صورت صفحه‌های X جداگانه راه‌اندازی کند. هنگامی که گزینه '--separate-x-screens' مشخص شود، هر GPU که یک صفحه X در حال حاضر روی آن پیکربندی شده است، به‌روزرسانی می‌شود تا دارای دو یا چند صفحه X پیکربندی‌شده باشد (بسته به توانایی‌های آن GPU). گزینه '--no-separate-x-screens' هرگونه صفحه X پیکربندی‌شده اضافی را در هر GPU حذف می‌کند. لطفاً برای جزئیات بیشتر به توضیحات "Separate X Screens on One GPU" در README انویدیا مراجعه کنید.
--x-screens-per-gpu=X-SCREENS-PER-GPU: یک GPU که از چندین دستگاه نمایشگر هم‌زمان پشتیبانی می‌کند، می‌تواند این دستگاه‌ها را در یک صفحه X واحد یا به صورت صفحه‌های X جداگانه هدایت کند. هنگامی که گزینه '--x-screens-per-gpu=<quantity>' مشخص شود، هر GPU که یک صفحه X در حال حاضر روی آن پیکربندی شده است، برای داشتن <quantity> صفحه X به‌روزرسانی خواهد شد. مقدار <quantity> باید بزرگ‌تر از 0 باشد. تنظیم <quantity> روی 1 معادل تعیین گزینه '--no-separate-x-screens' است. لطفاً برای جزئیات بیشتر به توضیحات "Separate X Screens on One GPU" در README انویدیا مراجعه کنید.
--sli=SLI, --no-sli: فعال یا غیرفعال کردن SLI. مقادیر معتبر برای SLI عبارتند از 'Off' و 'Mosaic'.
--stereo=STEREO, --no-stereo: فعال یا غیرفعال کردن حالت استریو (سه‌بعدی). مقادیر معتبر برای STEREO عبارتند از: 0 (غیرفعال)، 1 (عینک‌های DDC)، 2 (عینک‌های Blueline)، 3 (استریوی آنبورد)، 4 (استریوی حالت کلون چندنمایشگری)، 5 (نمایشگر تخت دیجیتال SeeReal)، 6 (نمایشگر تخت دیجیتال Sharp3D)، 7 (Arisawa/Hyundai/Zalman/Pavione/Miracube)، 8 (3D DLP)، 9 (3D DLP INV)، 10 (NVIDIA 3D VISION)، 11 (NVIDIA 3D VISION PRO)، 12 (HDMI 3D)، 13 (Tridelity SL).
--thermal-configuration-check, --no-thermal-configuration-check: غیرفعال یا فعال کردن گزینه پیکربندی X با نام "ThermalConfigurationCheck".
--metamode-orientation=ORIENTATION, --no-metamode-orientation: تعیین جهت MetaModeOrientation. مقادیر معتبر برای ORIENTATION عبارتند از: "RightOf" (پیش‌فرض)، "LeftOf"، "Above"، "Below" یا "Clone".
--nvidia-xinerama-info, --no-nvidia-xinerama-info: فعال یا غیرفعال کردن ارائه اطلاعات Xinerama از درایور NVIDIA X.
--nvidia-xinerama-info-order=NVIDIA-XINERAMA-INFO-ORDER, --no-nvidia-xinerama-info-order: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "nvidiaXineramaInfoOrder". NVIDIA-XINERAMA-INFO-ORDER فهرستی از نام‌های دستگاه‌های نمایشگر جداشده با کاما است که ترتیبی را توصیف می‌کند که در آن nvidiaXineramaInfo باید گزارش شود؛ برای مثال: "CRT, DFP, TV".
--ubb, --no-ubb: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "UBB".
--use-edid, --no-use-edid: فعال یا غیرفعال کردن استفاده از EDID (داده‌های شناسایی گسترده نمایشگر) از دستگاه(های) نمایشگر شما. از EDID برای عملیات درایور مانند ساخت فهرست‌های حالت‌های موجود، تعیین دامنه‌های فرکانس معتبر و محاسبه DPI استفاده خواهد شد. این گزینه به طور پیش‌فرض روی TRUE است (درایور NVIDIA X در صورت در دسترس بودن از EDID استفاده خواهد کرد). توصیه نمی‌شود که از این گزینه برای غیرفعال کردن سراسری EDID استفاده کنید؛ در عوض، از '--no-use-edid-freqs' یا '--no-use-edid-dpi' برای غیرفعال کردن کاربردهای خاص EDID استفاده نمایید.
--use-edid-dpi, --no-use-edid-dpi: فعال یا غیرفعال کردن استفاده از اطلاعات اندازه فیزیکی در EDID دستگاه نمایشگر برای محاسبه DPI صفحه X. این گزینه به طور پیش‌فرض روی TRUE است (درایور NVIDIA X از اندازه فیزیکی EDID در صورت وجود برای محاسبه DPI استفاده می‌کند).
--use-edid-freqs, --no-use-edid-freqs: فعال یا غیرفعال کردن استفاده از دامنه‌های HorizSync و VertRefresh داده‌شده در EDID دستگاه نمایشگر. اطلاعات دامنه ارائه‌شده توسط EDID بر دامنه‌های مشخص‌شده در بخش Monitor اولویت خواهد داشت. این گزینه به طور پیش‌فرض روی TRUE است (درایور NVIDIA X از اطلاعات فرکانس EDID در صورت وجود استفاده خواهد کرد).
--use-display-device=DISPLAY-DEVICE, --no-use-display-device: اجبار درایور X به استفاده از دستگاه نمایشگر مشخص‌شده.
--use-events, --no-use-events: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "UseEvents". تنظیم این گزینه درایور X را قادر می‌سازد در برخی موارد که منتظر سخت‌افزار است از رویدادهای سیستم استفاده کند. با این گزینه، درایور X یک گرداننده رویداد تنظیم کرده و از طریق فراخوانی سیستمی ()poll منتظر سخت‌افزار می‌ماند. این گزینه به طور پیش‌فرض روی FALSE است.
--virtual=WIDTHxHEIGHT, --no-virtual: مشخص کردن وضوح صفحه مجازی.
--x-prefix=X-PREFIX: پیشوند نصب X؛ پیش‌فرض /usr/X11R6/ است. تنها در شرایط نادر ممکن است به این گزینه نیاز باشد.
--color-space=COLORSPACE, --no-color-space: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ColorSpace". مقادیر معتبر برای "COLORSPACE" عبارتند از: "RGB" و "YCbCr444".
--color-range=COLORRANGE, --no-color-range: تنظیم گزینه پیکربندی X با نام "ColorRange". مقادیر معتبر برای "COLORRANGE" عبارتند از: "Full" و "Limited".
--3dvision-usb-path=3DVISION-USB-PATH: تنظیم این گزینه برای مشخص کردن مسیر sysfs دانگل USB متصل‌شده.
--3dvisionpro-config-file=3DVISIONPRO-CONFIG-FILE: تنظیم این گزینه برای مشخص کردن فایل پیکربندی NVIDIA 3DVisionPro. اطمینان حاصل کنید که سرور X دارای مجوزهای دسترسی خواندن و نوشتن به این فایل باشد. درایور NVIDIA X تنظیمات هاب و جفت‌سازی را در این فایل ذخیره می‌کند تا در راه‌اندازی‌های مجدد X استفاده شود. اگر این گزینه ارائه نشود، پیکربندی 3D VisionPro ذخیره نخواهد شد.
--3dvision-display-type=3DVISION-DISPLAY-TYPE, --no-3dvision-display-type: هنگامی که NVIDIA 3D Vision با نمایشگری فعال شده که آماده 3D Vision نیست، از این گزینه برای تعیین نوع نمایشگر استفاده کنید. مقادیر معتبر عبارتند از: 0 (فرض CRT بودن)، 1 (فرض DLP بودن) و 2 (فرض تلویزیون DLP بودن و فعال کردن خروجی شطرنجی).
--base-mosaic, --no-base-mosaic: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "BaseMosaic".
--restore-original-backup: بازیابی نسخه پشتیبان از پیکربندی X که قبل از اعمال هرگونه تغییر توسط nvidia-xconfig ایجاد شده بود، در صورتی که چنین پشتیبانی در دسترس باشد. این نوع پشتیبان توسط nvidia-xconfig پیش از اصلاح فایل پیکربندی X که پیش‌تر به آن دست نزده بود ایجاد می‌شود؛ فرض بر این است که این فایل پیکربندی مربوط به پیش از دخالت درایور NVIDIA X است. به عنوان مثال، nvidia-xconfig در اولین باری که تغییراتی در /etc/X11/xorg.conf ایجاد می‌کند، یک کپی از آن را در /etc/X11/xorg.conf.nvidia-xconfig-original قرار می‌دهد.
--allow-empty-initial-configuration, --no-allow-empty-initial-configuration: اجازه شروع به سرور X حتی اگر هیچ دستگاه نمایشگر متصلی شناسایی نشود.
--inband-stereo-signaling, --no-inband-stereo-signaling: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "InbandStereoSignaling".
--force-yuv-420, --no-force-yuv-420: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ForceYUV420". اگر نمایشگر فعلی و GPU هر دو از خروجی فشرده‌نشده RGB 4:4:4 و خروجی فشرده YUV 4:2:0 با حالت جاری پشتیبانی کنند، خروجی RGB 4:4:4 به طور پیش‌فرض انتخاب می‌شود. این گزینه استفاده از خروجی YUV 4:2:0 را (در صورت پشتیبانی) اجبار می‌کند.
--force-composition-pipeline=FORCE-COMPOSITION-PIPELINE, --no-force-composition-pipeline: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ForceCompositionPipeline".
--force-full-composition-pipeline=FORCE-FULL-COMPOSITION-PIPELINE, --no-force-full-composition-pipeline: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "ForceFullCompositionPipeline".
--allow-hmd=ALLOW-HMD, --no-allow-hmd: فعال یا غیرفعال کردن گزینه پیکربندی X با نام "AllowHMD".
--prime, --no-prime: فعال‌سازی PRIME برای فایل پیکربندی تولیدشده X. نمی‌توان آن را به همراه --no-busid یا --no-allow-empty-initial-configuration اجرا کرد. در سیستمی با بیش از ۱ پردازنده گرافیکی (GPU)، پردازنده مورد نظر برای PRIME را با --busid مشخص کنید؛ در غیر این صورت اولین مورد در دسترس انتخاب خواهد شد. توجه داشته باشید که برای فعال‌سازی PRIME اجرای دستورات "xrandr --setprovideroutputsource modesetting NVIDIA-0" و "xrandr --auto" پس از اتمام کار الزامی است.

مثال‌ها (EXAMPLES)

nvidia-xconfig: یک فایل پیکربندی موجود X را خوانده و آن را برای استفاده از درایور NVIDIA مطابقت می‌دهد. اگر هیچ فایل پیکربندی X یافت نشود، یک فایل جدید در /etc/X11/xorg.conf با تنظیمات پیش‌فرض ایجاد می‌شود.
nvidia-xconfig --post-tree --metamode-orientation=clone: فایل پیکربندی موجود X را خوانده، گزینه MetaModeOrientation را اضافه می‌کند، و سپس فایل پیکربندی حاصل را به صورت درختی در خروجی استاندارد چاپ می‌کند. فایل پیکربندی تغییر نمی‌یابد.
nvidia-xconfig --enable-all-gpus: سیستم را بررسی کرده و برای هر دستگاه نمایشگری که پیدا کند یک صفحه X پیکربندی می‌کند.
nvidia-xconfig --mode=1600x1200: یک حالت 1600x1200 به پیکربندی موجود X اضافه می‌کند.
nvidia-xconfig --mode-list=1600x1200 1280x1024: تمام حالت‌های موجود را از فایل پیکربندی X حذف کرده و آن‌ها را با "1600x1200" و "1280x1024" جایگزین می‌کند.
nvidia-xconfig --metamodes=1024x768 +0+0, 1024x768 +1024+0: حالت MetaMode با مقدار "1024x768 +0+0, 1024x768 +1024+0" را به فایل پیکربندی موجود X اضافه کرده و جایگزین هر گزینه MetaModes موجود در فایل پیکربندی X می‌کند.
nvidia-xconfig --only-one-x-screen --sli=Auto: سرور X را طوری پیکربندی می‌کند که تنها یک صفحه X داشته باشد که در صورت در دسترس بودن از SLI استفاده خواهد کرد.

نویسنده (AUTHOR)

Aaron Plattner
NVIDIA Corporation

همچنین ببینید (SEE ALSO)

nvidia-settings(1), /usr/share/doc/NVIDIA_GLX-1.0/README.txt

حق نشر (COPYRIGHT)

2026-07-29

nvidia-xconfig 610.57.04