Merge branch 'upstream-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/mfashe...
[sfrench/cifs-2.6.git] / drivers / char / drm / README.drm
1 ************************************************************
2 * For the very latest on DRI development, please see:      *
3 *     http://dri.freedesktop.org/                          *
4 ************************************************************
5
6 The Direct Rendering Manager (drm) is a device-independent kernel-level
7 device driver that provides support for the XFree86 Direct Rendering
8 Infrastructure (DRI).
9
10 The DRM supports the Direct Rendering Infrastructure (DRI) in four major
11 ways:
12
13     1. The DRM provides synchronized access to the graphics hardware via
14        the use of an optimized two-tiered lock.
15
16     2. The DRM enforces the DRI security policy for access to the graphics
17        hardware by only allowing authenticated X11 clients access to
18        restricted regions of memory.
19
20     3. The DRM provides a generic DMA engine, complete with multiple
21        queues and the ability to detect the need for an OpenGL context
22        switch.
23
24     4. The DRM is extensible via the use of small device-specific modules
25        that rely extensively on the API exported by the DRM module.
26
27
28 Documentation on the DRI is available from:
29     http://dri.freedesktop.org/wiki/Documentation
30     http://sourceforge.net/project/showfiles.php?group_id=387
31     http://dri.sourceforge.net/doc/
32
33 For specific information about kernel-level support, see:
34
35     The Direct Rendering Manager, Kernel Support for the Direct Rendering
36     Infrastructure
37     http://dri.sourceforge.net/doc/drm_low_level.html
38
39     Hardware Locking for the Direct Rendering Infrastructure
40     http://dri.sourceforge.net/doc/hardware_locking_low_level.html
41
42     A Security Analysis of the Direct Rendering Infrastructure
43     http://dri.sourceforge.net/doc/security_low_level.html