1NV(4)                      Kernel Interfaces Manual                      NV(4)
2
3
4

NAME

6       nv - NVIDIA video driver
7

SYNOPSIS

9       Section "Device"
10         Identifier "devname"
11         Driver "nv"
12         ...
13       EndSection
14

DESCRIPTION

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

SUPPORTED HARDWARE

25       The nv driver supports PCI, PCI-Express and AGP video  cards  based  on
26       the following NVIDIA chips:
27
28       RIVA 128              NV3
29
30       RIVA TNT              NV4
31
32       RIVA TNT2             NV5
33
34       GeForce 256, Quadro   NV10
35
36       GeForce2, Quadro2     NV11 & NV15
37
38       GeForce3, Quadro DCC  NV20
39
40       nForce, nForce2       NV1A, NV1F
41
42       GeForce4, Quadro4     NV17, NV18, NV25, NV28
43
44       GeForce FX, Quadro FX NV30, NV31, NV34, NV35, NV36, NV37, NV38
45
46       GeForce 6XXX          NV40, NV41, NV43, NV44, NV45, C51
47
48       GeForce 7XXX          G70, G71, G72, G73, MCP6x
49
50       GeForce 8XXX, GeForce 9XXX, nForce 7, GeForce G, ION
51                             G8x, G9x, GT21x, MCP7x
52
53       GeForce GTX           GT200
54

CONFIGURATION DETAILS

56       Please  refer  to xorg.conf(5) for general configuration details.  This
57       section only covers configuration details specific to this driver.
58
59       The driver auto-detects the chipset type and the amount of video memory
60       present for all chips.
61
62       The following driver Options are supported for pre-G80 hardware:
63
64       Option "HWCursor" "boolean"
65              Enable or disable the HW cursor.  Default: on.
66
67       Option "NoAccel" "boolean"
68              Disable   or  enable  acceleration.   Default:  acceleration  is
69              enabled.
70
71       Option "UseFBDev" "boolean"
72              Enable or disable use of an OS-specific fb interface (and is not
73              supported  on all OSs).  See fbdevhw(4) for further information.
74              Default: off.
75
76       Option "CrtcNumber" "integer"
77              Many graphics cards with NVIDIA chips have  two  video  outputs.
78              The  driver attempts to autodetect which one the monitor is con‐
79              nected to.  In the case that autodetection picks the wrong  one,
80              this  option  may be used to force usage of a particular output.
81              The options are "0" or "1".  Default: autodetected.
82
83       Option "Dualhead" "boolean"
84              Enables simple VBE-based dual head mode.   This  sets  the  same
85              resolution  on both outputs and lays them out side-by-side.  The
86              screens will be panned together as one big metamode if the  vir‐
87              tual desktop is larger than both screens combined.
88
89       Option "FlatPanel" "boolean"
90              The driver usually can autodetect the presence of a digital flat
91              panel.  In the case that this fails, this option can be used  to
92              force  the driver to treat the attached device as a digital flat
93              panel.  With this driver, a digital flat panel will work only if
94              it  was  POSTed  by  the  BIOS,  that is, the computer must have
95              booted to the panel.  If you have a dual head card you may  also
96              need  to  set  the  option CrtcNumber described above.  Default:
97              autodetected.
98
99       Option "FPDither" "boolean"
100              Many digital flat panels (particularly  ones  on  laptops)  have
101              only  6  bits per component color resolution.  This option tells
102              the driver to dither from 8 bits per component to 6  before  the
103              flat panel truncates it.  Default: off.
104
105       Option "FPScale" "boolean"
106              Supported only on GeForce4 and newer chips, this option tells to
107              the driver to scale lower resolutions up  to  the  flat  panel's
108              native resolution.  Default: on.
109
110       Option "Rotate" "CW"
111
112       Option "Rotate" "CCW"
113              Rotate  the display clockwise or counterclockwise.  This mode is
114              unaccelerated.  Default: no rotation.
115
116              Note: The Resize and Rotate extension will be  disabled  if  the
117              Rotate "CW" or Rotate "CCW" options are used.
118
119       Option "Rotate" "RandR"
120              Enable rotation of the screen using the Resize and Rotate exten‐
121              sion.  This mode is unaccelerated.  Default:  no  rotation  sup‐
122              port.
123
124       Option "ShadowFB" "boolean"
125              Enable or disable use of the shadow framebuffer layer.  Default:
126              off.
127
128       The following driver Options are available for G80 and higher:
129
130       Option "HWCursor" "boolean"
131              Enable or disable the hardware cursor.  Default: on.
132
133       Option "NoAccel" "boolean"
134              Disable  or  enable  acceleration.   Default:  acceleration   is
135              enabled.
136
137       Option "AccelMethod" "string"
138              Choose acceleration architecture, either "XAA" or "EXA".  XAA is
139              the old but stable architecture.   EXA  is  newer  and  supports
140              resizing  the desktop larger than it started out with RandR 1.2.
141              If you choose to use EXA, you might also consider setting Option
142              "MigrationHeuristic"  "greedy" to improve performance.  Default:
143              XAA.
144
145       Option "FPDither" "boolean"
146              Enable or disable flat panel dithering  by  default.   Dithering
147              can  also  be  enabled  or disabled using the RandR 1.2 "dither"
148              output property.  Default: off.
149
150       Option "AllowDualLinkModes" "boolean"
151              Allow validation of dual-link DVI modes.  Not all GPUs are  con‐
152              figured  at  boot  time to be able to handle dual-link modes, so
153              they are disabled by default.
154
155       The following RandR 1.2 properties are available for flat panels on G80
156       and higher GPUs:
157
158       dither Enable  or disable flat panel dithering.  Valid values: 0 (off),
159              1 (on).
160
161       scale  Control how the image is scaled to fit  the  flat  panel.   Note
162              that some flat panels perform their own scaling, overriding this
163              option.  "off" is not  valid  for  laptop  flat  panels  (LVDS).
164              Valid  values:  "off", "aspect", "fill", and "center".  Default:
165              "aspect".
166

SEE ALSO

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

AUTHORS

171       Authors include: David McKay, Jarno Paananen, Chas Inman, Dave Schmenk,
172       Mark Vojkovich, Aaron Plattner
173
175       Copyright (c) 2003-2008,2010 NVIDIA Corporation
176
177       Permission is hereby granted, free of charge, to any person obtaining a
178       copy of this software and associated documentation  files  (the  "Soft‐
179       ware"),  to deal in the Software without restriction, including without
180       limitation the rights to use, copy, modify, merge, publish, distribute,
181       sublicense,  and/or  sell copies of the Software, and to permit persons
182       to whom the Software is furnished to do so, subject  to  the  following
183       conditions:
184
185       The above copyright notice and this permission notice shall be included
186       in all copies or substantial portions of the Software.
187
188       THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
189       OR  IMPLIED,  INCLUDING  BUT  NOT  LIMITED  TO  THE  WARRANTIES OF MER‐
190       CHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN
191       NO  EVENT  SHALL  THE  AUTHORS  OR  COPYRIGHT HOLDERS BE LIABLE FOR ANY
192       CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN  ACTION  OF  CONTRACT,
193       TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFT‐
194       WARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
195
196
197
198X Version 11                 xf86-video-nv 2.1.20                        NV(4)
Impressum