amdgpu.man revision 504d986f 
1.ds q \N'34'
2.TH AMDGPU __drivermansuffix__ __vendorversion__
3.SH NAME
4amdgpu \- AMD RADEON GPU video driver
5.SH SYNOPSIS
6.nf
7.B "Section \*qDevice\*q"
8.BI "  Identifier \*q"  devname \*q
9.B  "  Driver \*qamdgpu\*q"
10\ \ ...
11.B EndSection
12.fi
13.SH DESCRIPTION
14.B amdgpu
15is an __xservername__ driver for AMD RADEON-based video cards with the
16following features:
17.PP
18.PD 0
19.TP 2
20\(bu
21Support for 24-bit pixel depth;
22.TP
23\(bu
24RandR support up to version 1.4;
25.TP
26\(bu
273D acceleration;
28.PD
29.SH SUPPORTED HARDWARE
30The
31.B amdgpu
32driver supports SI and newer families' video cards.
33.PD
34.SH CONFIGURATION DETAILS
35Please refer to __xconfigfile__(__filemansuffix__) for general configuration
36details.  This section only covers configuration details specific to this
37driver.
38.PP
39The following driver
40.B Options
41are supported:
42.TP
43.BI "Option \*qSWcursor\*q \*q" boolean \*q
44Selects software cursor.  The default is
45.B off.
46.TP
47.BI "Option \*qAccel\*q \*q" boolean \*q
48Enables or disables all hardware acceleration.
49.br
50The default is
51.B on.
52
53.TP
54.BI "Option \*qZaphodHeads\*q \*q" string \*q
55Specify the RandR output(s) to use with zaphod mode for a particular driver
56instance.  If you use this option you must use this option for all instances
57of the driver.
58.br
59For example:
60.B
61Option \*qZaphodHeads\*q \*qLVDS,VGA-0\*q
62will assign xrandr outputs LVDS and VGA-0 to this instance of the driver.
63.TP
64.BI "Option \*qDRI\*q \*q" integer \*q
65Define the maximum level of DRI to enable. Valid values are 2 for DRI2 or 3 for DRI3.
66The default is
67.B 3 for DRI3
68if the Xorg version is >= 1.18.3, otherwise
69.B 2 for DRI2.
70.TP
71.BI "Option \*qEnablePageFlip\*q \*q" boolean \*q
72Enable DRI2 page flipping.  The default is
73.B on.
74.TP
75.BI "Option \*qTearFree\*q \*q" boolean \*q
76Enable tearing prevention using the hardware page flipping mechanism. Requires allocating two
77separate scanout buffers for each CRTC. Enabling this option currently disables Option
78\*qEnablePageFlip\*q. The default is
79.B off.
80.TP
81.BI "Option \*qAccelMethod\*q \*q" string \*q
82Setting this option to
83.B none
84disables use of the glamor acceleration architecture. In that case, all 2D
85rendering is done by the CPU, but 3D and video hardware acceleration can still
86work. This is mainly useful for OpenGL driver bring-up.
87.br
88The default is to use glamor.
89
90.PP
91The following driver
92.B Option
93is supported for
94.B glamor
95:
96.TP
97.BI "Option \*qShadowPrimary\*q \*q" boolean \*q
98This option enables a so-called "shadow primary" buffer for fast CPU access to
99pixel data, and separate scanout buffers for each display controller (CRTC).
100This may improve performance for some 2D workloads, potentially at the expense
101of other (e.g. 3D, video) workloads.
102Note in particular that enabling this option currently disables page flipping.
103The default is
104.B off.
105
106.SH SEE ALSO
107__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__)
108.IP " 1." 4
109Wiki page:
110.RS 4
111http://www.x.org/wiki/radeon
112.RE
113.IP " 2." 4
114Overview about amdgpu development code:
115.RS 4
116http://cgit.freedesktop.org/xorg/driver/xf86-video-amdgpu/
117.RE
118.IP " 3." 4
119Mailing list:
120.RS 4
121http://lists.freedesktop.org/mailman/listinfo/amd-gfx
122.RE
123.IP " 4." 4
124IRC channel:
125.RS 4
126#radeon on irc.freenode.net
127.RE
128.IP " 5." 4
129Query the bugtracker for amdgpu bugs:
130.RS 4
131https://bugs.freedesktop.org/query.cgi?product=xorg&component=Driver/AMDgpu
132.RE
133.IP " 6." 4
134Submit bugs & patches:
135.RS 4
136https://bugs.freedesktop.org/enter_bug.cgi?product=xorg&component=Driver/AMDgpu
137.RE
138
139.SH AUTHORS
140.nf
141Authors include:
142Michel D\(:anzer            \fImichel@daenzer.net\fP
143Alex Deucher             \fIalexdeucher@gmail.com\fP
144