diff mbox series

drm/connector: Add doc for content_protection tri-state

Message ID 20190517141214.32627-1-harry.wentland@amd.com (mailing list archive)
State New, archived
Headers show
Series drm/connector: Add doc for content_protection tri-state | expand

Commit Message

Harry Wentland May 17, 2019, 2:12 p.m. UTC
It was there all along in the patch description when this change was
introduced but it would be helpful to have the same documented in the
code.

Signed-off-by: Harry Wentland <harry.wentland@amd.com>
Cc: Sean Paul <seanpaul@chromium.org>
Cc: Sean Paul <sean@poorly.run>
Cc: Bhawanpreet Lakha <Bhawanpreet.Lakha@amd.com>
---
 drivers/gpu/drm/drm_connector.c | 9 +++++++++
 1 file changed, 9 insertions(+)

Comments

Sean Paul May 17, 2019, 3 p.m. UTC | #1
On Fri, May 17, 2019 at 10:12 AM Harry Wentland <harry.wentland@amd.com> wrote:
>
> It was there all along in the patch description when this change was
> introduced but it would be helpful to have the same documented in the
> code.
>
> Signed-off-by: Harry Wentland <harry.wentland@amd.com>
> Cc: Sean Paul <seanpaul@chromium.org>
> Cc: Sean Paul <sean@poorly.run>
> Cc: Bhawanpreet Lakha <Bhawanpreet.Lakha@amd.com>

Reviewed-by: Sean Paul <sean@poorly.run>

> ---
>  drivers/gpu/drm/drm_connector.c | 9 +++++++++
>  1 file changed, 9 insertions(+)
>
> diff --git a/drivers/gpu/drm/drm_connector.c b/drivers/gpu/drm/drm_connector.c
> index b34c3d38bf15..c53e51ad3b59 100644
> --- a/drivers/gpu/drm/drm_connector.c
> +++ b/drivers/gpu/drm/drm_connector.c
> @@ -1519,6 +1519,15 @@ EXPORT_SYMBOL(drm_connector_attach_scaling_mode_property);
>   * Content Protection is intentionally vague to allow for different underlying
>   * technologies, however it is most implemented by HDCP.
>   *
> + * The property is a tri-state with the following values:
> + * - OFF: Self explanatory, no content protection
> + * - DESIRED: Userspace requests that the driver enable protection
> + * - ENABLED: Once the driver has authenticated the link, it sets this value
> + *
> + * The driver is responsible for downgrading ENABLED to DESIRED if the link becomes
> + * unprotected. The driver should also maintain the desiredness of protection
> + * across hotplug/dpms/suspend.
> + *
>   * The content protection will be set to &drm_connector_state.content_protection
>   *
>   * Returns:
> --
> 2.21.0
>
diff mbox series

Patch

diff --git a/drivers/gpu/drm/drm_connector.c b/drivers/gpu/drm/drm_connector.c
index b34c3d38bf15..c53e51ad3b59 100644
--- a/drivers/gpu/drm/drm_connector.c
+++ b/drivers/gpu/drm/drm_connector.c
@@ -1519,6 +1519,15 @@  EXPORT_SYMBOL(drm_connector_attach_scaling_mode_property);
  * Content Protection is intentionally vague to allow for different underlying
  * technologies, however it is most implemented by HDCP.
  *
+ * The property is a tri-state with the following values:
+ * - OFF: Self explanatory, no content protection
+ * - DESIRED: Userspace requests that the driver enable protection
+ * - ENABLED: Once the driver has authenticated the link, it sets this value
+ *
+ * The driver is responsible for downgrading ENABLED to DESIRED if the link becomes
+ * unprotected. The driver should also maintain the desiredness of protection
+ * across hotplug/dpms/suspend.
+ *
  * The content protection will be set to &drm_connector_state.content_protection
  *
  * Returns: