summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Vetter <daniel.vetter@ffwll.ch>2019-01-29 09:56:43 +0100
committerDaniel Vetter <daniel.vetter@ffwll.ch>2019-01-29 10:50:54 +0100
commit168982d243d7f8dc368e508a61a8516a23b0bbec (patch)
tree8ecd6ae1d497c41e2bf5af37c9f5c7f7b7833363
parent78de14c23e031420aa5f61973583635eccd6cd2a (diff)
drm/doc: Add a warning to drm_dev_is_unplugged
It's probably not what you want, definitely not after Noralf's work to add drm_dev_enter/exit. Cc: Noralf Trønnes <noralf@tronnes.org> Reviewed-by: Noralf Trønnes <noralf@tronnes.org> Signed-off-by: Daniel Vetter <daniel.vetter@intel.com> Link: https://patchwork.freedesktop.org/patch/msgid/20190129085643.16357-1-daniel.vetter@ffwll.ch
-rw-r--r--include/drm/drm_drv.h4
1 files changed, 4 insertions, 0 deletions
diff --git a/include/drm/drm_drv.h b/include/drm/drm_drv.h
index 35af23f5fa0d..e32c12877bc5 100644
--- a/include/drm/drm_drv.h
+++ b/include/drm/drm_drv.h
@@ -643,6 +643,10 @@ void drm_dev_unplug(struct drm_device *dev);
* Unplugging itself is singalled through drm_dev_unplug(). If a device is
* unplugged, these two functions guarantee that any store before calling
* drm_dev_unplug() is visible to callers of this function after it completes
+ *
+ * WARNING: This function fundamentally races against drm_dev_unplug(). It is
+ * recommended that drivers instead use the underlying drm_dev_enter() and
+ * drm_dev_exit() function pairs.
*/
static inline bool drm_dev_is_unplugged(struct drm_device *dev)
{