nouveau (4)

Leading comments

shorthand for double quote that works everywhere.

(The comments found at the beginning of the groff file "man4/nouveau.4".)

NAME

nouveau - NVIDIA video driver

SYNOPSIS

Section N'34'DeviceN'34'
  Identifier N'34'devnameN'34'
  Driver N'34'nouveauN'34'
  ...
EndSection

DESCRIPTION

nouveau is an Xorg driver for NVIDIA video cards. The driver supports 2D acceleration and provides support for the following framebuffer depths: (15,) 16 and 24. TrueColor visuals are supported for these depths.

SUPPORTED HARDWARE

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

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

GeForce 7XXX

G70, G71, G72, G73, MCP67, MCP68, MCP73

GeForce 8XXX, 9XXX, 2XX, 3XX

G80, G84, G86, G92, G94, G96, G98, G200, GT215, GT216, GT218, MCP77, MCP79, MCP89

GeForce 4XX, 5XX

GF100, GF104, GF106, GF108, GF110, GF114, GF116, GF117, GF119

GeForce 6XX, 7XX

GK104, GK106, GK107, GK110, GK208

GeForce GTX 750

GM107

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:

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

Enable or disable the HW cursor. Default: on.

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

Specify the acceleration method. One of N'34'noneN'34', or N'34'exaN'34'. Default: exa.

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

Disable or enable acceleration. Default: acceleration is enabled.

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

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

Option N'34'WrappedFBN'34' N'34'booleanN'34'

Enable or disable wfb, only affects nv50+. Useful for some legacy configurations where high rendering latency is perceived. Default: wfb is disabled.

Option N'34'GLXVBlankN'34' N'34'booleanN'34'

Synchronize GLX clients to VBlank. Useful where tearing is a problem, harmful if the GPU isn't fast enough to keep up with the monitor refresh rate. Default: on.

Option N'34'ZaphodHeadsN'34' N'34'stringN'34'

Specify the randr output(s) to use with zaphod mode for a particular driver instance. If you use this option you most use this option for all instances of the driver.
For example: Option N'34'ZaphodHeadsN'34' N'34'LVDS,VGA-0N'34' will assign xrandr outputs LVDS and VGA-0 to this instance of the driver.

Option N'34'PageFlipN'34' N'34'booleanN'34'

Enable DRI2 page flipping. Default: on.

Option N'34'SwapLimitN'34' N'34'integerN'34'

Set maximum allowed number of pending OpenGL double-buffer swaps for a drawable before a client is blocked.
A value of 1 corresponds to double-buffering. A value of 2 corresponds to triple-buffering. Higher values may allow higher framerate, but also increase lag for interactive applications, e.g., games. Nouveau currently reliably supports a maximum value of 2 on XOrg 1.12+. A maximum setting of 2 on older x-servers is allowed, but it will break conformance with the OpenML OML_sync_control specification and will cause failure of software that relies on correct presentation timing behaviour as defined in that specification.
Default: 1.

Option N'34'DRIN'34' N'34'integerN'34'

Define the maximum level of DRI to enable. Valid values are 2 or 3. exa acceleration will honor the maximum level if it is supported. Under glamor acceleration DRI3 is always enabled if supported, as glamor currently does not support DRI2. Default: 2 on exa, 3 on glamor.

SEE ALSO

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

AUTHORS

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

COPYRIGHT

NOTICE TO USER: The source code is copyrighted under U.S. and international laws. Users and possessors of this source code are hereby granted a nonexclusive, royalty-free copyright license to use this code in individual and commercial software.

Any use of this source code must include, in the user documentation and internal comments to the code, notices to the end user as follows:

Copyright 1993-2003 NVIDIA, Corporation. All rights reserved.

NVIDIA, CORPORATION MAKES NO REPRESENTATION ABOUT THE SUITABILITY OF THIS SOURCE CODE FOR ANY PURPOSE. IT IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED WARRANTY OF ANY KIND. NVIDIA, CORPORATION DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOURCE CODE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL NVIDIA, CORPORATION BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOURCE CODE.

U.S. Government End Users. This source code is a "commercial item," as that term is defined at 48 C.F.R. 2.101 (OCT 1995), consisting of "commercial computer software" and "commercial computer software documentation," as such terms are used in 48 C.F.R. 12.212 (SEPT 1995) and is provided to the U.S. Government only as a commercial end item. Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (JUNE 1995), all U.S. Government End Users acquire the source code with only those rights set forth herein.