From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id D872FC433EF for ; Thu, 7 Jul 2022 17:01:07 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=8lr2w9XtGHxw1jwPw88tWfU3rDQxW5omdP/YejHJVnQ=; b=1kA+gKEECGnlgy fwVo5DnAm1DNErb/PAcyMHJDmCd6xEYVz/TJ8rX+CoSmvbnCAL85IKl5cv6misOI7ahAH3QnWafgx Z4ME9NGVS3y81AzifknSjIT6N8g3+SsAANtWpBRxegZb2jy1o2SaWRv5SfGlvZUAOe2viy7WDGg4M 7fCAxyfHUZX4UbLd1C85jaeGadXfwyUyUmTSoSKaqqo6NG/hc6n0zsQ8yqihK2w13nn9NhLVosfDG tZyb238+n01efcvzS63HHOlvvJOzpBgeWhjGeASTR6MRjdVbVwM7C6g1Zd0YjXsUH0jSj8dM+snYZ eM3ekEsMn76MZEcm4q1g==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1o9Ur4-00H6iE-Eq; Thu, 07 Jul 2022 16:59:54 +0000 Received: from mail-pf1-x42f.google.com ([2607:f8b0:4864:20::42f]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1o9Uqd-00H6ZZ-UA for linux-arm-kernel@lists.infradead.org; Thu, 07 Jul 2022 16:59:29 +0000 Received: by mail-pf1-x42f.google.com with SMTP id n12so20657440pfq.0 for ; Thu, 07 Jul 2022 09:59:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=mouOf2yAGvzJretTdCLBZi7N9va1QAabtNdEx7dOaxA=; b=Iy06ZYNTT2bDPb3p26fQ1eLYPMR1Pfuej5t6SevUQcccl5Lf2yH7jGv/eRdB0SrGoZ n3HgRlZd4H8DvQKLEmTIR9zQQoL7zeUbHkifv0bN/i3f3n413ely87lB3uImJ6M5Y/9V 3zVoc8ssOi7Pp8RDPDCBNHngpchR+S7+RXsm9k0LDq2q5IxZPKh99yWve6IJyQIOwwIt bTh2urfAxauiKwEN7SfwNumJgEPIJd43h40ptT+Zay81OCik+yZBubzm7HixxJWX8pyN S3nSEhHkhI/BQbqfbW/xItKbsOVj5//o4/KNV9ySCNnxnvz8CKcuMWMqtCaaxfFNx/cg Uymg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=mouOf2yAGvzJretTdCLBZi7N9va1QAabtNdEx7dOaxA=; b=WmqnxFmGsw6VEpKPwQnQ++laCwbCiRITmUJeje4z1UUhuOKPc27t+VoPfil6KblECy kAfhSqnuJE2+0VL+pwn/saxjBHlQ2Dcw5BQowpCDaBj9MIixsxjUNfoCYL/Gw4BurO0G Y9eCBvzlZx0TxaQIzZ20yo0jrvApzj57trzro5g4zDqqpjAKiK/jjnmJzrHgux7m5XxZ Y2U6zsMST9v3XBwOESSlMqtXiV4jC297aRqpKYkYUtmUL3tBeHmCtupHeQi+aGTGLqk+ WMwjC14LZ/H9gJnpoJ5QkC0yWQXuLd+oquSeq7SeolPci0jvdJvP4NWaBYbq0k6MwAo8 adSA== X-Gm-Message-State: AJIora97OTgwxMVide30AGejpXIUQ37YYaYDN2XW9dzLbVBpIlnTfLsu OjXmJSAWsCzXRs53SazPbfw= X-Google-Smtp-Source: AGRyM1sqcCTln+QfjvynadCg0/JVQxDlFzJBICdvbGJkQLTJgO7dthIug1H0T4b1oVJhKKoKKDJXsg== X-Received: by 2002:a17:90a:bd92:b0:1ef:82d8:f2b9 with SMTP id z18-20020a17090abd9200b001ef82d8f2b9mr6051221pjr.83.1657213167120; Thu, 07 Jul 2022 09:59:27 -0700 (PDT) Received: from jaschultz-Thelio-Major.corp.microsoft.com ([2001:4898:80e8:37:6a04:c27c:dcee:eb11]) by smtp.gmail.com with ESMTPSA id v14-20020aa7808e000000b00518e1251197sm28184185pff.148.2022.07.07.09.59.26 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Jul 2022 09:59:26 -0700 (PDT) From: Jarrett Schultz X-Google-Original-From: Jarrett Schultz To: Dmitry Torokhov , Rob Herring , Krzysztof Kozlowski , Jonathan Corbet , Catalin Marinas , Will Deacon , Jiri Kosina , Benjamin Tissoires , Bjorn Andersson , Shawn Guo , Geert Uytterhoeven , Marcel Ziswiler , Biju Das , Dmitry Baryshkov , Vinod Koul Cc: Dmitry Antipov , linux-input@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Jarrett Schultz Subject: [PATCH v5 4/6] Documentation: Correction in HID output_report callback description. Date: Thu, 7 Jul 2022 09:59:00 -0700 Message-Id: <20220707165902.3184-5-jaschultzMS@gmail.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220707165902.3184-1-jaschultzMS@gmail.com> References: <20220707165902.3184-1-jaschultzMS@gmail.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220707_095928_033208_AAF389CD X-CRM114-Status: GOOD ( 13.92 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org From: Jarrett Schultz Originally output_report callback was described as must-be asynchronous, but that is not the case in some implementations, namely i2c-hid. Correct the documentation to say that it may be asynchronous. Signed-off-by: Dmitry Antipov --- Documentation/hid/hid-transport.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/hid/hid-transport.rst b/Documentation/hid/hid-transport.rst index 6f1692da296c..2008cf432af1 100644 --- a/Documentation/hid/hid-transport.rst +++ b/Documentation/hid/hid-transport.rst @@ -327,8 +327,8 @@ The available HID callbacks are: Send raw output report via intr channel. Used by some HID device drivers which require high throughput for outgoing requests on the intr channel. This - must not cause SET_REPORT calls! This must be implemented as asynchronous - output report on the intr channel! + must not cause SET_REPORT calls! This call might be asynchronous, so the + caller should not expect an immediate response! :: -- 2.25.1 _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel