From patchwork Fri May 17 14:12:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Harry Wentland X-Patchwork-Id: 10948019 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id DE18A76 for ; Fri, 17 May 2019 14:12:50 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id CD1A0201F5 for ; Fri, 17 May 2019 14:12:50 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B7EEF2810E; Fri, 17 May 2019 14:12:50 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.2 required=2.0 tests=BAYES_00,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 601F328066 for ; Fri, 17 May 2019 14:12:50 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 47BD089885; Fri, 17 May 2019 14:12:48 +0000 (UTC) X-Original-To: dri-devel@lists.freedesktop.org Delivered-To: dri-devel@lists.freedesktop.org Received: from NAM04-BN3-obe.outbound.protection.outlook.com (mail-eopbgr680067.outbound.protection.outlook.com [40.107.68.67]) by gabe.freedesktop.org (Postfix) with ESMTPS id 39EA989885 for ; Fri, 17 May 2019 14:12:47 +0000 (UTC) Received: from DM3PR12CA0120.namprd12.prod.outlook.com (2603:10b6:0:51::16) by DM5PR12MB1276.namprd12.prod.outlook.com (2603:10b6:3:79::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1900.17; Fri, 17 May 2019 14:12:45 +0000 Received: from CO1NAM03FT008.eop-NAM03.prod.protection.outlook.com (2a01:111:f400:7e48::206) by DM3PR12CA0120.outlook.office365.com (2603:10b6:0:51::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1900.16 via Frontend Transport; Fri, 17 May 2019 14:12:44 +0000 Received-SPF: None (protection.outlook.com: amd.com does not designate permitted sender hosts) Received: from SATLEXCHOV01.amd.com (165.204.84.17) by CO1NAM03FT008.mail.protection.outlook.com (10.152.80.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.1900.16 via Frontend Transport; Fri, 17 May 2019 14:12:43 +0000 Received: from hwentlanhp.amd.com (10.180.168.240) by SATLEXCHOV01.amd.com (10.181.40.71) with Microsoft SMTP Server id 14.3.389.1; Fri, 17 May 2019 09:12:41 -0500 From: Harry Wentland To: Subject: [PATCH] drm/connector: Add doc for content_protection tri-state Date: Fri, 17 May 2019 10:12:14 -0400 Message-ID: <20190517141214.32627-1-harry.wentland@amd.com> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-Office365-Filtering-HT: Tenant X-Forefront-Antispam-Report: CIP:165.204.84.17; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(136003)(39860400002)(396003)(376002)(346002)(2980300002)(428003)(189003)(199004)(50466002)(68736007)(186003)(2616005)(2906002)(70206006)(70586007)(44832011)(486006)(26005)(476003)(2351001)(77096007)(72206003)(14444005)(6916009)(5024004)(478600001)(48376002)(126002)(81166006)(53416004)(50226002)(47776003)(356004)(6666004)(86362001)(54906003)(53936002)(7696005)(305945005)(4326008)(8936002)(5660300002)(36756003)(336012)(81156014)(426003)(1076003)(8676002)(316002)(51416003)(2870700001); DIR:OUT; SFP:1101; SCL:1; SRVR:DM5PR12MB1276; H:SATLEXCHOV01.amd.com; FPR:; SPF:None; LANG:en; PTR:InfoDomainNonexistent; MX:1; A:1; X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 5e7805f8-7ec8-4c5b-3c81-08d6dad1bb24 X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600141)(711020)(4605104)(2017052603328); SRVR:DM5PR12MB1276; X-MS-TrafficTypeDiagnostic: DM5PR12MB1276: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:6430; X-Forefront-PRVS: 0040126723 X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam-Message-Info: 4ckkg0kcehakiGghT3mPub8hjSNG0slL6DsbGWATGn1pyeQIOn9UM2fihP0NRV02oW33I1WCrHDclC7jEG6DisLt3ZbfUf3zXEZ8IKPIPvVvh19TcfR9r3yLULBh1pIf5Q1Df3nM6oMpF0ILjmqf+RtOqsYOxQmd1aY67qZBnzXTho3zcquOWS0jrZVSIpyeCxu9+GbbgNN1rJKU/dWd62WR2316+uRdUj64KV1f2bXP9e3YwWZRZETwXElmN0T01sg4W9i8nQbQegpm0/9oce97ujyaFNgSxMGQ013zsiuG9zeGz+63sGy749V/vXIFdBf8Rf31mHP95t3TkjYj+dFeUQNiUTTU3ZOMkGcXWCGxOcB704lgGRGB/krFmBz2Zu2+ZDjP67t/1GSlzq2iYqAohz7hT3O4/grFwn2HEhY= X-OriginatorOrg: amd.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 May 2019 14:12:43.0749 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 5e7805f8-7ec8-4c5b-3c81-08d6dad1bb24 X-MS-Exchange-CrossTenant-Id: 3dd8961f-e488-4e60-8e11-a82d994e183d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=3dd8961f-e488-4e60-8e11-a82d994e183d; Ip=[165.204.84.17]; Helo=[SATLEXCHOV01.amd.com] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR12MB1276 X-Mailman-Original-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amdcloud.onmicrosoft.com; s=selector1-amdcloud-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=7AxbF7YsJ5k4OehccJI+FS1+r2orHOcp4fPyr4EiBfI=; b=zTt4XQYFnI90lDoT3+8P5dk36dcAMahykh9n1b+uo2td+wzpWZ98681EWbAwyiEL83nfPh5Z0FvAb7o9YCq0pfnrdILYQ10t/58VhTgff612FYPKXxvaYrIzKZoLegkH0UdwP7smt5KWTeDYCuOnmxnYfJamsP9dyybeIyB2y9E= X-Mailman-Original-Authentication-Results: spf=none (sender IP is 165.204.84.17) smtp.mailfrom=amd.com; poorly.run; dkim=none (message not signed) header.d=none;poorly.run; dmarc=permerror action=none header.from=amd.com; X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Sean Paul , Sean Paul , Bhawanpreet Lakha Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" X-Virus-Scanned: ClamAV using ClamSMTP 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 Cc: Sean Paul Cc: Sean Paul Cc: Bhawanpreet Lakha Reviewed-by: Sean Paul --- 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: