| @@ -1,56 +1,58 @@ | | | @@ -1,56 +1,58 @@ |
1 | .\" $NetBSD: drm.4,v 1.17 2018/07/18 16:41:53 wiz Exp $ | | 1 | .\" $NetBSD: drm.4,v 1.18 2021/03/10 07:23:42 wiz Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 2007, 2013 Thomas Klausner | | 3 | .\" Copyright (c) 2007, 2013 Thomas Klausner |
4 | .\" All rights reserved. | | 4 | .\" All rights reserved. |
5 | .\" | | 5 | .\" |
6 | .\" Redistribution and use in source and binary forms, with or without | | 6 | .\" Redistribution and use in source and binary forms, with or without |
7 | .\" modification, are permitted provided that the following conditions | | 7 | .\" modification, are permitted provided that the following conditions |
8 | .\" are met: | | 8 | .\" are met: |
9 | .\" 1. Redistributions of source code must retain the above copyright | | 9 | .\" 1. Redistributions of source code must retain the above copyright |
10 | .\" notice, this list of conditions and the following disclaimer. | | 10 | .\" notice, this list of conditions and the following disclaimer. |
11 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 11 | .\" 2. Redistributions in binary form must reproduce the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer in the | | 12 | .\" notice, this list of conditions and the following disclaimer in the |
13 | .\" documentation and/or other materials provided with the distribution. | | 13 | .\" documentation and/or other materials provided with the distribution. |
14 | .\" | | 14 | .\" |
15 | .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR | | 15 | .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR |
16 | .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES | | 16 | .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES |
17 | .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | | 17 | .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
18 | .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | | 18 | .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, |
19 | .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | | 19 | .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT |
20 | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | | 20 | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
21 | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | | 21 | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
22 | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | | 22 | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
23 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | | 23 | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF |
24 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | | 24 | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
25 | .\" | | 25 | .\" |
26 | .Dd July 10, 2018 | | 26 | .Dd March 10, 2021 |
27 | .Dt DRM 4 | | 27 | .Dt DRM 4 |
28 | .Os | | 28 | .Os |
29 | .Sh NAME | | 29 | .Sh NAME |
30 | .Nm drm | | 30 | .Nm drm |
31 | .Nd Direct Rendering Manager (DRI kernel support) | | 31 | .Nd Direct Rendering Manager (DRI kernel support) |
32 | .Sh SYNOPSIS | | 32 | .Sh SYNOPSIS |
33 | .Cd i915drm* at drm? | | 33 | .Cd i915drm* at drm? |
34 | .Cd mach64drm* at drm? | | 34 | .Cd mach64drm* at drm? |
35 | .Cd mgadrm* at drm? | | 35 | .Cd mgadrm* at drm? |
36 | .Cd r128drm* at drm? | | 36 | .Cd r128drm* at drm? |
37 | .Cd radeondrm* at drm? | | 37 | .Cd radeondrm* at drm? |
38 | .Cd savagedrm* at drm? | | 38 | .Cd savagedrm* at drm? |
39 | .Cd sisdrm* at drm? | | 39 | .Cd sisdrm* at drm? |
40 | .Cd tdfxdrm* at drm? | | 40 | .Cd tdfxdrm* at drm? |
41 | .Pp | | 41 | .Pp |
42 | .Cd options DRM_DEBUG | | 42 | .Cd options DRM_DEBUG |
43 | .Cd options DRM_NO_AGP | | 43 | .Cd options DRM_NO_AGP |
| | | 44 | .Cd options DRM_MAX_RESOLUTION_HORIZONTAL=integer |
| | | 45 | .Cd options DRM_MAX_RESOLUTION_VERTICAL=integer |
44 | .Sh DESCRIPTION | | 46 | .Sh DESCRIPTION |
45 | The Direct Rendering Manager is part of the Direct Rendering | | 47 | The Direct Rendering Manager is part of the Direct Rendering |
46 | Infrastructure for supporting video acceleration (3d acceleration, | | 48 | Infrastructure for supporting video acceleration (3d acceleration, |
47 | mostly). | | 49 | mostly). |
48 | .Pp | | 50 | .Pp |
49 | The | | 51 | The |
50 | .Nm | | 52 | .Nm |
51 | drivers provide support for the following chipsets: | | 53 | drivers provide support for the following chipsets: |
52 | .Bl -tag -width XsavagedrmXXX -offset indent -compact | | 54 | .Bl -tag -width XsavagedrmXXX -offset indent -compact |
53 | .It i915drm | | 55 | .It i915drm |
54 | Intel i915, i945 | | 56 | Intel i915, i945 |
55 | .It mach64drm | | 57 | .It mach64drm |
56 | Mach64 (3D Rage Pro, Rage) | | 58 | Mach64 (3D Rage Pro, Rage) |
| @@ -78,26 +80,35 @@ instead may be sufficient), | | | @@ -78,26 +80,35 @@ instead may be sufficient), |
78 | .Xr X 7 | | 80 | .Xr X 7 |
79 | must be compiled with DRI support, Mesa DRI drivers must be installed, | | 81 | must be compiled with DRI support, Mesa DRI drivers must be installed, |
80 | the appropriate | | 82 | the appropriate |
81 | .Pa /dev/dri/card* | | 83 | .Pa /dev/dri/card* |
82 | device must exist, and DRI must be enabled in the X configuration | | 84 | device must exist, and DRI must be enabled in the X configuration |
83 | file. | | 85 | file. |
84 | .Xr X 7 | | 86 | .Xr X 7 |
85 | provided with | | 87 | provided with |
86 | .Nx | | 88 | .Nx |
87 | and compiled from | | 89 | and compiled from |
88 | .Xr pkgsrc 7 | | 90 | .Xr pkgsrc 7 |
89 | do so automatically where supported. | | 91 | do so automatically where supported. |
90 | .Pp | | 92 | .Pp |
| | | 93 | With some drivers (at least |
| | | 94 | .Xr radeon 4 ) , |
| | | 95 | in some cases the driver does not choose the resolution correctly. |
| | | 96 | The options |
| | | 97 | .Dv DRM_MAX_RESOLUTION_HORIZONTAL |
| | | 98 | and |
| | | 99 | .Dv DRM_MAX_RESOLUTION_VERTICAL |
| | | 100 | allow limiting the maximum resolution in X and Y direction. |
| | | 101 | .Pp |
91 | .Xr X 7 | | 102 | .Xr X 7 |
92 | will attempt to create the device node automatically. | | 103 | will attempt to create the device node automatically. |
93 | To create the device node manually: | | 104 | To create the device node manually: |
94 | .Bd -literal -offset indent | | 105 | .Bd -literal -offset indent |
95 | mkdir -p /dev/dri | | 106 | mkdir -p /dev/dri |
96 | mknod /dev/dri/card0 c 180 0 | | 107 | mknod /dev/dri/card0 c 180 0 |
97 | chgrp wheel /dev/dri/card0 | | 108 | chgrp wheel /dev/dri/card0 |
98 | chmod 0660 /dev/dri/card0 | | 109 | chmod 0660 /dev/dri/card0 |
99 | .Ed | | 110 | .Ed |
100 | .Pp | | 111 | .Pp |
101 | To enable DRI in the X configuration add the following to either | | 112 | To enable DRI in the X configuration add the following to either |
102 | .Pa xorg.conf | | 113 | .Pa xorg.conf |
103 | for | | 114 | for |