Received: by 2002:a05:6a10:7420:0:0:0:0 with SMTP id hk32csp4401177pxb; Mon, 21 Feb 2022 20:22:27 -0800 (PST) X-Google-Smtp-Source: ABdhPJyBGibfWskhP9giiOHOyXmL8Le/SXM3Tt+CdgYHoEjHtsRnY4BlFK64jNbs3KMwqoXRa2Jn X-Received: by 2002:a17:90a:5213:b0:1b9:c042:3b35 with SMTP id v19-20020a17090a521300b001b9c0423b35mr2233515pjh.160.1645503746846; Mon, 21 Feb 2022 20:22:26 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1645503746; cv=none; d=google.com; s=arc-20160816; b=F3iWuFeU/43wGIHnmRX0iA3zLi3nTB9Hsx7+OkyaREkDB6rPK4dQ475ehiPS/U+S4w zBZYflGkSll6tZAdL3tZhRMzmGwAbBkjiqF+OLWJH0/l8eXvImgCi/rJQWAQWRrE8ynx Yt9Ue9A9FaRtW5JW/+vUTl8jezgI8XYG980p+auaL9viypQ2qa1ZFKmgNf1P23c5r4bU rwx/bF9rwJCoUijGQA/nmyze/pBZLuP8Cvq5hdIIxE2kR5KnkJZZAe0r6DgjQxP/RBIn eYgiq2Rl4FAObwIZ7Bvv6ZID6RtXyrwvJcgOwT1SWtaHpZdSqEOVuPyZjns7HgVqiSxu XUhA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from:dkim-signature; bh=CPHPXRq+TeE3UShHGwd96INoL6b4PPxk7yBtBpNOabc=; b=07dviS+6I8WKocdVIsaPLwHQfc9bzkT7fgdD0KlAycv/5QJr4cUtN9vgrY4Vg8oWRq +sqWe+BBWDxVUjVJVNu6y/gTqPbfJiHv3zpCtB+zRwa1AVfwNtPDTorAfbgakixQsk/g Av31SzHGPA/8g4pQ/t7FM5XLu8eX+bKxOixVG6qbYb0g/RGVESinMQ2QWyB1xvFxBN2A 8rQTXq0r4pcxlKmSwj1lNwP4ALsCwv2uOFIaCoRiMtMF1zWGptg3gR5GouY5VcfoEEXs yQpfc1B2Hi7rEpE+DTL6uHCsEi4dwLlxgjq/od7sMpy0Te2FPSyGrXzwfblK/l63gCQf mK7A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=UXVJl8OQ; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=collabora.com Return-Path: Received: from lindbergh.monkeyblade.net (lindbergh.monkeyblade.net. [23.128.96.19]) by mx.google.com with ESMTPS id m1si1748291plx.148.2022.02.21.20.22.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 21 Feb 2022 20:22:26 -0800 (PST) Received-SPF: softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) client-ip=23.128.96.19; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=UXVJl8OQ; spf=softfail (google.com: domain of transitioning linux-kernel-owner@vger.kernel.org does not designate 23.128.96.19 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=collabora.com Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by lindbergh.monkeyblade.net (Postfix) with ESMTP id 284F5C7E; Mon, 21 Feb 2022 20:17:20 -0800 (PST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232816AbiBUTiW (ORCPT + 99 others); Mon, 21 Feb 2022 14:38:22 -0500 Received: from mxb-00190b01.gslb.pphosted.com ([23.128.96.19]:56054 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233106AbiBUTiK (ORCPT ); Mon, 21 Feb 2022 14:38:10 -0500 Received: from bhuna.collabora.co.uk (bhuna.collabora.co.uk [IPv6:2a00:1098:0:82:1000:25:2eeb:e3e3]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 810A423BCF; Mon, 21 Feb 2022 11:37:40 -0800 (PST) Received: from [127.0.0.1] (localhost [127.0.0.1]) (Authenticated sender: nicolas) with ESMTPSA id B16341F43D58 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1645472259; bh=ppkjAqsyefNanhA6ebbN+nOWgkrenoU3SYfcyrnCW9U=; h=From:To:Cc:Subject:Date:From; b=UXVJl8OQpjuFzsctC70VXjMowE4u/MClizz+0R07tdlyi4D/ePgvcJ17qe6xyx5L7 RST1wUjyIIezhSv3Wc102bupCZ9AU+lKxqhQHPukmAzg9zNlHOANUsJAztS6siaHE/ mJ42kjp2lpjDzgQOyJEWcszvlY2U8OnPIEVnJPF4PxRinzgM/wR8xH5jxE/0rJOIn3 TDrffNLQBlK3Y+ZxFG4t5lLnIYXoTuuXKGm18ZjCoI/obHr5LCj4o7Q+smY7pYdoGH RczE0mFJffSNF+ixZY2HnnxWzXry75dTH7VRWQtjVA0GuI/cQNEcPwmuCO6OmQ2tkz OqxmFoDJjFNOg== From: Nicolas Dufresne To: Mauro Carvalho Chehab Cc: kernel@collabora.com, Nicolas Dufresne , linux-media@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v1] doc: media: Document VP9 reference_mode miss-placement Date: Mon, 21 Feb 2022 14:37:27 -0500 Message-Id: <20220221193728.808414-1-nicolas.dufresne@collabora.com> X-Mailer: git-send-email 2.35.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-2.0 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RDNS_NONE,SPF_HELO_NONE,T_SCC_BODY_TEXT_LINE, UNPARSEABLE_RELAY autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org The reference_mode derived syntax is part of the compressed headers and should have been moved into the corresponding control structure. Document this mistake. The value can be set to 0 if the driver does not require compressed headers information. Signed-off-by: Nicolas Dufresne --- .../userspace-api/media/v4l/ext-ctrls-codec-stateless.rst | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst index cc080c4257d01..ec48e4acb5ece 100644 --- a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst @@ -1692,7 +1692,12 @@ See section '7.3.1 Tx mode semantics' of the :ref:`vp9` specification for more d * - __u8 - ``reference_mode`` - Specifies the type of inter prediction to be used. See - :ref:`Reference Mode` for more details. + :ref:`Reference Mode` for more details. Note that + this is derived as part of the compressed header parsing process and + for this reason should have bee part of + :c:type: `v4l2_ctrl_vp9_compressed_hdr` optional control. It is safe to + set this value to zero if the driver does not require compressed + headers. * - __u8 - ``reserved[7]`` - Applications and drivers must set this to zero. -- 2.35.1