Provided by: nvidia-xconfig_1.0+20070502-1ubuntu1_i386 bug

NAME

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

SYNOPSIS

       nvidia-xconfig [ options ]

DESCRIPTION

       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.

OPTIONS

       -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 format, 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.

ADVANCED OPTIONS

       --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.

       --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 are 8, 15, 16 and
              24.

       --digital-vibrance=digital-vibrance
              Enables digital vibrance control.  Valid values 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 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
              format.   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.

       --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 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 options are ’Off’, ’Auto’, ’AFR’,
              ’SFR’, and ’SLIAA’.

       --stereo=stereo
              Enable/Disable the stereo  mode.   Valid  options  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.

EXAMPLES

       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.

AUTHOR

       Aaron Plattner
       NVIDIA Corporation

SEE ALSO

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

COPYRIGHT

       Copyright © 2005 NVIDIA Corporation.