drm/hdcp: update content protection property with uevent

[sfrench/cifs-2.6.git] / drivers / gpu / drm / drm_connector.c

diff --git a/drivers/gpu/drm/drm_connector.c b/drivers/gpu/drm/drm_connector.c
index cddb97f754154abf6651bc5d7ab2052e4f98cd3f..354798bad57649898a2f2cc01140afa964929280 100644 (file)
--- a/drivers/gpu/drm/drm_connector.c
+++ b/drivers/gpu/drm/drm_connector.c
@@ -983,10 +983,19 @@ static const struct drm_prop_enum_list hdmi_colorspaces[] = {
  *     - If the state is DESIRED, kernel should attempt to re-authenticate the
  *       link whenever possible. This includes across disable/enable, dpms,
  *       hotplug, downstream device changes, link status failures, etc..
- *     - Userspace is responsible for polling the property to determine when
- *       the value transitions from ENABLED to DESIRED. This signifies the link
- *       is no longer protected and userspace should take appropriate action
- *       (whatever that might be).
+ *     - Kernel sends uevent with the connector id and property id through
+ *       @drm_hdcp_update_content_protection, upon below kernel triggered
+ *       scenarios:
+ *             DESIRED -> ENABLED      (authentication success)
+ *             ENABLED -> DESIRED      (termination of authentication)
+ *     - Please note no uevents for userspace triggered property state changes,
+ *       which can't fail such as
+ *             DESIRED/ENABLED -> UNDESIRED
+ *             UNDESIRED -> DESIRED
+ *     - Userspace is responsible for polling the property or listen to uevents
+ *       to determine when the value transitions from ENABLED to DESIRED.
+ *       This signifies the link is no longer protected and userspace should
+ *       take appropriate action (whatever that might be).
  *
  * HDCP Content Type:
  *     This Enum property is used by the userspace to declare the content type