From nobody Mon Sep 28 14:46:27 2026 Received: from mail-pg1-f179.google.com (mail-pg1-f179.google.com [209.85.215.179]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 60D2D337BAB for ; Fri, 21 Aug 2026 05:03:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787288607; cv=none; b=Lyr3E05T3/B/r2khOmE80hCYb2ZL9t+aw+asDm8XxNLmqpBoD6errP/V6D47t1FQmOVQrZCgQ9lszSbPwuvSqDHeTBb4pzQAxMpugGn8Nzs8uPYCeGglyyt1uBfT/iWjNagd8BYGhvI55WYLK9vjgOjQfi3BudofJ2yw72vkWEc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787288607; c=relaxed/simple; bh=CkFcnYrJr4cU+t0pt8E/I5SSVnxKOnIqrTf+yKl113I=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=X2xnMJ8KIpS9rf3IXSkv/vx/Nbzj4/DOicv9iZlY5hoBwArpgJt/cvZDMSqNjiqA1IREFfz4xtL9+fvTjknL2P8KH+4V10IyvKtAW54vXrz0OPeI7ffkgoikPF967FvSe+keTVenSC7EZluCazyNTEStotLF1W6nUWrJSUHlw2k= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=DxyjvDW+; arc=none smtp.client-ip=209.85.215.179 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="DxyjvDW+" Received: by mail-pg1-f179.google.com with SMTP id 41be03b00d2f7-cbee846deecso722144a12.1 for ; Thu, 20 Aug 2026 22:03:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1787288606; x=1787893406; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=FAQIFeKdsDioxUGJtAjD1TEqdlw3Fo0BSbJ+hyxm5bA=; b=DxyjvDW+Ktl7vjxIA1W4M+tbQG+9bcay+ylkQBFk5so2jkmdWttnmr1LMj4M1XphNk m4YsBQBw7o2mWFNqhmwlHmW+sFTxGLF2/sfSfFQbC3Sim8kQwsrbVPcedmj8Q1hu5rFj h9yQP3jHHfdWuu8wDJI1Ceqqzfy2UNsRWVcx4BmzxLQU0B+u669IgRJu+hNnHxMsbpW/ Su56HNohhfecj18ly3FYKKTYcwWnjHrE8RVqs3vO3Hd5JuoPJAkfxCRiRkssO+fBc6Ht jB8D+glBeJe9effBB2PyRGx+9z6yF+o1IM+yHjaBxLPB7BqYnQTrm8gRnR56REIuRKz5 fDPQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1787288606; x=1787893406; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=FAQIFeKdsDioxUGJtAjD1TEqdlw3Fo0BSbJ+hyxm5bA=; b=d/obDcOV2kHRPtObrnab9OyhoVGpGYVuv/Rb8XfHE7ohUghiSgwXLDWO6Uicgrl2wn lnITnpjjgbFPRw2dR+CaqTmTn4VosynBr0alxzJOTximidoXm40ufgZRnJqYjaTqgUSQ lHd9ttlVm1JexbmLEh29uZDOlTw3hJq6MXfLfrVYWsAmmRjSgY3PCRho2uDzD+nFJIbv Kt1OBDVlO9dGil/yqlV1cWZL5WpFO5WgBbl6deGrbMbukRIKsgBNPWP/qD8DMKKx9ZQg 1qJ0Bw4tjdG1uMuV6Pomsa/YNIWgMNRGY+DTWcbtNTjrihHtksHw4E6Z4TKgUJXDKm+s 5e1g== X-Forwarded-Encrypted: i=1; AHgh+Rp0bxiC+CdCobd/zaxZTVsr8zABtUm0jeIGOANsTPeWAZqPuZGUetiYesBF6/rj3OR2kUv9LYnrmtoF2x4=@vger.kernel.org X-Gm-Message-State: AFuF++nRZdaC52qCBOlxiD+ieUTscLz4ODPWNIwjIxcus4oykZeHBFG2 0wsthGH3kyMELm0NAFbvTNXjDRusgr9dSM2NP0pAutKh2DzGH1TleTwU X-Gm-Gg: AR+sD11V35xqEz2Z8qUaQAJKJOC0gmz3RkmRWoisoal5FmtUwsZFRi/ndhdn1l4bnvX rCZWzItbVqxQ8/PaHFXgiT2cr9Js4sWjl7GDQrv2ZuHFsSumZG3Bkwmx06pyilBLbzYxcCgzgXb GuaMvjJLMYmOw8MSzWYqmE0pziFsnBl4SjqLDAGtbQk/kY0ojuDa8lXhu/W0OuA556ct7Id3lw/ 0xvlLVj7YmJAL3cNlybLhccJOZ6XqaPG8r+2WVBlebblkqv3uKBBVy/1u1pVB0OjtnUldHkwj1z 2L4AMAx8/3WhpZWbqJMwiRugZc3dZCx5BCmvBCc+ERosSJN+XKkBN7MaKInYq8ELbO1Ksr01uPx YGOGa7UUwhYUZKAMrnCI+um+JX1WGyMjQSUR88z0l2il/bzRZ2WdwngUt/16a5OmSR3ntP2GJw3 orcJf/JN/34NnSDb59SgwPRkoZg9cJG1ikkGksVh4tXqSCBXFVvYoXrt/Z32BsyA== X-Received: by 2002:a17:90b:54d0:b0:36d:b424:4f17 with SMTP id 98e67ed59e1d1-395c35188fcmr7567404a91.1.1787288605580; Thu, 20 Aug 2026 22:03:25 -0700 (PDT) Received: from kdev.. ([108.180.130.139]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-395c4baa594sm1511835a91.17.2026.08.20.22.03.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 20 Aug 2026 22:03:24 -0700 (PDT) From: Babanpreet Singh To: Amirreza Zarrabi , Jens Wiklander Cc: Sumit Garg , linux-arm-msm@vger.kernel.org, op-tee@lists.trustedfirmware.org, linux-kernel@vger.kernel.org, Babanpreet Singh Subject: [PATCH v2] tee: qcomtee: fix kernel-doc warnings Date: Fri, 21 Aug 2026 05:03:23 +0000 Message-ID: <20260821050323.7-1-bbnpreetsingh@gmail.com> X-Mailer: git-send-email 2.47.3 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Fix kernel-doc issues present since the driver was added in commit d6e290837e50 ("tee: add Qualcomm TEE driver"): - async_release() documents its second parameter as @msg, but the parameter is named async_msg (msg is a local variable); - struct qcomtee_msg_object_invoke documents member @ctx, but the member is named cxt; - enum qcomtee_arg_type leaves QCOMTEE_ARG_TYPE_NR undescribed. The cxt spelling is part of the QTEE message format and is used throughout the driver; struct qcomtee_msg_callback in the same header already documents it as @cxt, so the comment is corrected rather than the member. No functional changes. Fixes: d6e290837e50 ("tee: add Qualcomm TEE driver") Reviewed-by: Amirreza Zarrabi Assisted-by: Claude:claude-opus-5 [kernel-doc] Signed-off-by: Babanpreet Singh --- v2: - add the Fixes tag Jens asked for; no code changes - pick up Amirreza's Reviewed-by v1: https://lore.kernel.org/all/20260802003956.7-1-bbnpreetsingh@gmail.com/ drivers/tee/qcomtee/async.c | 4 ++-- drivers/tee/qcomtee/qcomtee_msg.h | 2 +- drivers/tee/qcomtee/qcomtee_object.h | 1 + 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/drivers/tee/qcomtee/async.c b/drivers/tee/qcomtee/async.c index 31bff4309e672..5849e51612033 100644 --- a/drivers/tee/qcomtee/async.c +++ b/drivers/tee/qcomtee/async.c @@ -97,10 +97,10 @@ static void qcomtee_get_async_buffer(struct qcomtee_obj= ect_invoke_ctx *oic, /** * async_release() - Process QTEE async release requests. * @oic: context used for the current invocation. - * @msg: async message for object release. + * @async_msg: async message for object release. * @size: size of the async buffer available. * - * Return: Size of the outbound buffer used when processing @msg. + * Return: Size of the outbound buffer used when processing @async_msg. */ static size_t async_release(struct qcomtee_object_invoke_ctx *oic, struct qcomtee_async_msg_hdr *async_msg, diff --git a/drivers/tee/qcomtee/qcomtee_msg.h b/drivers/tee/qcomtee/qcomte= e_msg.h index 878f70178a5b6..5d7b21fdd3688 100644 --- a/drivers/tee/qcomtee/qcomtee_msg.h +++ b/drivers/tee/qcomtee/qcomtee_msg.h @@ -112,7 +112,7 @@ union qcomtee_msg_arg { =20 /** * struct qcomtee_msg_object_invoke - Direct object invocation message. - * @ctx: object ID hosted in QTEE. + * @cxt: object ID hosted in QTEE. * @op: operation for the object. * @counts: number of different types of arguments in @args. * @args: array of arguments. diff --git a/drivers/tee/qcomtee/qcomtee_object.h b/drivers/tee/qcomtee/qco= mtee_object.h index 8b4401ecad48c..d5de02dcef3b9 100644 --- a/drivers/tee/qcomtee/qcomtee_object.h +++ b/drivers/tee/qcomtee/qcomtee_object.h @@ -74,6 +74,7 @@ enum qcomtee_object_type { * @QCOMTEE_ARG_TYPE_OO: output object (OO). * @QCOMTEE_ARG_TYPE_IB: input buffer (IB). * @QCOMTEE_ARG_TYPE_IO: input object (IO). + * @QCOMTEE_ARG_TYPE_NR: number of argument types. * * Use the invalid type to specify the end of the argument array. */ base-commit: 2d2338c93da79b3bfe4b6099a931d9468d539952 --=20 2.43.0