From patchwork Thu Jul 20 08:08:28 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomi Valkeinen X-Patchwork-Id: 123086 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:c923:0:b0:3e4:2afc:c1 with SMTP id j3csp2964969vqt; Thu, 20 Jul 2023 01:20:01 -0700 (PDT) X-Google-Smtp-Source: APBJJlGB6uQl3Q0EEjNWzsPNM//R7aGiI5iPTXauMIdI5fDXnHuSGsQPeeLxpXJUuZWtCHH1pa0g X-Received: by 2002:a17:907:75c3:b0:993:e94e:7234 with SMTP id jl3-20020a17090775c300b00993e94e7234mr3807275ejc.77.1689841201715; Thu, 20 Jul 2023 01:20:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1689841201; cv=none; d=google.com; s=arc-20160816; b=rs1KAyWCPteO3N/G1ZXO73Ru7hpHikw/ejhAKKTbMjtixgwgpBBUd7xMZfkdXZpcaN vYyH2TFu0RkRFnc8VF8VocuJTHPheaSsvPRzKKHdMZZqb5MfVNMXHVaWvn4X9lHbOAOn OFyEsZ0gsXz9eu1VyjyAriW1RybscULBblcMm3xuREPia7AwUE8p7zJBHqACOA1kn4cn qgfV4AnDKOFvjjXQyxSvni7Wo3PugbbqEgohcMy9x6nMwBwdlgo+uAvtjPRkh6FfzdB2 q6iE/57u8uPdv5nHe1QBBYdE7jpatLObyR024mlllW9mZoGtYkQEkW+/VPjBzSctv5n4 9TUA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:message-id:content-transfer-encoding :mime-version:subject:date:from:dkim-signature; bh=oPK/sOuq6ZxITjySRFz4oZQLnh1kIcVzHaLW9ymFTAE=; fh=Q+FjMqOqVUKsRhJ5OA0GRqOlNCJLvfsJjdlum9y78pE=; b=pv5VUPa0ZgA8uhDIdJabqq7S4KLfCsnL7LgDmuUUQnMyW2PDTMi7iHSKe0ud66w3s8 bk3zujfMXJLcXKF/8eSc6dm8w/6fOWHAi2l4EMebcm49ae/ddxQKICosu8gGyko6j8fD 08HoONE3FcqUza61S9+jAUXUScEuY1qjBPDQXxwsH/Yh4XqBWjWPbtX2gkQp6cCZM0DO 9GVVi4mHLIQuv1gLjiUz34DqHa24cl87zmIv+tFMV3yKv8Jfog/NiRKn1joeIUMFVG4Y 5oKAPRPsFLx7N2Xw9ji4Xdznh3mH5j1HHvayC+JkG3JjxBIya79l4fTKrJEDUXsczLl8 DbVQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass (test mode) header.i=@ideasonboard.com header.s=mail header.b=DzKy97fO; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id x3-20020a170906804300b00987acac4c40si326848ejw.596.2023.07.20.01.19.37; Thu, 20 Jul 2023 01:20:01 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass (test mode) header.i=@ideasonboard.com header.s=mail header.b=DzKy97fO; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230360AbjGTII6 (ORCPT + 99 others); Thu, 20 Jul 2023 04:08:58 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49860 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229610AbjGTIIy (ORCPT ); Thu, 20 Jul 2023 04:08:54 -0400 Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 6966E172A; Thu, 20 Jul 2023 01:08:53 -0700 (PDT) Received: from [127.0.1.1] (91-154-35-171.elisa-laajakaista.fi [91.154.35.171]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 4F710881; Thu, 20 Jul 2023 10:07:57 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1689840477; bh=0RLflJGgT6hpPA6KHXfUk4/Ymw1X82gpzplVA8mUaZM=; h=From:Date:Subject:To:Cc:From; b=DzKy97fOAmM/EN+synGAuzAQBHV+X14N2kpQQ5uJk3pzh2L+bd6jVx4HjF4U2cKyN bjSim+ITeDeqgxqlqDVVBcSniYUT7E9qaNg/0syiiC2nPdDTuRsdQpUD+mfZSSbOaw rTrinGNnoUSJs6IGDCddkU1dEjXIeh0/xfSajhQI= From: Tomi Valkeinen Date: Thu, 20 Jul 2023 11:08:28 +0300 Subject: [PATCH] media: Documentation: Fix [GS]_ROUTING documentation MIME-Version: 1.0 Message-Id: <20230720-streams-routing-doc-fix-v1-1-29ecfaa50635@ideasonboard.com> X-B4-Tracking: v=1; b=H4sIAHvruGQC/x2MSQqAMAwAvyI5G6gtLvgV8VBs1BxsJVERxL9bP M7AzANKwqTQFw8IXaycYoaqLGBafVwIOWQGa6wzrTWoh5DfFCWdB8cFQ5pw5htdaBrjqauo9pD rXSjr/zyM7/sB8fEr/2kAAAA= To: Mauro Carvalho Chehab , Hans Verkuil Cc: linux-media@vger.kernel.org, linux-kernel@vger.kernel.org, Tomi Valkeinen X-Mailer: b4 0.12.3 X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED, SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham 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 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1771926928271448761 X-GMAIL-MSGID: 1771926928271448761 Add mention that successful VIDIOC_SUBDEV_G_ROUTING call will update 'num_routes' and remove mention about non-existing streams, which is incorrect. Fixes: ea73eda50813 ("media: Documentation: Add GS_ROUTING documentation") Signed-off-by: Tomi Valkeinen --- Documentation/userspace-api/media/v4l/vidioc-subdev-g-routing.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) --- base-commit: 28999781d15f94046e6c23a9a7d92ad28a436abf change-id: 20230720-streams-routing-doc-fix-3d660ae81e5a Best regards, diff --git a/Documentation/userspace-api/media/v4l/vidioc-subdev-g-routing.rst b/Documentation/userspace-api/media/v4l/vidioc-subdev-g-routing.rst index 2d6e3bbdd040..72677a280cd6 100644 --- a/Documentation/userspace-api/media/v4l/vidioc-subdev-g-routing.rst +++ b/Documentation/userspace-api/media/v4l/vidioc-subdev-g-routing.rst @@ -58,6 +58,9 @@ the subdevice exposes, drivers return the ENOSPC error code and adjust the value of the ``num_routes`` field. Application should then reserve enough memory for all the route entries and call ``VIDIOC_SUBDEV_G_ROUTING`` again. +On a successful ``VIDIOC_SUBDEV_G_ROUTING`` call the driver updates the +``num_routes`` field to reflect the actual number of routes returned. + .. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}| .. c:type:: v4l2_subdev_routing @@ -138,9 +141,7 @@ ENOSPC EINVAL The sink or source pad identifiers reference a non-existing pad, or reference - pads of different types (ie. the sink_pad identifiers refers to a source pad) - or the sink or source stream identifiers reference a non-existing stream on - the sink or source pad. + pads of different types (ie. the sink_pad identifiers refers to a source pad). E2BIG The application provided ``num_routes`` for ``VIDIOC_SUBDEV_S_ROUTING`` is