157 lines
3.8 KiB
Groff
157 lines
3.8 KiB
Groff
.\" $NetBSD: drm.4,v 1.2 2007/03/25 23:19:24 jmcneill Exp $
|
|
.\"
|
|
.\" Copyright (c) 2007 Thomas Klausner
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
.\"
|
|
.Dd March 22, 2007
|
|
.Dt DRM 4
|
|
.Os
|
|
.Sh NAME
|
|
.Nm drm
|
|
.Nd Direct Rendering Manager (DRI kernel support)
|
|
.Sh SYNOPSIS
|
|
.Cd i915drm* at vga?
|
|
.Cd mach64drm* at vga?
|
|
.Cd mgadrm* at vga?
|
|
.Cd r128drm* at vga?
|
|
.Cd radeondrm* at vga?
|
|
.Cd savagedrm* at vga?
|
|
.Cd sisdrm* at vga?
|
|
.Cd tdfxdrm* at vga?
|
|
.Cd viadrm* at vga?
|
|
.Pp
|
|
.Cd options DRM_DEBUG
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Tn Direct Rendering Manager
|
|
is part of the
|
|
.Tn Direct Rendering Infrastructure
|
|
for supporting video acceleration (3d acceleration, mostly).
|
|
.Pp
|
|
The
|
|
.Nm
|
|
drivers provide support for the following chipsets:
|
|
.Bl -tag -width XsavagedrmXXX -offset indent -compact
|
|
.It i915drm
|
|
Intel i915, i945
|
|
.It mach64drm
|
|
Mach64 (3D Rage Pro, Rage)
|
|
.It mgadrm
|
|
Matrox G[24]00, G[45]50
|
|
.It r128drm
|
|
ATI Rage 128
|
|
.It radeondrm
|
|
ATI Radeon
|
|
.It savagedrm
|
|
S3 Savage
|
|
.It sisdrm
|
|
SiS
|
|
.It tdfxdrm
|
|
3dfx (Voodoo)
|
|
.It viadrm
|
|
VIA
|
|
.El
|
|
.Pp
|
|
To make use of the driver,
|
|
.Xr X 7
|
|
must be compiled with DRI support, Mesa DRI drivers must be installed,
|
|
the appropriate
|
|
.Pa /dev/dri/card*
|
|
device must exist, and DRI must be enabled in the X configuration
|
|
file.
|
|
.Pp
|
|
Details for these steps:
|
|
.Bl -enum -offset indent
|
|
.It
|
|
X must be compiled with DRI support.
|
|
.It
|
|
Mesa should be compiled for the netbsd-dri target, patch available at
|
|
.Pa http://issc.uj.ac.za/~yorick/drm/mesa.patch
|
|
.It
|
|
The device node must exist:
|
|
.Bd -literal -offset indent
|
|
mkdir -p /dev/dri
|
|
mknod /dev/dri/card0 c 180 0
|
|
chgrp wheel /dev/dri/card0
|
|
chmod 0660 /dev/dri/card0
|
|
.Ed
|
|
.It
|
|
Enable DRI in the X configuration (either
|
|
.Pa xorg.conf
|
|
or
|
|
.Pa XF86Config ) :
|
|
.Bd -literal
|
|
Section "Module"
|
|
...
|
|
Load "dri"
|
|
Load "GLcore"
|
|
Load "glx"
|
|
EndSection
|
|
...
|
|
Section "DRI"
|
|
Group "wheel"
|
|
Mode 0660
|
|
EndSection
|
|
.Ed
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr X 7
|
|
.\" .Sh HISTORY
|
|
.\" The
|
|
.\" .Nm
|
|
.\" driver first appeared in
|
|
.\" ??
|
|
.\" and then it was ported to
|
|
.\" .Nx 5.0 .
|
|
.\" .Sh AUTHORS
|
|
.\" .An -nosplit
|
|
.\" The
|
|
.\" .Nm
|
|
.\" driver was written by
|
|
.\" .An ??
|
|
.\" and
|
|
.\" .An Yorick Hardy
|
|
.\" who adapted the code for
|
|
.\" .Nx .
|
|
.Sh CAVEATS
|
|
Disable AIGLX if necessary
|
|
.Pq Pa xorg.conf :
|
|
.Bd -literal -offset indent
|
|
Section "ServerFlags"
|
|
Option "AIGLX" "off"
|
|
EndSection
|
|
|
|
Section "Extensions"
|
|
Option "Composite" "Disable"
|
|
EndSection
|
|
.Ed
|
|
.Pp
|
|
In case of errors,
|
|
.Pa /dev/dri/card0
|
|
may be changed, make sure to recreate it in that case.
|
|
.Pp
|
|
.Cd options DRM_DEBUG
|
|
can slow DRI down a lot, disable it once
|
|
.Nm
|
|
works.
|