nvidia-xconfig - manipulate X configuration files for the NVIDIA driver

nvidia-xconfig [ options ]

nvidia-xconfig is a tool intended to provide basic control over configuration options available in the NVIDIA X driver.

nvidia-xconfig performs its operations in several steps:

1)

The system X configuration file is found and read into memory. If no configuration file can be found, nvidia-xconfig generates one from scratch using default settings; in this case, nvidia-xconfig will automatically determine the name of the X configuration file to create: /etc/X11/xorg.conf if the X server in use is X.org or /etc/X11/XF86Config if the X server in use is XFree86.

2)

The configuration in memory is modified to support the NVIDIA driver. This consists of changing the display driver to "nvidia", removing the commands to load the "GLcore" and "dri" modules, and adding the command to load the "glx" module.

3)

The configuration in memory is modified according to the options specified on the command line. Please see the NVIDIA README for a description of the NVIDIA X configuration file options. Note that nvidia-xconfig does not perform any validation of the X configuration file options requested on the command line; X configuration file option validation is left for the NVIDIA X driver.

4)

The configuration is written back to the file from which it was read. A backup of the original configuration is created with ".backup" appended. For example, if your X configuration is /etc/X11/xorg.conf then nvidia-xconfig will copy it to /etc/X11/xorg.conf.backup before writing the new configuration. The --post-tree (-T) option can be used to print the new configuration to standard out in tree form instead. This option is useful to see what nvidia-xconfig will do while leaving the original configuration intact.

-c, --xconfig=XCONFIG

Use XCONFIG as the input X config file; if this option is not specified, then the same search path used by the X server will be used to find the X configuration file.

-o, --output-xconfig=OUTPUT-XCONFIG

Use OUTPUT-XCONFIG as the output X configuration file; if this option is not specified, then the input X configuration filename will also be used as the output filename.

-s, --silent

Run silently; no messages will be printed to stdout, except for warning and error messages to stderr.

-t, --tree

Read the X configuration file, print to stdout the X configuration data in a tree , and exit.

-v, --version

Print the nvidia-xconfig version and exit.

-h, --help

Print usage information for the common commandline options and exit.

-A, --advanced-help

Print usage information for the common commandline options as well as the advanced options, and then exit.

--add-argb-glx-visuals, --no-add-argb-glx-visuals

Enables or disables support for OpenGL rendering into 32-bit ARGB windows and pixmaps.

--allow-ddcci, --no-allow-ddcci

Enables or disables DDC/CI support in the NV-CONTROL X extension.

--allow-dfp-stereo, --no-allow-dfp-stereo

Enable or disable the "AllowDFPStereo" X configuration option.

--allow-glx-with-composite, --no-allow-glx-with-composite

Enable or disable the "AllowGLXWithComposite" X configuration option.

--bandwidth-test, --no-bandwidth-test

Disable or enable the "NoBandWidthTest" X configuration option.

--composite, --no-composite

Enable or disable the "Composite" X extension.

--dac-8bit, --no-dac-8bit

Most Quadro parts by default use a 10 bit color look up table (LUT) by default; setting this option to TRUE forces these graphics chips to use an 8 bit (LUT).

--ddc, --no-ddc

Synonym for "ignore-edid"

-d, --depth=DEPTH

Set the default depth to DEPTH ; valid values for DEPTH are 8, 15, 16 and 24.

--digital-vibrance=DIGITAL-VIBRANCE

Enables digital vibrance control. Valid values for DIGITAL-VIBRANCE are 0-255.

-a, --enable-all-gpus

Configure an X screen on every GPU in the system.

--exact-mode-timings-dvi, --no-exact-mode-timings-dvi

Forces the initialization of the X server with the exact timings specified in the ModeLine.

--flip, --no-flip

Enable or disable OpenGL flipping

--force-generate

Force generation of a new X config file, ignoring any existing system X config file. This is not typically recommended, as things like the mouse protocol, keyboard layout, font paths, etc, are setup by your Unix distribution. While nvidia-xconfig can attempt to infer these values, it is best to use your Unix distribution's X config file for the basis of anything that nvidia-xconfig creates.

--force-stereo-flipping, --no-force-stereo-flipping

Normally, stereo flipping is only performed when a stereo drawable is visible. This option forces stereo flipping even when no stereo drawables are visible.

--ignore-edid, --no-ignore-edid

Disable or enable probing of EDID (Extended Display Identification Data) from your monitor.

--use-edid-freqs, --no-use-edid-freqs

Allow or disallow the X server to use the HorizSync and VertRefresh ranges given in a display device's EDID, if any. EDID provided range information will override the HorizSync and VertRefresh ranges specified in the Monitor section.

--keyboard=KEYBOARD

When generating a new X configuration file (which happens when no system X configuration file can be found, or the '--force-generate' option is specified), use KEYBOARD as the keyboard type, rather than attempting to probe the system for the keyboard type. For a list of possible keyboard types, see the '--keyboard-list' option.

--keyboard-driver=KEYBOARD-DRIVER

In most cases nvidia-xconfig can automatically determine the correct keyboard driver to use (either 'kbd' or 'keyboard'). Use this option to override what nvidia-xconfig detects. Typically, if you are using an X.org X server, use 'kdb'; if you are using an XFree86 X server, use 'keyboard'.

--keyboard-list

Print to stdout the available keyboard types recognized by the '--keyboard' option, and then exit.

--layout=LAYOUT

The nvidia-xconfig utility operates on a Server Layout within the X configuration file. If this option is specified, the layout named LAYOUT in the X configuration file will be used. If this option is not specified, the first Server Layout in the X configuration file is used.

