From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pj1-f49.google.com (mail-pj1-f49.google.com [209.85.216.49]) (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 AE18B1C5D72 for ; Sun, 2 Aug 2026 00:39:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.49 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1785631200; cv=none; b=hVb6h9YQd24GRY4rAtwbRtxO1P+x0S5Vtqh7iMjZYLu7n0FrTaSndKpozz2qTb+J3aoTZDg3M8Ra6xFsjT+1ZdkdUoPUet4vFvWDIXIOEgprqSEUSULzKf+Rl/3wKSi9y9zED0UgR7/yf/OXp+pHjUIAPi0ZNRuAnM1J6yj147I= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1785631200; c=relaxed/simple; bh=449lDFTYzu1UCs6iHsDTtTk7jZN1jRYhqSaglmIMgRg=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=png7JK9m/cQIFSxV/Wqtiyd5Ke1i8o7T+U+KpgBBBbJ0Htuka3RkE/rhHuuk2GuvPJamDg2Ubh27nbzEO4raRvb2ZVoAEqyDSn6Nx8C4rBBszGf46bXhY8oELkwhK8xtyge1d/pXUU3/BueOhETP1v7s1mG8Ar6/sGNwR12VvnM= 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=s4/G2Fg3; arc=none smtp.client-ip=209.85.216.49 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="s4/G2Fg3" Received: by mail-pj1-f49.google.com with SMTP id 98e67ed59e1d1-38e3efab7e0so1372042a91.0 for ; Sat, 01 Aug 2026 17:39:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1785631198; x=1786235998; 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=VqnWyY0IoOHm0/Ecjq9A3hxNF1K5JS+wTtKYz611nCM=; b=s4/G2Fg3vTcoC8VrAxLkadtZ4T0HNEgy95RoX9kb2EWIRCbRQQEajeDdCvhTmfao6E MpbCSCiKhRJi9C1VNN9e0hm7+IS8SKZz7leED1p/fb3knJamjZQAd15aUXuUekmYJxzD p8R8C0zqBrUAYS3+g40I8H+839oD1Vd5QUHqvUY0wbGhdJOHPkB63WwaBSonv6KQCGhq 6q9AD753huIqxOMhSDpxaBa92YCmqyqPyIbFLsmNZGWAHM5GDgJhG2K3NiDLbMjOnkwm 7oxp3Lzt5Mwj/fjRUgtEJ6nlgSK0Psmjscjsp6SEHGMp1YArXfalzk1xHFvjFMReCcby 0Yvw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1785631198; x=1786235998; 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=VqnWyY0IoOHm0/Ecjq9A3hxNF1K5JS+wTtKYz611nCM=; b=CktMbgk9eKjdENBglNGi59t6Dd0bUQwEIaNVGWh9DmXOv7k8qLb8U7TMhvMmyMAZ2T nIc8omhTRjR6dDIwoz0N8T8j6SmGQ4A+5SvcoE/0aV6CzjR0I1vcaFResQ9E9cLsaRpP BzWHZndja+a7yY4JH4Rfb8DNQBSk2UoqUer4i2R++26l/nlgw6cMSE5gCtBYrqKIL7ch JNcsZH9aGSVVeeRIHo4XJIg7WKtXz6NtR8s9kRtNJjvslikpArEWYWztgAJrPyJLU3WP paFTMITM9bdEuFoP8GRY5fnfV1orTNKyVIV/kUBKfcKCodc2qw/hGMKYi73MwlqLgnjk tWCw== X-Forwarded-Encrypted: i=1; AHgh+Roquxeepw/7iqtkeG/zFn+dzb1mYoBSegprTySLvSOQNEkJrtpKQxuRgy5A5HiA8Ls7Ojhqb7vH2Fsvhq8=@vger.kernel.org X-Gm-Message-State: AOJu0YzIZUNWqhxg42ppFt4Q2QcX7C54XgrgCdvGEKDIetXq2WWgiFU6 +GRMqXlSp0kCRxxMMXhQTmcu9Sv9Os4rKrMJhUtdkRHmq40Y4eK/ZBFY X-Gm-Gg: AR+sD11bocfQiyaXWVCCieFW213wZwIqjhkcpfCWvq4keQ1wczcDx+tf/nx4E7f0aZe 4tj3YuaTE6tNQSP1KwagitLIxPDgCQ2RhaRWmtCaORltB6RJTBi6PQeRNJpFkooZZFSUiuQIiUo rZq09L+9qCo2U4jYa0PhUu1i2yhdFvNu6AzU6gepI5FBRiqXCCuma+Y8KCx6icbFaB/8pu2gsHD TCNDuVzD3K0PPXk+Gv7r/7YqKHDZMm+YSRZ77+LvhBdlH9tvu1Q2ytKoGNHKYSTghzYwRYQS+D4 NCljqn4GaaXDmyMqMrvM8qB4gy2bMo2e/tt93ed49IMQPRYbk515iZxcJursGa6ClKFHg0gWJCA x2XQ6t3ShvbFVh+FMUDaVUrb8ZbnFwuyXjZPFjQ1seUH2tfQZmjow8M67b74m9o2KjmlUiJmn7M qB7I+jTpi1HoWcOlLGgvI1rIUHV/itl9kUoAvTIpxR43bDiU+5hAjdjGlKFEWv X-Received: by 2002:a17:90b:5823:b0:38f:1a29:7a82 with SMTP id 98e67ed59e1d1-38fbca2363emr3552882a91.6.1785631197798; Sat, 01 Aug 2026 17:39:57 -0700 (PDT) Received: from kdev.. ([108.180.130.139]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-38fb2f657a1sm2318904a91.7.2026.08.01.17.39.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 01 Aug 2026 17:39:57 -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] tee: qcomtee: fix kernel-doc warnings Date: Sun, 2 Aug 2026 00:39:56 +0000 Message-ID: <20260802003956.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: 8bit 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. Assisted-by: Claude:claude-opus-5 [kernel-doc] Signed-off-by: Babanpreet Singh --- 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_object_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/qcomtee_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 { /** * 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/qcomtee_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. */ -- 2.43.0