[{"id":3685470,"web_url":"http://patchwork.ozlabs.org/comment/3685470/","msgid":"","date":"2026-05-04T01:46:58","subject":"Re: [PATCH V4 2/2] tools/perf: Add kernel-doc comment to\n auxtrace_record__init() function","submitter":{"id":20789,"url":"http://patchwork.ozlabs.org/api/people/20789/","name":"Namhyung Kim","email":"namhyung@kernel.org"},"content":"Hello,\n\nOn Sat, May 02, 2026 at 08:02:37PM +0530, Athira Rajeev wrote:\n> Add documentation comment describing the parameters\n> and return code for auxtrace_record__init() in util/auxtrace.c\n> \n> Using \"struct evlist *evlist __maybe_unused\", gives below\n> warning with \"scripts/kernel-doc\".\n> \n> # ./scripts/kernel-doc -none tools/perf/util/auxtrace.c\n> Warning: tools/perf/util/auxtrace.c:912 function parameter '__maybe_unused' not described in 'auxtrace_record__init'\n> Warning: tools/perf/util/auxtrace.c:912 function parameter '__maybe_unused' not described in 'auxtrace_record__init'\n> \n> Updated parameter as \"struct evlist __maybe_unused *evlist\"\n> With the change, there is no erros/warnings with kernel-doc\n\nHmm.. this is not what we used to have. I'm not sure if we want to\nupdate them all. Maybe better to leave it for now.\n\n> \n> Signed-off-by: Athira Rajeev \n> ---\n> Changelog:\n> v3 -> v4:\n> Addressed review comment from Sashiko:\n> Update return value expectation for fail as\n> non zero return err code.\n> \n> v2 -> v3:\n> Addressed review comment from Sashiko:\n> Update return value expectation for success and fail\n> correctly.\n> \n> tools/perf/util/auxtrace.c | 17 ++++++++++++++++-\n> 1 file changed, 16 insertions(+), 1 deletion(-)\n> \n> diff --git a/tools/perf/util/auxtrace.c b/tools/perf/util/auxtrace.c\n> index a224687ffbc1..9e11cf4299b8 100644\n> --- a/tools/perf/util/auxtrace.c\n> +++ b/tools/perf/util/auxtrace.c\n> @@ -896,8 +896,23 @@ int auxtrace_parse_aux_action(struct evlist *evlist)\n> \treturn 0;\n> }\n> \n> +/**\n> + * auxtrace_record__init - Initialize an AUX area tracing record.\n> + * @evlist: The list of events to check for AUX area tracing event.\n> + * @err: Pointer to an integer to store return code.\n> + *\n> + * This function looks through the @evlist to determine which AUX area\n> + * tracing hardware is being used and initializes the auxtrace_record\n> + * structure.\n> + *\n> + * Return:\n> + * a) A pointer to the struct auxtrace_record on success.\n\nI think you should mention that the this function should set *err to\nzero on success.\n\nThanks,\nNamhyung\n\n\n> + * b) NULL with @err = 0 if no AUX area tracing event is found/supported\n> + * (not considered an error).\n> + * c) NULL with non-zero @err on actual auxtrace_record__init failure.\n> + */\n> struct auxtrace_record *__weak\n> -auxtrace_record__init(struct evlist *evlist __maybe_unused, int *err)\n> +auxtrace_record__init(struct evlist __maybe_unused *evlist, int *err)\n> {\n> \t*err = 0;\n> \treturn NULL;\n> -- \n> 2.47.3\n>","headers":{"Return-Path":"\n ","X-Original-To":["incoming@patchwork.ozlabs.org","linuxppc-dev@lists.ozlabs.org"],"Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256\n header.s=k20201202 header.b=SYPcucvu;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.ozlabs.org\n (client-ip=2404:9400:21b9:f100::1; helo=lists.ozlabs.org;\n envelope-from=linuxppc-dev+bounces-20392-incoming=patchwork.ozlabs.org@lists.ozlabs.org;\n receiver=patchwork.ozlabs.org)","lists.ozlabs.org;\n arc=none smtp.remote-ip=172.234.252.31","lists.ozlabs.org;\n dmarc=pass (p=quarantine dis=none) header.from=kernel.org","lists.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256\n header.s=k20201202 header.b=SYPcucvu;\n\tdkim-atps=neutral","lists.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=kernel.org\n (client-ip=172.234.252.31; helo=sea.source.kernel.org;\n envelope-from=namhyung@kernel.org; receiver=lists.ozlabs.org)"],"Received":["from lists.ozlabs.org (lists.ozlabs.org\n [IPv6:2404:9400:21b9:f100::1])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1 raw public key)\n server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g84JZ3X6Zz1yJ9\n\tfor ; Mon, 04 May 2026 11:47:10 +1000 (AEST)","from boromir.ozlabs.org (localhost [127.0.0.1])\n\tby lists.ozlabs.org (Postfix) with ESMTP id 4g84JS3tMXz2xpn;\n\tMon, 04 May 2026 11:47:04 +1000 (AEST)","from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n\t(No client certificate requested)\n\tby lists.ozlabs.org (Postfix) with ESMTPS id 4g84JR42yJz2xS3\n\tfor ; Mon, 04 May 2026 11:47:03 +1000 (AEST)","from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58])\n\tby sea.source.kernel.org (Postfix) with ESMTP id 3595F416E2;\n\tMon, 4 May 2026 01:47:00 +0000 (UTC)","by smtp.kernel.org (Postfix) with ESMTPSA id 8B05CC2BCB4;\n\tMon, 4 May 2026 01:46:59 +0000 (UTC)"],"ARC-Seal":"i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1777859224;\n\tcv=none;\n b=A17k0fDIht+9VVpCoksrIVdrLsqZnyMq12Zlxe0bAOPBxR9PQ/4D99JDoY21HnyE8+2Y23mSBma5rsDFrS5vlmRTAW6KOLQbHpEdmAjDkkOJGHkim5QfyOwsFEi1w3fpUgTa5Nb2cCEpYTsIq4gsn9NElf/V+OKwzw9fygbjZpW7nvoknTgnTLhJfuD/qk1nhBAAuWdKjwNKbzdfdaHWble4Iz9XiRbjkFuCJJYIy/v8blyH/HjAjfit3W/S1kR69aYkqEOILQcMLXv4pfxx+C3NItx81eOJExNhXeTQRxaiQdeewUgUkA2047bjg9r+Mg6LQsLGjkz4gB5oe7tuow==","ARC-Message-Signature":"i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707;\n\tt=1777859224; c=relaxed/relaxed;\n\tbh=l83JPblI2xpPWiUuHLQn3dqCdXQh0232jGQ5cbj49RY=;\n\th=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version:\n\t Content-Type:Content-Disposition:In-Reply-To;\n b=WDAktv1Nshfusq/GTMQjJk4TnQdZ2EvEinpRdv1vxzaCcMdtLvstB8leTqsmoKMqqoXem9zIHEa2nq5tULr34UrHcJBh+AygFR3GINXfhoemCa3DbzGEkdyhz3tYQ5vt8Y/wkUXtkrD4QV1ZP4kHIiXhlthAbWPuIutzDTsXUZDeVkZ4kBEj+lmOYD7eNdoKQZQyCc4IoAQ3f2k3H3W/PFod627fuorelxi+NuC1gg5HLmwD7JG41CGMaQil1eObLiT/MizGwCcEBbTAq5/MrL0EadHSbVAD6pHMrc6INDgt2zlrqwUFxfs//fIXaT1U2e/uGjer85zndBFIzFCZJg==","ARC-Authentication-Results":"i=1; lists.ozlabs.org;\n dmarc=pass (p=quarantine dis=none) header.from=kernel.org;\n dkim=pass (2048-bit key;\n unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256\n header.s=k20201202 header.b=SYPcucvu; dkim-atps=neutral;\n spf=pass (client-ip=172.234.252.31; helo=sea.source.kernel.org;\n envelope-from=namhyung@kernel.org;\n receiver=lists.ozlabs.org) smtp.mailfrom=kernel.org","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org;\n\ts=k20201202; t=1777859220;\n\tbh=LISybazuiphZ0cqm05s0nNTtnkzBdC2nqyKFogowcyY=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=SYPcucvusnuc5wQGdLTQTBCtz/zPPDAYs9L3s+CHsjn7nA1YcwOHCiAUQjOgAiKhJ\n\t l9JWNGAuvTt24GtAITaCHwn/myE1iJ8aSTrhqTHzAHSgwpKUHrUCqnu+npxPkkMQro\n\t +d74GEqqWekX8HX0JkJ+Cg2C4EerRXpl0fbU2wV52s8sCBPgJCCu0Ess9dMFf70E0Z\n\t TwIZLUIVCcPKIuojOLWVxh/r6yWFl7Y/yP0lTpvY3CVapgHeM0o5bDJcikuV6R2nzG\n\t E777Wa5G11D1NXJSElD3CLKZr022Ia8w2QOszCpa/Bj9YD8k+WHukTnGORy/Bfc6pt\n\t aA0naU+aW7Q+A==","Date":"Sun, 3 May 2026 18:46:58 -0700","From":"Namhyung Kim ","To":"Athira Rajeev ","Cc":"acme@kernel.org, jolsa@kernel.org, adrian.hunter@intel.com,\n\tmpetlan@redhat.com, tmricht@linux.ibm.com, maddy@linux.ibm.com,\n\tirogers@google.com, linux-perf-users@vger.kernel.org,\n\tlinuxppc-dev@lists.ozlabs.org, hbathini@linux.vnet.ibm.com,\n\tTejas.Manhas1@ibm.com, Tanushree.Shah@ibm.com,\n\tshivani@linux.ibm.com","Subject":"Re: [PATCH V4 2/2] tools/perf: Add kernel-doc comment to\n auxtrace_record__init() function","Message-ID":"","References":"<20260502143237.23456-1-atrajeev@linux.ibm.com>\n <20260502143237.23456-2-atrajeev@linux.ibm.com>","X-Mailing-List":"linuxppc-dev@lists.ozlabs.org","List-Id":"","List-Help":"","List-Owner":"","List-Post":"","List-Archive":",\n ","List-Subscribe":",\n ,\n ","List-Unsubscribe":"","Precedence":"list","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<20260502143237.23456-2-atrajeev@linux.ibm.com>","X-Spam-Status":"No, score=-0.6 required=3.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED,\n\tDKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS\n\tautolearn=disabled version=4.0.1 OzLabs 8","X-Spam-Checker-Version":"SpamAssassin 4.0.1 (2024-03-25) on lists.ozlabs.org"}},{"id":3685488,"web_url":"http://patchwork.ozlabs.org/comment/3685488/","msgid":"<8D38B0F5-0E9C-425D-87E5-5885B18981BD@linux.ibm.com>","date":"2026-05-04T04:16:38","subject":"Re: [PATCH V4 2/2] tools/perf: Add kernel-doc comment to\n auxtrace_record__init() function","submitter":{"id":90290,"url":"http://patchwork.ozlabs.org/api/people/90290/","name":"Athira Rajeev","email":"atrajeev@linux.ibm.com"},"content":"> On 4 May 2026, at 7:16 AM, Namhyung Kim wrote:\n> \n> Hello,\n> \n> On Sat, May 02, 2026 at 08:02:37PM +0530, Athira Rajeev wrote:\n>> Add documentation comment describing the parameters\n>> and return code for auxtrace_record__init() in util/auxtrace.c\n>> \n>> Using \"struct evlist *evlist __maybe_unused\", gives below\n>> warning with \"scripts/kernel-doc\".\n>> \n>> # ./scripts/kernel-doc -none tools/perf/util/auxtrace.c\n>> Warning: tools/perf/util/auxtrace.c:912 function parameter '__maybe_unused' not described in 'auxtrace_record__init'\n>> Warning: tools/perf/util/auxtrace.c:912 function parameter '__maybe_unused' not described in 'auxtrace_record__init'\n>> \n>> Updated parameter as \"struct evlist __maybe_unused *evlist\"\n>> With the change, there is no erros/warnings with kernel-doc\n> \n> Hmm.. this is not what we used to have. I'm not sure if we want to\n> update them all. Maybe better to leave it for now.\n\nSure, I will keep it as original version.\n\n> \n>> \n>> Signed-off-by: Athira Rajeev \n>> ---\n>> Changelog:\n>> v3 -> v4:\n>> Addressed review comment from Sashiko:\n>> Update return value expectation for fail as\n>> non zero return err code.\n>> \n>> v2 -> v3:\n>> Addressed review comment from Sashiko:\n>> Update return value expectation for success and fail\n>> correctly.\n>> \n>> tools/perf/util/auxtrace.c | 17 ++++++++++++++++-\n>> 1 file changed, 16 insertions(+), 1 deletion(-)\n>> \n>> diff --git a/tools/perf/util/auxtrace.c b/tools/perf/util/auxtrace.c\n>> index a224687ffbc1..9e11cf4299b8 100644\n>> --- a/tools/perf/util/auxtrace.c\n>> +++ b/tools/perf/util/auxtrace.c\n>> @@ -896,8 +896,23 @@ int auxtrace_parse_aux_action(struct evlist *evlist)\n>> return 0;\n>> }\n>> \n>> +/**\n>> + * auxtrace_record__init - Initialize an AUX area tracing record.\n>> + * @evlist: The list of events to check for AUX area tracing event.\n>> + * @err: Pointer to an integer to store return code.\n>> + *\n>> + * This function looks through the @evlist to determine which AUX area\n>> + * tracing hardware is being used and initializes the auxtrace_record\n>> + * structure.\n>> + *\n>> + * Return:\n>> + * a) A pointer to the struct auxtrace_record on success.\n> \n> I think you should mention that the this function should set *err to\n> zero on success.\nSure, I will update this \n\nThanks\nAthira\n> \n> Thanks,\n> Namhyung\n> \n> \n>> + * b) NULL with @err = 0 if no AUX area tracing event is found/supported\n>> + * (not considered an error).\n>> + * c) NULL with non-zero @err on actual auxtrace_record__init failure.\n>> + */\n>> struct auxtrace_record *__weak\n>> -auxtrace_record__init(struct evlist *evlist __maybe_unused, int *err)\n>> +auxtrace_record__init(struct evlist __maybe_unused *evlist, int *err)\n>> {\n>> *err = 0;\n>> return NULL;\n>> -- \n>> 2.47.3","headers":{"Return-Path":"\n ","X-Original-To":["incoming@patchwork.ozlabs.org","linuxppc-dev@lists.ozlabs.org"],"Delivered-To":"patchwork-incoming@legolas.ozlabs.org","Authentication-Results":["legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=ibm.com header.i=@ibm.com header.a=rsa-sha256\n header.s=pp1 header.b=Pe8p2gG1;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.ozlabs.org\n (client-ip=2404:9400:21b9:f100::1; helo=lists.ozlabs.org;\n envelope-from=linuxppc-dev+bounces-20395-incoming=patchwork.ozlabs.org@lists.ozlabs.org;\n receiver=patchwork.ozlabs.org)","lists.ozlabs.org;\n arc=none smtp.remote-ip=148.163.156.1","lists.ozlabs.org;\n dmarc=pass (p=none dis=none) header.from=linux.ibm.com","lists.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=ibm.com header.i=@ibm.com header.a=rsa-sha256\n header.s=pp1 header.b=Pe8p2gG1;\n\tdkim-atps=neutral","lists.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=linux.ibm.com\n (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com;\n envelope-from=atrajeev@linux.ibm.com; receiver=lists.ozlabs.org)"],"Received":["from lists.ozlabs.org (lists.ozlabs.org\n [IPv6:2404:9400:21b9:f100::1])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g87dZ6cWtz1yJ9\n\tfor ; Mon, 04 May 2026 14:17:06 +1000 (AEST)","from boromir.ozlabs.org (localhost [127.0.0.1])\n\tby lists.ozlabs.org (Postfix) with ESMTP id 4g87dZ5Ms7z2ygf;\n\tMon, 04 May 2026 14:17:06 +1000 (AEST)","from mx0a-001b2d01.pphosted.com (mx0a-001b2d01.pphosted.com\n [148.163.156.1])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n\t(No client certificate requested)\n\tby lists.ozlabs.org (Postfix) with ESMTPS id 4g87dY54XBz2xZK\n\tfor ; Mon, 04 May 2026 14:17:05 +1000 (AEST)","from pps.filterd (m0360083.ppops.net [127.0.0.1])\n\tby mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id\n 6433TV40855288;\n\tMon, 4 May 2026 04:17:01 GMT","from ppma23.wdc07v.mail.ibm.com\n (5d.69.3da9.ip4.static.sl-reverse.com [169.61.105.93])\n\tby mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4dw9v75eyk-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tMon, 04 May 2026 04:17:00 +0000 (GMT)","from pps.filterd (ppma23.wdc07v.mail.ibm.com [127.0.0.1])\n\tby ppma23.wdc07v.mail.ibm.com (8.18.1.7/8.18.1.7) with ESMTP id\n 6443uY7H014222;\n\tMon, 4 May 2026 04:16:59 GMT","from smtprelay07.fra02v.mail.ibm.com ([9.218.2.229])\n\tby ppma23.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4dww3guj14-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tMon, 04 May 2026 04:16:59 +0000 (GMT)","from smtpav02.fra02v.mail.ibm.com (smtpav02.fra02v.mail.ibm.com\n [10.20.54.101])\n\tby smtprelay07.fra02v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id\n 6444GtvD48103688\n\t(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);\n\tMon, 4 May 2026 04:16:56 GMT","from smtpav02.fra02v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id CEB6820043;\n\tMon, 4 May 2026 04:16:55 +0000 (GMT)","from smtpav02.fra02v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id B233620040;\n\tMon, 4 May 2026 04:16:51 +0000 (GMT)","from smtpclient.apple (unknown [9.39.20.162])\n\tby smtpav02.fra02v.mail.ibm.com (Postfix) with ESMTPS;\n\tMon, 4 May 2026 04:16:51 +0000 (GMT)"],"ARC-Seal":"i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1777868226;\n\tcv=none;\n b=P7iYvudJj8zMy8Ir3c9YbH4WAoJSkDE2XYkBORkvVjME7Mm2p7o1oQeqycJLDSWP9mUzPkB7KCGUqGhHagQIBLzOj/GEAAidOz9L+OkfUxWHfvDuO4jkeranGw9/YvWZ5jNU0icNUJIrB7CBQWEvy4gSG5bsYG+mvShjHOgYwp4uIkDSQJcM6nxUK8A9QuBdyuJNgk2tw/a8IT8Ge0nJ5seq8pwCsgWdlJcTLgfQjXAz2uWFBNvFJVSjz0tK5ziqfXoG891ToTIPmcPcxToHNA25OGex5yN8gmoc8d53FcGha+SJ4tvwgBCbOvjPEPe7loFJhjd0RnqwXM+3vUiO+w==","ARC-Message-Signature":"i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707;\n\tt=1777868226; c=relaxed/relaxed;\n\tbh=+LuKhD3yYhMAI47caqKiKblQEr4RtiQBIb2L/CFhkNg=;\n\th=Content-Type:Mime-Version:Subject:From:In-Reply-To:Date:Cc:\n\t Message-Id:References:To;\n b=hd9bF9aRQbYv28otPY7BtWz4KqgUUH9HfmqhiQ6lU7nPSNu2ACvZWtsdk4PtrjPEvAnRCro8FwFCmdglyix83tmOd8F1hd15J6YP7YEa5CVNziAtOYXgE0FniyWa6LwFVaKUI3qSd2rc4PXbmRrxbyOBgCdmd6fClVRgr0B171VSRIkljDSfFpbP6qRY1OQnPN/kM5DUfFcEs90qxSHet7FQL+vH1YKdhZ8zwmjtuZOPSDjzqD0Y/RjgOGE8A71soA+B96KYQO38ds/zAmIMUAxQEvgcx39h7S9k9EauPVUeu90LXnG3r/W1uzzdKM07BKcHX/drnP3R0noZTVNacw==","ARC-Authentication-Results":"i=1; lists.ozlabs.org;\n dmarc=pass (p=none dis=none) header.from=linux.ibm.com;\n dkim=pass (2048-bit key;\n unprotected) header.d=ibm.com header.i=@ibm.com header.a=rsa-sha256\n header.s=pp1 header.b=Pe8p2gG1; dkim-atps=neutral;\n spf=pass (client-ip=148.163.156.1; helo=mx0a-001b2d01.pphosted.com;\n envelope-from=atrajeev@linux.ibm.com;\n receiver=lists.ozlabs.org) smtp.mailfrom=linux.ibm.com","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=cc\n\t:content-transfer-encoding:content-type:date:from:in-reply-to\n\t:message-id:mime-version:references:subject:to; s=pp1; bh=+LuKhD\n\t3yYhMAI47caqKiKblQEr4RtiQBIb2L/CFhkNg=; b=Pe8p2gG104pWLvs1gLx7w4\n\tkcEMGCbopaEW/tgti3tdSsgGlb2xdxK7lsc2RIKCvMb8dd6Eo30omp6jfTvCcVmO\n\t3bYUg9Bq+iDpR+mBhzrAlU1M398rFMKjoAMrWcrPvnQ5YQ8MUBR9XQjlakGU9d0u\n\thFbHp64YrkOiX2RppaXzx6nPo08pJy/ZXT8vK01SNhmko8seegDlc6Inp5DUi3ZL\n\t73ObM5HbAuSo5+GJR5GUKSw3oF6q28nbbrDPsW7hEImvlhTf1tSutoGddRmMid6D\n\tIY2sz0Tr7rLgBj228YA37RKNFT8cY/dyvWICIAoqLzVqGIPu3xzqAwkXwHH2fbQg\n\t==","Content-Type":"text/plain;\n\tcharset=utf-8","X-Mailing-List":"linuxppc-dev@lists.ozlabs.org","List-Id":"","List-Help":"","List-Owner":"","List-Post":"","List-Archive":",\n ","List-Subscribe":",\n ,\n ","List-Unsubscribe":"","Precedence":"list","Mime-Version":"1.0 (Mac OS X Mail 16.0 \\(3864.300.41.1.7\\))","Subject":"Re: [PATCH V4 2/2] tools/perf: Add kernel-doc comment to\n auxtrace_record__init() function","From":"Athira Rajeev ","In-Reply-To":"","Date":"Mon, 4 May 2026 09:46:38 +0530","Cc":"acme@kernel.org, jolsa@kernel.org, adrian.hunter@intel.com,\n mpetlan@redhat.com, tmricht@linux.ibm.com, maddy@linux.ibm.com,\n irogers@google.com, linux-perf-users@vger.kernel.org,\n linuxppc-dev@lists.ozlabs.org, hbathini@linux.vnet.ibm.com,\n Tejas.Manhas1@ibm.com, Tanushree.Shah@ibm.com, shivani@linux.ibm.com","Content-Transfer-Encoding":"quoted-printable","Message-Id":"<8D38B0F5-0E9C-425D-87E5-5885B18981BD@linux.ibm.com>","References":"<20260502143237.23456-1-atrajeev@linux.ibm.com>\n <20260502143237.23456-2-atrajeev@linux.ibm.com> ","To":"Namhyung Kim ","X-Mailer":"Apple Mail (2.3864.300.41.1.7)","X-TM-AS-GCONF":"00","X-Proofpoint-Reinject":"loops=2 maxloops=12","X-Proofpoint-Spam-Details-Enc":"AW1haW4tMjYwNTA0MDA0MSBTYWx0ZWRfX1Y7d5lU5KmG6\n p6uNLbcFh61wktFgDM6cfrREK607Ennybqvn+vi/TR32syNBSXlr9n0nG3/3DfNDqJcExJ2WsG/\n pywaUcnWXrBJCVcruV19/q3GSXMCIIV4NaeZ3HWMF5GqPlptEIcY1LrR+2LfAZo+/7qt6eKyDMN\n s/m+5OKSB6f6MEEa7NJaLQ1GWfIG32plCXYo6bnXZ69KZfRRCZwTWR9SdMQxd3ot/BEPLRm1Ogn\n QC07bK02u1aMR2frPLyDeFawTdXJhbEMsJlcNAKI51Z3lgCOP6rPPItBmueQaKg8nby/4Prqoa0\n IVtGhVtBw+F5ZUzUmS/rx+F1GV6BG1pA2xm4VtykKDHHfog0cn9xMI3WAKCxF6SWos63AiPCWTf\n 1r8Kx8Z2PjvQ433J+CHiqxqWY7RTM0CJRVWQKTlB/zr2CZt/cGywcNSJmhr579eV33NbfSNCH1U\n k0Pr8J3XxQRlm+akPTw==","X-Proofpoint-GUID":"OdQOp-fq0pV5DJtyzHTedW-f52gjXFm_","X-Proofpoint-ORIG-GUID":"aYHtiTrpMX4Lid_9H5EWISRr1ZhLAsBy","X-Authority-Analysis":"v=2.4 cv=eu/vCIpX c=1 sm=1 tr=0 ts=69f81dbd cx=c_pps\n a=3Bg1Hr4SwmMryq2xdFQyZA==:117 a=3Bg1Hr4SwmMryq2xdFQyZA==:17\n a=IkcTkHD0fZMA:10 a=NGcC8JguVDcA:10 a=VkNPw1HP01LnGYTKEx00:22\n a=RnoormkPH1_aCDwRdu11:22 a=iQ6ETzBq9ecOQQE5vZCe:22 a=VwQbUJbxAAAA:8\n a=VnNF1IyMAAAA:8 a=WYBppRGt9Tx3A1cNM9MA:9 a=QEXdDO2ut3YA:10","X-Proofpoint-Virus-Version":"vendor=baseguard\n engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49\n definitions=2026-05-04_02,2026-04-30_02,2025-10-01_01","X-Proofpoint-Spam-Details":"rule=outbound_notspam policy=outbound score=0\n priorityscore=1501 phishscore=0 lowpriorityscore=0 clxscore=1015 adultscore=0\n suspectscore=0 malwarescore=0 bulkscore=0 impostorscore=0 spamscore=0\n classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0\n reason=mlx scancount=1 engine=8.22.0-2604200000 definitions=main-2605040041","X-Spam-Status":"No, score=-0.7 required=3.0 tests=DKIM_SIGNED,DKIM_VALID,\n\tRCVD_IN_DNSWL_LOW,RCVD_IN_MSPIKE_H4,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,\n\tSPF_PASS autolearn=disabled version=4.0.1 OzLabs 8","X-Spam-Checker-Version":"SpamAssassin 4.0.1 (2024-03-25) on lists.ozlabs.org"}}]