linux/drivers/gpu/drm
Daniel Vetter 6e9f798d91 drm: Split connection_mutex out of mode_config.mutex (v3)
After the split-out of crtc locks from the big mode_config.mutex
there's still two major areas it protects:
- Various connector probe states, like connector->status, EDID
  properties, probed mode lists and similar information.
- The links from connector->encoder and encoder->crtc and other
  modeset-relevant connector state (e.g. properties which control the
  panel fitter).

The later is used by modeset operations. But they don't really care
about the former since it's allowed to e.g. enable a disconnected VGA
output or with a mode not in the probed list.

Thus far this hasn't been a problem, but for the atomic modeset
conversion Rob Clark needs to convert all modeset relevant locks into
w/w locks. This is required because the order of acquisition is
determined by how userspace supplies the atomic modeset data. This has
run into troubles in the detect path since the i915 load detect code
needs _both_ protections offered by the mode_config.mutex: It updates
probe state and it needs to change the modeset configuration to enable
the temporary load detect pipe.

The big deal here is that for the probe/detect users of this lock a
plain mutex fits best, but for atomic modesets we really want a w/w
mutex. To fix this lets split out a new connection_mutex lock for the
modeset relevant parts.

For simplicity I've decided to only add one additional lock for all
connector/encoder links and modeset configuration states. We have
piles of different modeset objects in addition to those (like bridges
or panels), so adding per-object locks would be much more effort.

Also, we're guaranteed (at least for now) to do a full modeset if we
need to acquire this lock. Which means that fine-grained locking is
fairly irrelevant compared to the amount of time the full modeset will
take.

I've done a full audit, and there's just a few things that justify
special focus:
- Locking in drm_sysfs.c is almost completely absent. We should
  sprinkle mode_config.connection_mutex over this file a bit, but
  since it already lacks mode_config.mutex this patch wont make the
  situation any worse. This is material for a follow-up patch.

- omap has a omap_framebuffer_flush function which walks the
  connector->encoder->crtc links and is called from many contexts.
  Some look like they don't acquire mode_config.mutex, so this is
  already racy. Again fixing this is material for a separate patch.

- The radeon hot_plug function to retrain DP links looks at
  connector->dpms. Currently this happens without any locking, so is
  already racy. I think radeon_hotplug_work_func should gain
  mutex_lock/unlock calls for the mode_config.connection_mutex.

- Same applies to i915's intel_dp_hot_plug. But again, this is already
  racy.

- i915 load_detect code needs to acquire this lock. Which means the
  w/w dance due to Rob's work will be nicely contained to _just_ this
  function.

I've added fixme comments everywhere where it looks suspicious but in
the sysfs code. After a quick irc discussion with Dave Airlie it
sounds like the lack of locking in there is due to sysfs cleanup fun
at module unload.

v1: original (only compile tested)

v2: missing mutex_init(), etc (from Rob Clark)

v3: i915 needs more care in the conversion:
- Protect the edp pp logic with the connection_mutex.
- Use connection_mutex in the backlight code due to
  get_pipe_from_connector.
- Use drm_modeset_lock_all in suspend/resume paths.
- Update lock checks in the overlay code.