--screen=SCREEN

The nvidia-xconfig utility operates on one or more screens within a Server Layout in the X configuration file. If this option is specified, the screen named SCREEN in the X configuration file will be used. If this option is not specified, all screens within the selected Server Layout in the X configuration file will be used used.

--load-kernel-module, --no-load-kernel-module

Allow or disallow NVIDIA Linux X driver module to load the NVIDIA Linux kernel module automatically.

--logo, --no-logo

Disable or enable the "NoLogo" X configuration option.

--mode, --no-mode=MODE

Adds or removes the specified mode from the mode list.

--mouse=MOUSE

When generating a new X configuration file (which happens when no system X configuration file can be found, or the '--force-generate' option is specified), use MOUSE as the mouse type, rather than attempting to probe the system for the mouse type. For a list of possible mouse types, see the '--mouse-list' option.

--mouse-list

Print to stdout the available mouse types recognized by the '--mouse' option, and then exit.

--multisample-compatibility, --no-multisample-compatibility

Enable or disable the use of separate front and back multisample buffers.

--nvagp=NVAGP

Set the NvAGP X config option value. Possible values are 0 (no AGP), 1 (NVIDIA's AGP), 2 (AGPGART), 3 (try AGPGART, then try NVIDIA's AGP); these values can also be specified as 'none', 'nvagp', 'agpgart', or 'any'.

--nvidia-cfg-path=NVIDIA-CFG-PATH

The nvidia-cfg library is used to communicate with the NVIDIA kernel module to query basic properties of every GPU in the system. This library is typically only used by nvidia-xconfig when configuring multiple X screens. This option tells nvidia-xconfig where to look for this library (in case it cannot find it on its own). This option should normally not be needed.

--only-one-x-screen

Disable all but one X screen.

--overlay, --no-overlay

Enable or disable the "Overlay" X configuration option.

--cioverlay, --no-cioverlay

Enable or disable the color index overlay.

--transparent-index=TRANSPARENT-INDEX

Pixel to use as transparent when using color index overlays. Valid values for TRANSPARENT-INDEX are 0-255.

--overlay-default-visual, --no-overlay-default-visual

Enable or disable the "OverlayDefaultVisual" X configuration option.

-T, --post-tree

Like the '--tree' option, but goes through the full process of applying any user requested updates to the X configuration, before printing the final configuration to stdout in a tree . Effectively, this option just causes the configuration to be printed to stdout as a tree instead of writing the results to file.

--power-connector-check, --no-power-connector-check

Disable or enable the "NoPowerConnectorCheck" X configuration option.

--query-gpu-info

Print information about all recognized NVIDIA GPUs in the system.

--randr-rotation, --no-randr-rotation

Enable or disable the "RandRRotation" X configuration option.

--rotate=ROTATE

Enable or disable the "Rotate" X configuration option. Valid values for ROTATE are 'normal', 'left', 'inverted', and 'right'.

--render-accel, --no-render-accel

Enable or disable the "RenderAccel" X configuration option.

--render-extension, --no-render-extension

Disable or enable the "NoRenderExtension" X configuration option.

--separate-x-screens, --no-separate-x-screens

A GPU that supports multiple simultaneous display devices can either drive these display devices in TwinView, or as separate X screens. When the '--separate-x-screens' option is specified, each GPU on which an X screen is currently configured will be updated to have two X screens configured. The '--no-separate-x-screens' option will remove the second configured X screen on each GPU. Please see the NVIDIA README description of "Separate X Screens on One GPU" for further details.

--sli=SLI

Enable or disable SLI. Valid values for SLI are 'Off', 'Auto', 'AFR', 'SFR', and 'SLIAA'.

--stereo=STEREO

Enable/Disable the stereo mode. Valid values for STEREO are: 1 (DCC glasses), 2 (Blueline glasses), 3 (Onboard stereo), 4 (TwinView clone mode stereo), 5 (SeeReal digital flat panel), 6 (Sharp3D digital flat panel).

--twinview, --no-twinview

Enable or disable TwinView.

--twinview-xinerama-info, --no-twinview-xinerama-info

Prohibits providing Xinerama information when in TwinView.

--ubb, --no-ubb

Enable or disable the "UBB" X configuration option.

--use-int10-module, --no-use-int10-module

Enable use of the X Int10 module to soft-boot all secondary cards, rather than POSTing the cards through the NVIDIA kernel module.

--x-prefix=X-PREFIX

The X installation prefix; the default is /usr/X11R6/. Only under rare circumstances should this option be needed.

--xinerama, --no-xinerama

Enable or disable Xinerama.

--xvmc-uses-textures, --no-xvmc-uses-textures

Forces XvMC to use the 3D engine for XvMCPutSurface requests rather than the video overlay.

nvidia-xconfig

Reads an existing X config file and adapts it to use the NVIDIA driver. If no X config file can be found, a new one is created at /etc/X11/XF86Config with default settings.

nvidia-xconfig --post-tree --twinview

Reads the existing X configuration file, adds the TwinView option, and then prints the resulting config file to standard out in tree form. The configuration file is not modified.

nvidia-xconfig --enable-all-gpus

Examines the system and configures an X screen for each display device it finds.

nvidia-xconfig --mode=1600x1200

Adds a 1600x1200 mode to an existing X configuration.

nvidia-xconfig --only-one-x-screen --sli=Auto

Configures the X server to have just one X screen that will use SLI when available.

Aaron Plattner

NVIDIA Corporation

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

Copyright © 2005 NVIDIA Corporation.