linux/drivers/gpu/drm
yakui_zhao 4fefcb2705 drm: add separate drm debugging levels
Now all the DRM debug info will be reported if the boot option of
"drm.debug=1" is added. Sometimes it is inconvenient to get the debug
info in KMS mode. We will get too much unrelated info.

This will separate several DRM debug levels and the debug level can be used
to print the different debug info. And the debug level is controlled by the
module parameter of drm.debug

In this patch it is divided into four debug levels;
       	drm_core, drm_driver, drm_kms, drm_mode.

At the same time we can get the different debug info by changing the debug
level. This can be done by adding the module parameter. Of course it can
be changed through the /sys/module/drm/parameters/debug after the system is
booted.

Four debug macro definitions are provided.
	DRM_DEBUG(fmt, args...)
	DRM_DEBUG_DRIVER(prefix, fmt, args...)
	DRM_DEBUG_KMS(prefix, fmt, args...)
	DRM_DEBUG_MODE(prefix, fmt, args...)

When the boot option of "drm.debug=4" is added, it will print the debug info
using DRM_DEBUG_KMS macro definition.
When the boot option of "drm.debug=6" is added, it will print the debug info
using DRM_DEBUG_KMS/DRM_DEBUG_DRIVER.

Sometimes we expect to print the value of an array.
For example: SDVO command,
In such case the following four DRM debug macro definitions are added:
	DRM_LOG(fmt, args...)
	DRM_LOG_DRIVER(fmt, args...)
	DRM_LOG_KMS(fmt, args...)
	DRM_LOG_MODE(fmt, args...)

Signed-off-by: Zhao Yakui <yakui.zhao@intel.com>
Signed-off-by: Dave Airlie <airlied@redhat.com>
2009-06-11 18:36:36 +10:00
..
i810 drm: Split drm_map and drm_local_map 2009-03-13 14:23:56 +10:00
i830 drm: Split drm_map and drm_local_map 2009-03-13 14:23:56 +10:00
i915 intelfb: fix spelling of "CLOCK" 2009-06-11 16:10:29 +10:00
mga drm: Make drm_local_map use a resource_size_t offset 2009-03-13 14:23:57 +10:00
r128 drm/r128: fix r128 ioremaps to use ioremap_wc. 2009-05-06 09:04:52 +10:00
radeon radeon: remove _DRM_DRIVER from the preadded sarea map 2009-06-11 16:16:10 +10:00
savage drm: Use resource_size_t for drm_get_resource_{start, len} 2009-03-13 14:23:56 +10:00
sis SiS DRM: fix a pointer cast warning 2008-10-18 07:10:10 +10:00
tdfx drm: reorganise drm tree to be more future proof. 2008-07-14 10:45:01 +10:00
via drm: count reaches -1 2009-04-20 09:28:20 +10:00
Kconfig ACPI, i915: build fix (v2) 2009-05-29 21:26:38 -04:00
Makefile drm: Convert proc files to seq_file and introduce debugfs 2009-03-27 15:12:00 -07:00
README.drm drm: reorganise drm tree to be more future proof. 2008-07-14 10:45:01 +10:00
ati_pcigart.c drm/ati_pcigart: use memset_io to reset the memory 2009-03-13 14:24:14 +10:00
drm_agpsupport.c drm: stash AGP include under the do-we-have-AGP ifdef 2009-01-22 22:27:11 +10:00
drm_auth.c drm: move to kref per-master structures. 2008-12-29 17:47:22 +10:00
drm_bufs.c drm: don't associate _DRM_DRIVER maps with a master 2009-06-11 16:15:29 +10:00
drm_cache.c drm: wbinvd is cache coherent. 2008-10-18 07:10:53 +10:00
drm_context.c drm: Split drm_map and drm_local_map 2009-03-13 14:23:56 +10:00
drm_crtc.c drm: Release user fbs in drm_release 2009-02-20 12:21:11 +10:00
drm_crtc_helper.c drm/kms: don't try to shortcut drm mode set function 2009-04-24 14:47:00 +10:00
drm_debugfs.c drm: Convert proc files to seq_file and introduce debugfs 2009-03-27 15:12:00 -07:00
drm_dma.c drm: reorganise drm tree to be more future proof. 2008-07-14 10:45:01 +10:00
drm_drawable.c drm: Avoid oops in DRM_IOCTL_RM_DRAW if a bad handle is supplied. 2008-10-23 13:46:54 +10:00
drm_drv.c drm: Copy back ioctl data to userspace regardless of return code. 2009-05-20 11:41:41 -07:00
drm_edid.c drm: fix EDID backward compat check 2009-04-03 09:21:46 +10:00
drm_fops.c drm: drm_fops.c unlock missing on error path 2009-03-29 18:31:47 +10:00
drm_gem.c drm: simplify kcalloc() call to kzalloc(). 2009-06-11 16:10:30 +10:00
drm_hashtab.c drm: GEM mmap support 2008-12-29 17:47:22 +10:00
drm_info.c drm: merge Linux master into HEAD 2009-03-28 20:22:18 -04:00
drm_ioc32.c drm: Only use DRM_IOCTL_UPDATE_DRAW compat wrapper for compat X86. 2009-03-13 14:24:04 +10:00
drm_ioctl.c drm: fix leak of uninitialized data to userspace 2008-12-29 17:47:22 +10:00
drm_irq.c drm: Correct unbalanced drm_vblank_put() during mode setting. 2009-02-25 14:45:50 +10:00
drm_lock.c drm: Avoid client deadlocks when the master disappears. 2009-03-03 09:50:20 +10:00
drm_memory.c drm: Split drm_map and drm_local_map 2009-03-13 14:23:56 +10:00
drm_mm.c DRM: add mode setting support 2008-12-29 17:47:23 +10:00
drm_modes.c DRM: add mode setting support 2008-12-29 17:47:23 +10:00
drm_pci.c drm: reorganise drm tree to be more future proof. 2008-07-14 10:45:01 +10:00
drm_proc.c drm: Convert proc files to seq_file and introduce debugfs 2009-03-27 15:12:00 -07:00
drm_scatter.c drm: reorganise drm tree to be more future proof. 2008-07-14 10:45:01 +10:00
drm_sman.c drm: reorganise drm tree to be more future proof. 2008-07-14 10:45:01 +10:00
drm_stub.c drm: add separate drm debugging levels 2009-06-11 18:36:36 +10:00
drm_sysfs.c drm: remove unreachable code in drm_sysfs.c 2009-04-24 15:06:36 +10:00
drm_vm.c drm: Make drm_local_map use a resource_size_t offset 2009-03-13 14:23:57 +10:00

README.drm

************************************************************
* 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