Cc: Alex Deucher <alexdeucher@gmail.com>
Cc: Rob Clark <robdclark@gmail.com>
Signed-off-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Reviewed-by: Rob Clark <robdclark@gmail.com>
2014-06-04 13:25:21 +10:00
..
armada drm/armada: use shmem helpers if possible 2014-05-27 15:51:35 +10:00
ast Merge branch 'ast-updates' of ssh://people.freedesktop.org/~/linux into drm-next 2014-05-19 11:15:08 +10:00
bochs drm/bochs: Remove unecessary NULL check in gem_free 2014-04-22 15:39:40 +02:00
bridge drm: make mode_valid callback optional 2014-04-22 11:18:12 +02:00
cirrus Merge tag 'topic/core-stuff-2014-05-05' of git://anongit.freedesktop.org/drm-intel into drm-next 2014-05-16 11:47:13 +10:00
exynos Merge tag 'topic/core-stuff-2014-05-05' of git://anongit.freedesktop.org/drm-intel into drm-next 2014-05-16 11:47:13 +10:00
gma500 drm: pass the irq explicitly to drm_irq_install 2014-04-23 10:32:50 +02:00
i2c drm/i2c/tda998x: Fix signed overflow issue 2014-04-22 15:39:41 +02:00
i810
i915 drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
mga drm: remove drm_dev_to_irq from drivers 2014-04-22 11:41:12 +02:00
mgag200 drm/mgag200: Remove unecessary NULL check in gem_free 2014-04-22 15:39:04 +02:00
msm Merge branch 'drm-init-cleanup' of git://people.freedesktop.org/~danvet/drm into drm-next 2014-05-01 09:32:21 +10:00
nouveau drm/nouveau: replace drm_get_connector_name() with direct name field use 2014-06-04 13:14:41 +10:00
omapdrm drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
panel drm/panel: Changes for v3.15-rc1 2014-04-05 16:12:27 +10:00
qxl drm/qxl: use surface_id 0 for primary surface on all monitors 2014-06-04 12:13:22 +10:00
r128 drm: remove drm_dev_to_irq from drivers 2014-04-22 11:41:12 +02:00
radeon drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
rcar-du drm/rcar-du: Add run-time dependencies 2014-05-27 15:46:36 +10:00
savage
shmobile drm/shmobile: Add run-time dependencies 2014-05-27 15:47:07 +10:00
sis
tdfx
tegra Merge branch 'drm-init-cleanup' of git://people.freedesktop.org/~danvet/drm into drm-next 2014-05-01 09:32:21 +10:00
tilcdc drm: pass the irq explicitly to drm_irq_install 2014-04-23 10:32:50 +02:00
ttm Merge tag 'ttm-next-2014-04-04' of git://people.freedesktop.org/~thomash/linux into drm-next 2014-04-05 16:07:39 +10:00
udl drm/udl: Initialize ret in udl_driver_load 2014-04-22 15:39:37 +02:00
via drm/via: Remove unecessary NULL check 2014-04-22 15:39:11 +02:00
vmwgfx Merge branch 'drm-init-cleanup' of git://people.freedesktop.org/~danvet/drm into drm-next 2014-05-01 09:32:21 +10:00
ati_pcigart.c
drm_agpsupport.c
drm_auth.c
drm_buffer.c
drm_bufs.c Merge tag 'topic/core-stuff-2014-05-05' of git://anongit.freedesktop.org/drm-intel into drm-next 2014-05-16 11:47:13 +10:00
drm_cache.c Merge tag 'drm-intel-next-2014-04-16' of git://anongit.freedesktop.org/drm-intel into drm-next 2014-05-01 09:11:37 +10:00
drm_context.c
drm_crtc_helper.c drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
drm_crtc_internal.h drm: move drm_mode related functions into drm_modes.c 2014-03-13 12:48:40 +01:00
drm_crtc.c drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
drm_debugfs.c
drm_dma.c
drm_dp_helper.c drm/dp: Fix typo in comment 2014-04-29 12:33:46 +02:00
drm_drv.c drm: Add a function to get the ioctl flags 2014-03-28 14:19:02 +01:00
drm_edid_load.c drm: replace drm_get_connector_name() with direct name field use 2014-06-04 13:17:41 +10:00
drm_edid.c drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
drm_encoder_slave.c
drm_fb_cma_helper.c
drm_fb_helper.c drm: replace drm_get_connector_name() with direct name field use 2014-06-04 13:17:41 +10:00
drm_flip_work.c
drm_fops.c drm: remove unused argument from drm_open_helper 2014-04-28 23:50:59 +02:00
drm_gem_cma_helper.c drm: gem-cma: Fix warnings due to improper printk formats 2014-04-04 10:13:48 +10:00
drm_gem.c drm/gem: replace misleading comment 2014-05-27 15:50:57 +10:00
drm_global.c
drm_hashtab.c
drm_info.c drm: remove drm_bus->get_name 2014-04-23 10:32:53 +02:00
drm_ioc32.c
drm_ioctl.c drm: rip out dev->devname 2014-04-23 10:32:52 +02:00
drm_irq.c drm/irq: Coding style fix 2014-05-22 14:10:39 +02:00
drm_lock.c
drm_memory.c
drm_mipi_dsi.c drm/mipi_dsi: create dsi devices only for nodes with reg property 2014-04-04 21:24:47 +09:00
drm_mm.c drm/mm: Don't WARN if drm_mm_reserve_node 2014-04-10 10:54:47 +03:00
drm_modes.c drm: try harder to avoid regression when merging mode bits 2014-05-01 09:26:53 +10:00
drm_panel.c
drm_pci.c drm: Remove dev->kdriver 2014-04-23 10:32:54 +02:00
drm_plane_helper.c drm: Split connection_mutex out of mode_config.mutex (v3) 2014-06-04 13:25:21 +10:00
drm_platform.c drm: Remove dev->kdriver 2014-04-23 10:32:54 +02:00
drm_prime.c Merge branch 'drm-next' of git://people.freedesktop.org/~airlied/linux 2014-04-08 09:52:16 -07:00
drm_probe_helper.c drm: replace drm_get_connector_name() with direct name field use 2014-06-04 13:17:41 +10:00
drm_rect.c
drm_scatter.c
drm_stub.c drm: fix memory leak around mode_group (v2) 2014-05-16 11:46:06 +10:00
drm_sysfs.c drm: replace drm_get_connector_name() with direct name field use 2014-06-04 13:17:41 +10:00
drm_trace_points.c
drm_trace.h
drm_usb.c drm: Remove dev->kdriver 2014-04-23 10:32:54 +02:00
drm_vm.c
drm_vma_manager.c
Kconfig drm/bridge: Add PTN3460 bridge driver 2014-03-24 00:36:37 +09:00
Makefile drm: Split out drm_probe_helper.c from drm_crtc_helper.c 2014-04-18 13:21:17 +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