dma-buf: clarify locking documentation for reservation_object_get_excl
authorLucas Stach <l.stach@pengutronix.de>
Thu, 11 Jan 2018 16:48:29 +0000 (17:48 +0100)
committerLucas Stach <l.stach@pengutronix.de>
Wed, 27 Feb 2019 22:51:51 +0000 (23:51 +0100)
The documentation was misleading, as for a lot of use-cases holding
the RCU read side lock is sufficient.

Signed-off-by: Lucas Stach <l.stach@pengutronix.de>
Reviewed-by: Christian König <christian.koenig@amd.com>
Link: https://patchwork.freedesktop.org/patch/msgid/20180111165302.25556-2-l.stach@pengutronix.de
include/linux/reservation.h

index 2f0ffca357807858c8446ad2d4051dec853481e8..ee750765cc9411fcfa84236ac57439520bc81027 100644 (file)
@@ -228,7 +228,8 @@ reservation_object_unlock(struct reservation_object *obj)
  * @obj: the reservation object
  *
  * Returns the exclusive fence (if any).  Does NOT take a
- * reference.  The obj->lock must be held.
+ * reference. Writers must hold obj->lock, readers may only
+ * hold a RCU read side lock.
  *
  * RETURNS
  * The exclusive fence or NULL