NAME

SYNOPSIS

DESCRIPTION

nv
is an Xorg driver for NVIDIA video cards. The driver supports 2D
acceleration and provides support for the following framebuffer depths:
8, 15, 16 (except Riva128) and 24. All
visual types are supported for depth 8, TrueColor and DirectColor
visuals are supported for the other depths with the exception of
the Riva128 which only supports TrueColor in the higher depths.

SUPPORTED HARDWARE

The
nv
driver supports PCI, PCI-Express and AGP video cards based on the following NVIDIA chips:

RIVA 128

NV3

RIVA TNT

NV4

RIVA TNT2

NV5

GeForce 256, QUADRO

NV10

GeForce2, QUADRO2

NV11 & NV15

GeForce3, QUADRO DCC

NV20

nForce, nForce2

NV1A, NV1F

GeForce4, QUADRO4

NV17, NV18, NV25, NV28

GeForce FX, QUADRO FX

NV30, NV31, NV34, NV35, NV36, NV37, NV38

GeForce 6XXX

NV40, NV41, NV43, NV44, NV45, C51

GeForce 7XXX

G70, G71, G72, G73

GeForce 8XXX

G80, G84, G86

CONFIGURATION DETAILS

Please refer to xorg.conf(5) for general configuration
details. This section only covers configuration details specific to this
driver.

The driver auto-detects the chipset type and the amount of video memory
present for all chips.

The following driver
Options
are supported for pre-G80 hardware:

Option N'34'HWCursorN'34' N'34'booleanN'34'

Enable or disable the HW cursor. Default: on.

Option N'34'NoAccelN'34' N'34'booleanN'34'

Disable or enable acceleration. Default: acceleration is enabled.

Option N'34'UseFBDevN'34' N'34'booleanN'34'

Enable or disable use of an OS-specific fb interface (and is not supported
on all OSs). See fbdevhw(4) for further information.
Default: off.

Option N'34'CrtcNumberN'34' N'34'integerN'34'

Many graphics cards with NVIDIA chips have two video outputs.
The driver attempts to autodetect
which one the monitor is connected to. In the case that autodetection picks
the wrong one, this option may be used to force usage of a particular output.
The options are "0" or "1".
Default: autodetected.

Option N'34'DualheadN'34' N'34'booleanN'34'

Enables simple VBE-based dual head mode.
This sets the same resolution on both outputs and lays them out side-by-side.
The screens will be panned together as one big metamode if the virtual desktop is larger than both screens combined.

Option N'34'FlatPanelN'34' N'34'booleanN'34'

The driver usually can autodetect the presence of a digital flat panel. In
the case that this fails, this option can be used to force the driver to
treat the attached device as a digital flat panel. With this
driver, a digital flat panel will work only if it was POSTed by the BIOS,
that is, the computer
must have booted to the panel. If you have a dual head card
you may also need to set the option CrtcNumber described above.
Default: autodetected.

Option N'34'FPDitherN'34' N'34'booleanN'34'

Many digital flat panels (particularly ones on laptops) have only 6 bits
per component color resolution.
This option tells the driver to dither from 8 bits per component to 6 before
the flat panel truncates it.
Default: off.

Option N'34'FPScaleN'34' N'34'booleanN'34'

Supported only on GeForce4 and newer chips, this option
tells to the driver to scale lower resolutions up to the flat panel's native
resolution. Default: on.

Option N'34'RotateN'34' N'34'CWN'34'

Option N'34'RotateN'34' N'34'CCWN'34'

Rotate the display clockwise or counterclockwise. This mode is unaccelerated.
Default: no rotation.

Note: The Resize and Rotate extension will be disabled if the Rotate "CW" or
Rotate "CCW" options are used.

Option N'34'RotateN'34' N'34'RandRN'34'

Enable rotation of the screen using the Resize and Rotate extension.
This mode is unaccelerated.
Default: no rotation support.

Option N'34'ShadowFBN'34' N'34'booleanN'34'

Enable or disable use of the shadow framebuffer layer. Default: off.

The following driver
Options
are available for G80 and higher:

Option N'34'HWCursorN'34' N'34'booleanN'34'

Enable or disable the hardware cursor. Default: on.

Option N'34'NoAccelN'34' N'34'booleanN'34'

Disable or enable acceleration. Default: acceleration is enabled.

Option N'34'AccelMethodN'34' N'34'stringN'34'

Choose acceleration architecture, either N'34'XAAN'34' or N'34'EXAN'34'.
XAA is the old but stable architecture.
EXA is newer and supports resizing the desktop larger than it started out with RandR 1.2.
If you choose to use EXA, you might also consider setting
Option N'34'MigrationHeuristicN'34' N'34'greedyN'34'
to improve performance.
Default: XAA.

Option N'34'FPDitherN'34' N'34'booleanN'34'

Enable or disable flat panel dithering by default.
Dithering can also be enabled or disabled using the RandR 1.2 N'34'ditherN'34' output property.
Default: off.

The following RandR 1.2 properties are available for flat panels on G80 and higher GPUs:

Control how the image is scaled to fit the flat panel.
Note that some flat panels perform their own scaling, overriding this option.
N'34'offN'34'
is not valid for laptop flat panels (LVDS).
Valid values:
N'34'offN'34', N'34'aspectN'34', N'34'fillN'34', and N'34'centerN'34'.
Default:
N'34'aspectN'34'.

SEE ALSO

AUTHORS

COPYRIGHT

Copyright (c) 2003 - 2007 NVIDIA, Corporation

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.