From patchwork Thu May 19 07:34:10 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Krzysztof Kozlowski X-Patchwork-Id: 574319 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2454FC433F5 for ; Thu, 19 May 2022 07:34:21 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230130AbiESHeS (ORCPT ); Thu, 19 May 2022 03:34:18 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38560 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231389AbiESHeQ (ORCPT ); Thu, 19 May 2022 03:34:16 -0400 Received: from mail-lj1-x235.google.com (mail-lj1-x235.google.com [IPv6:2a00:1450:4864:20::235]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8CEDE939DE for ; Thu, 19 May 2022 00:34:15 -0700 (PDT) Received: by mail-lj1-x235.google.com with SMTP id bx33so5179550ljb.12 for ; Thu, 19 May 2022 00:34:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=Ld3tNTOnejY2gRdAkG0gU54wZRhtwNMujkvL4qvMwkI=; b=uVhNzYLoSIE1Q9t8tJmJL12I3Cm4x9BG9luOeDhB9VLhFK3mkwvFc/z3CCe11suOux Wb0u8LQNWoPbikl+QQONfDCMn+bgq0BmOUOnVR913Wxgo2uHIbvbr+KJ5SvvMXlJYECH 63eCCRaz9p1pkEqEGE7LuT9op0BVY5/5A6kXtFz9qVwMM0x+i4Msz/avddlxOKmbHPNW 7Q7WIbHY6F3EsYL3KaBriWyFmHL3t9XEfHC+m8cpHgPvB6PV0q28i1gJYaQ5pCvFLwiB NPxC+pWdqHVlJoAvxwV8eG2TreRRIV8bIOgEf3sOo0Zk5yEsZZkXgBN7B+sPvShPpWXO lMaQ== 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:mime-version :content-transfer-encoding; bh=Ld3tNTOnejY2gRdAkG0gU54wZRhtwNMujkvL4qvMwkI=; b=Wu2gUh7rsLmoClDAL2vuX/ndeZdJTtsNvSmVWF9zQ3zOnyB5xaZr2rOLXFleHGansH aU1Dvwn2etf0/7CrXmLI1BvaXgwzGv5uNP2I32Ss7R7R4p1sAm1JId7RPQG6MAv2aPqL eICA8kQ0p5+IDZwvTlLboyNNJzezivaobaM4taKz/2/NL/x2T3Pif/mSPO3G5SR1lQuS a8gXk03c0MxYtXOs6rhXWEGkiZNmJ/3jDF6OTOhOxXaK39yzlbAu5nVy2MSFK8r0UYL9 OUmY2y74bNA20qLOsntUaMoqwaC/skiBdSJpocSXxr1WhXqGNBhbcBVoB7YcZCHq3oq1 sNdw== X-Gm-Message-State: AOAM530WGfxM935d979D5rrMZ4zrOQT4V/KzTHZzAYEnby9diA6cotjQ 5cgm9dvGnOmFM/XCtWfJwJnwKA== X-Google-Smtp-Source: ABdhPJy5Ys+LYqZCN8u/Dc32BrKJ8PhvyCAatBFQj27NKp+j/2marUinA+vOpac2dpQockG3zQaMaQ== X-Received: by 2002:a05:651c:399:b0:24f:18d:5bbd with SMTP id e25-20020a05651c039900b0024f018d5bbdmr1824315ljp.481.1652945653930; Thu, 19 May 2022 00:34:13 -0700 (PDT) Received: from krzk-bin.. (78-11-189-27.static.ip.netia.com.pl. [78.11.189.27]) by smtp.gmail.com with ESMTPSA id w8-20020ac24428000000b0047255d2113csm187708lfl.107.2022.05.19.00.34.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 19 May 2022 00:34:13 -0700 (PDT) From: Krzysztof Kozlowski To: Andy Gross , Bjorn Andersson , linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Stephen Boyd , Krzysztof Kozlowski Subject: [PATCH v2] firmware: qcom_scm-legacy: correct kerneldoc Date: Thu, 19 May 2022 09:34:10 +0200 Message-Id: <20220519073410.7358-1-krzysztof.kozlowski@linaro.org> X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-arm-msm@vger.kernel.org Correct kerneldoc warnings like: drivers/firmware/qcom_scm-legacy.c:133: warning: Function parameter or member 'dev' not described in 'scm_legacy_call' Signed-off-by: Krzysztof Kozlowski Reviewed-by: Stephen Boyd --- Changes since v1: 1. Split series per subsystem. 2. Correct argument description (Stephen). --- drivers/firmware/qcom_scm-legacy.c | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/drivers/firmware/qcom_scm-legacy.c b/drivers/firmware/qcom_scm-legacy.c index 1829ba220576..9f918b9e6f8f 100644 --- a/drivers/firmware/qcom_scm-legacy.c +++ b/drivers/firmware/qcom_scm-legacy.c @@ -120,6 +120,9 @@ static void __scm_legacy_do(const struct arm_smccc_args *smc, /** * scm_legacy_call() - Sends a command to the SCM and waits for the command to * finish processing. + * @dev: device + * @desc: descriptor structure containing arguments and return values + * @res: results from SMC call * * A note on cache maintenance: * Note that any buffers that are expected to be accessed by the secure world @@ -211,6 +214,7 @@ int scm_legacy_call(struct device *dev, const struct qcom_scm_desc *desc, /** * scm_legacy_call_atomic() - Send an atomic SCM command with up to 5 arguments * and 3 return values + * @unused: device, legacy argument, not used, can be NULL * @desc: SCM call descriptor containing arguments * @res: SCM call return values *