NV(4) Device and Network Interfaces NV(4)

NAME

nv - NVIDIA video driver

SYNOPSIS

Section "Device"
Identifier "devname"
Driver "nv"
...
EndSection

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, MCP6x

GeForce 8XXX, GeForce 9XXX, nForce 7, GeForce G, ION
G8x, G9x, GT21x, MCP7x

GeForce GTX GT200

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 "HWCursor" "boolean"
Enable or disable the HW cursor. Default: on.

Option "NoAccel" "boolean"
Disable or enable acceleration. Default: acceleration is
enabled.

Option "UseFBDev" "boolean"
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 "CrtcNumber" "integer"
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 "Dualhead" "boolean"
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 "FlatPanel" "boolean"
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 "FPDither" "boolean"
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 "FPScale" "boolean"
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 "Rotate" "CW"

Option "Rotate" "CCW"
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 "Rotate" "RandR"
Enable rotation of the screen using the Resize and Rotate
extension. This mode is unaccelerated. Default: no rotation
support.

Option "ShadowFB" "boolean"
Enable or disable use of the shadow framebuffer layer.
Default: off.

The following driver Options are available for G80 and higher:

Option "HWCursor" "boolean"
Enable or disable the hardware cursor. Default: on.

Option "NoAccel" "boolean"
Disable or enable acceleration. Default: acceleration is
enabled.

Option "AccelMethod" "string"
Choose acceleration architecture, either "XAA" or "EXA". 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 "MigrationHeuristic" "greedy" to improve
performance. Default: XAA.

Option "FPDither" "boolean"
Enable or disable flat panel dithering by default. Dithering
can also be enabled or disabled using the RandR 1.2 "dither"
output property. Default: off.

Option "AllowDualLinkModes" "boolean"
Allow validation of dual-link DVI modes. Not all GPUs are
configured at boot time to be able to handle dual-link modes,
so they are disabled by default.

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

dither Enable or disable flat panel dithering. Valid values: 0
(off), 1 (on).

scale Control how the image is scaled to fit the flat panel. Note
that some flat panels perform their own scaling, overriding
this option. "off" is not valid for laptop flat panels
(LVDS). Valid values: "off", "aspect", "fill", and "center".
Default: "aspect".

SEE ALSO

Xorg(1), xorg.conf(5), Xserver(1), X(7), xrandr(1)

AUTHORS

Authors include: David McKay, Jarno Paananen, Chas Inman, Dave
Schmenk, Mark Vojkovich, Aaron Plattner

COPYRIGHT

Copyright (c) 2003-2008,2010 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.

X Version 11 xf86-video-nv 2.1.23 NV(4)