1
0
Files
linux/drivers/gpu/drm
Daniel Vetter 3436738180 drm/i915: Document that mmap forwarding is discouraged
Too many new drm driver writers seem to look at i915 for inspiration.
But we have two ways to do mmap, so discourage readers from the old,
ugly version. In a new driver we'd just expose two mmap offsets per
object, one for the gtt map and the other for the cpu map.

v2: Make it clear that i915 does cpu mmaps this way for past
cluelessness^W^W historical reasons. Asked for by Jani.

Cc: "Cheng, Yao" <yao.cheng@intel.com>
Cc: David Herrmann <dh.herrmann@gmail.com>
Reviewed-by: David Herrmann <dh.herrmann@gmail.com>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
2014-10-24 16:34:04 +02:00
..
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-15 11:55:47 +03:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-12 11:19:47 +02:00
2014-09-24 11:43:41 +10:00
2014-09-24 11:43:41 +10:00
2014-09-12 11:19:47 +02:00
2014-09-10 17:43:10 +10:00
2014-09-24 11:43:41 +10:00
2014-09-10 17:43:27 +10:00
2014-09-10 17:43:27 +10:00

************************************************************
* For the very latest on DRI development, please see:      *
*     http://dri.freedesktop.org/                          *
************************************************************

The Direct Rendering Manager (drm) is a device-independent kernel-level
device driver that provides support for the XFree86 Direct Rendering
Infrastructure (DRI).

The DRM supports the Direct Rendering Infrastructure (DRI) in four major
ways:

    1. The DRM provides synchronized access to the graphics hardware via
       the use of an optimized two-tiered lock.

    2. The DRM enforces the DRI security policy for access to the graphics
       hardware by only allowing authenticated X11 clients access to
       restricted regions of memory.

    3. The DRM provides a generic DMA engine, complete with multiple
       queues and the ability to detect the need for an OpenGL context
       switch.

    4. The DRM is extensible via the use of small device-specific modules
       that rely extensively on the API exported by the DRM module.


Documentation on the DRI is available from:
    http://dri.freedesktop.org/wiki/Documentation
    http://sourceforge.net/project/showfiles.php?group_id=387
    http://dri.sourceforge.net/doc/

For specific information about kernel-level support, see:

    The Direct Rendering Manager, Kernel Support for the Direct Rendering
    Infrastructure
    http://dri.sourceforge.net/doc/drm_low_level.html

    Hardware Locking for the Direct Rendering Infrastructure
    http://dri.sourceforge.net/doc/hardware_locking_low_level.html

    A Security Analysis of the Direct Rendering Infrastructure
    http://dri.sourceforge.net/doc/security_low_level.html