new file mode 100644
@@ -0,0 +1,208 @@
+Direct Rendering Infrastructure (DRI) Direct Rendering Manager (drm) module
+and Translation Table Manager (ttm) module sysfs entries
+
+Example class view showing a single graphics adapter with three output
+connectors, a special control device node for the graphics adapter, and the
+Translation Table Manager (ttm) graphics memory manager virtual device:
+
+ /sys/class/drm/
+ ??? card0 -> ../../devices/<...>/drm/card0
+ ??? card0-DVI-D-1 -> ../../devices/<...>/drm/card0/card0-DVI-D-1
+ ??? card0-HDMI Type A-1 -> ../../devices/<...>/drm/card0/card0-HDMI Type A-1
+ ??? card0-VGA-1 -> ../../devices/<...>/drm/card0/card0-VGA-1
+ ??? controlD64 -> ../../devices/<...>/drm/controlD64
+ ??? ttm -> ../../devices/virtual/drm/ttm
+ ??? version
+
+ 6 directories, 1 file
+
+
+Corresponding DRI device nodes for the example graphics adapter, with
+additional ACL properties on card0 granting rw perms to the X/console user:
+
+ crw-rw----+ 1 root video 226, 0 2010-09-21 20:52 /dev/dri/card0
+ crw-rw-rw-. 1 root video 226, 64 2010-09-21 20:51 /dev/dri/controlD64
+
+
+Example physical device view for a single graphics adapter with three output
+connectors and a special control device node for the graphics adapter:
+
+ /sys/devices/<...>/drm
+ ??? card0
+ ? ??? card0-DVI-D-1
+ ? ? ??? device -> ../../card0
+ ? ? ??? dpms
+ ? ? ??? edid
+ ? ? ??? enabled
+ ? ? ??? modes
+ ? ? ??? polled
+ ? ? ??? power
+ ? ? ? ??? control
+ ? ? ? ??? runtime_active_time
+ ? ? ? ??? runtime_status
+ ? ? ? ??? runtime_suspended_time
+ ? ? ? ??? wakeup
+ ? ? ? ??? wakeup_count
+ ? ? ??? status
+ ? ? ??? subsystem -> ../../../../../../../class/drm
+ ? ? ??? uevent
+ ? ??? card0-HDMI Type A-1
+ ? ? ??? device -> ../../card0
+ ? ? ??? dpms
+ ? ? ??? edid
+ ? ? ??? enabled
+ ? ? ??? modes
+ ? ? ??? polled
+ ? ? ??? power
+ ? ? ? ??? control
+ ? ? ? ??? runtime_active_time
+ ? ? ? ??? runtime_status
+ ? ? ? ??? runtime_suspended_time
+ ? ? ? ??? wakeup
+ ? ? ? ??? wakeup_count
+ ? ? ??? status
+ ? ? ??? subsystem -> ../../../../../../../class/drm
+ ? ? ??? uevent
+ ? ??? card0-VGA-1
+ ? ? ??? device -> ../../card0
+ ? ? ??? dpms
+ ? ? ??? edid
+ ? ? ??? enabled
+ ? ? ??? modes
+ ? ? ??? polled
+ ? ? ??? power
+ ? ? ? ??? control
+ ? ? ? ??? runtime_active_time
+ ? ? ? ??? runtime_status
+ ? ? ? ??? runtime_suspended_time
+ ? ? ? ??? wakeup
+ ? ? ? ??? wakeup_count
+ ? ? ??? status
+ ? ? ??? subsystem -> ../../../../../../../class/drm
+ ? ? ??? uevent
+ ? ??? dev
+ ? ??? device -> ../../../0000:01:05.0
+ ? ??? power
+ ? ? ??? control
+ ? ? ??? runtime_active_time
+ ? ? ??? runtime_status
+ ? ? ??? runtime_suspended_time
+ ? ? ??? wakeup
+ ? ? ??? wakeup_count
+ ? ??? subsystem -> ../../../../../../class/drm
+ ? ??? uevent
+ ??? controlD64
+ ??? dev
+ ??? device -> ../../../0000:01:05.0
+ ??? power
+ ? ??? control
+ ? ??? runtime_active_time
+ ? ??? runtime_status
+ ? ??? runtime_suspended_time
+ ? ??? wakeup
+ ? ??? wakeup_count
+ ??? subsystem -> ../../../../../../class/drm
+ ??? uevent
+
+ 20 directories, 55 files
+
+
+Example virtual device view view showing the Translation Table Manager (ttm)
+graphics memory manager virtual device:
+
+ /sys/devices/virtual/drm
+ ??? ttm
+ ??? buffer_objects
+ ? ??? bo_count
+ ??? memory_accounting
+ ? ??? kernel
+ ? ? ??? available_memory
+ ? ? ??? emergency_memory
+ ? ? ??? swap_limit
+ ? ? ??? used_memory
+ ? ? ??? zone_memory
+ ? ??? pool
+ ? ??? pool_allocation_size
+ ? ??? pool_max_size
+ ? ??? pool_small_allocation
+ ??? power
+ ? ??? control
+ ? ??? runtime_active_time
+ ? ??? runtime_status
+ ? ??? runtime_suspended_time
+ ? ??? wakeup
+ ? ??? wakeup_count
+ ??? subsystem -> ../../../../class/drm
+ ??? uevent
+
+ 7 directories, 16 files
+
+
+
+Where: /sys/devices/<...>/drm/cardN/cardN-C-M/polled
+ For N a decimal system graphics adapter number: 0, 1, 2, ...
+ For C a connector type name (including spaces) from the set:
+ Unknown
+ VGA
+ DVI-I
+ DVI-D
+ DVI-A
+ Composite
+ SVIDEO
+ LVDS
+ Component
+ 9-pin DIN
+ DisplayPort
+ HDMI Type A
+ HDMI Type B
+ TV
+ Embedded DisplayPort
+ For M a decimal connector number for connectors of that type
+ over all the graphics adapters in the system: 1, 2, ...
+Date: 22 September 2010
+KernelVersion: 2.6.37
+Contact: Andy Walls <awalls@md.metrocast.net>
+Description:
+ Manual control over DRM Kernel Mode Set (KMS) output connector
+ hotplug/connect/disconnect polling criteria. The graphics
+ adapter drm driver (e.g. radeon, i915, nouveau) will detect
+ the available connectors on a graphics adapter and set polling
+ criteria flags for the connector to specify for what events the
+ 0.1 Hz DRM KMS poll of the connector should look.
+
+ A read of the contents of this entry will show what flags are
+ available, with the names of flags that are set for the
+ connector enclosed in brackets:
+
+ # cat /sys/devices/.../drm/card0/card0-DVI-D-1/polled
+ [hotplug_detectable] connect disconnect
+
+ A write of flags names to this entry, will clear the current
+ flag settings and set the poll criteria flags for that
+ connector to those specified names:
+
+ # echo " disconnect connect " > \
+ /sys/devices/.../drm/card0/card0-DVI-D-1/polled
+ # cat /sys/devices/.../drm/card0/card0-DVI-D-1/polled
+ hotplug_detectable [connect] [disconnect]
+
+ # echo > /sys/devices/.../drm/card0/card0-DVI-D-1/polled
+ # cat /sys/devices/.../drm/card0/card0-DVI-D-1/polled
+ hotplug_detectable connect disconnect
+
+ The flags have the following meanings in drm_crtc_helper.c:
+
+ hotplug_detectable:
+ always attempt to detect connection status upon poll
+ don't automatically set up another poll of connector
+
+ connect:
+ attempt to detect "connect" events
+ automatically set up another poll of connector
+
+ disconnect:
+ attempt to detect "disconnect" events
+ automatically set up another poll of connector
+
+ Clearing all three flags will disable any detection actions
+ being taken for that connector during the 0.1 Hz poll.