{"id":2232476,"url":"http://patchwork.ozlabs.org/api/1.1/patches/2232476/?format=json","web_url":"http://patchwork.ozlabs.org/project/linuxppc-dev/patch/20260504151321.12346-2-atrajeev@linux.ibm.com/","project":{"id":2,"url":"http://patchwork.ozlabs.org/api/1.1/projects/2/?format=json","name":"Linux PPC development","link_name":"linuxppc-dev","list_id":"linuxppc-dev.lists.ozlabs.org","list_email":"linuxppc-dev@lists.ozlabs.org","web_url":"https://github.com/linuxppc/wiki/wiki","scm_url":"https://git.kernel.org/pub/scm/linux/kernel/git/powerpc/linux.git","webscm_url":"https://git.kernel.org/pub/scm/linux/kernel/git/powerpc/linux.git/"},"msgid":"<20260504151321.12346-2-atrajeev@linux.ibm.com>","date":"2026-05-04T15:13:21","name":"[V5,2/2] tools/perf: Add kernel-doc comment to auxtrace_record__init() function","commit_ref":null,"pull_url":null,"state":"handled-elsewhere","archived":false,"hash":"ace320836cbab4cc4c3fadfd578a69920085dcf3","submitter":{"id":90290,"url":"http://patchwork.ozlabs.org/api/1.1/people/90290/?format=json","name":"Athira Rajeev","email":"atrajeev@linux.ibm.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/linuxppc-dev/patch/20260504151321.12346-2-atrajeev@linux.ibm.com/mbox/","series":[{"id":502679,"url":"http://patchwork.ozlabs.org/api/1.1/series/502679/?format=json","web_url":"http://patchwork.ozlabs.org/project/linuxppc-dev/list/?series=502679","date":"2026-05-04T15:13:20","name":"[V5,1/2] powerpc tools perf: Initialize error code in auxtrace_record_init function","version":5,"mbox":"http://patchwork.ozlabs.org/series/502679/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2232476/comments/","check":"success","checks":"http://patchwork.ozlabs.org/api/patches/2232476/checks/","tags":{},"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=NkGx5jZj;\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-20423-incoming=patchwork.ozlabs.org@lists.ozlabs.org;\n receiver=patchwork.ozlabs.org)","lists.ozlabs.org;\n arc=none smtp.remote-ip=148.163.158.5","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=NkGx5jZj;\n\tdkim-atps=neutral","lists.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=linux.ibm.com\n (client-ip=148.163.158.5; helo=mx0b-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 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 4g8QCM2H7Yz1yJV\n\tfor ; Tue, 05 May 2026 01:13:51 +1000 (AEST)","from boromir.ozlabs.org (localhost [127.0.0.1])\n\tby lists.ozlabs.org (Postfix) with ESMTP id 4g8QCJ5pTKz30Gf;\n\tTue, 05 May 2026 01:13:48 +1000 (AEST)","from mx0b-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com\n [148.163.158.5])\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 4g8QCH6Rhvz2xfB\n\tfor ; Tue, 05 May 2026 01:13:47 +1000 (AEST)","from pps.filterd (m0356516.ppops.net [127.0.0.1])\n\tby mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id\n 644EgnAZ3104130;\n\tMon, 4 May 2026 15:13:41 GMT","from ppma22.wdc07v.mail.ibm.com\n (5c.69.3da9.ip4.static.sl-reverse.com [169.61.105.92])\n\tby mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4dw9w67f2r-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tMon, 04 May 2026 15:13:40 +0000 (GMT)","from pps.filterd (ppma22.wdc07v.mail.ibm.com [127.0.0.1])\n\tby ppma22.wdc07v.mail.ibm.com (8.18.1.7/8.18.1.7) with ESMTP id\n 644EsTXA008937;\n\tMon, 4 May 2026 15:13:40 GMT","from smtprelay01.fra02v.mail.ibm.com ([9.218.2.227])\n\tby ppma22.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4dwuyvws9d-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tMon, 04 May 2026 15:13:40 +0000 (GMT)","from smtpav06.fra02v.mail.ibm.com (smtpav06.fra02v.mail.ibm.com\n [10.20.54.105])\n\tby smtprelay01.fra02v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id\n 644FDaLp61866326\n\t(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);\n\tMon, 4 May 2026 15:13:36 GMT","from smtpav06.fra02v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id 4C4BF2004E;\n\tMon, 4 May 2026 15:13:36 +0000 (GMT)","from smtpav06.fra02v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id 7F94220049;\n\tMon, 4 May 2026 15:13:31 +0000 (GMT)","from localhost.localdomain (unknown [9.124.208.70])\n\tby smtpav06.fra02v.mail.ibm.com (Postfix) with ESMTP;\n\tMon, 4 May 2026 15:13:31 +0000 (GMT)"],"ARC-Seal":"i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1777907628;\n\tcv=none;\n b=B8sxDy6tP5YdtHLg1aZ4vNKpE/SCrXfnznh3iT0en9q0BCWYBlpE/azP1fKAi3l7npBCXETUDKu7eLshUik87iohCs549bJpv5L74rJNaD7OMSTH+F9lP5w8IfwJfCty0TpYDOUZCxf5nQ4eugL2j97Q1KUak4mWFkTlA8mKoUOawrHRKAVxrWn12aU21kb+Vjt9zsT9KoK5T96430QwM55mqtuA5s16UL4EI6+cDXJquIPt2xK8hsp+lw91B5S/l5T0F/mu8718zvrgUhMIbw068KmTqxynIQPcFWn1CUVG9cPD8m3g3Ko6vgmTb7wZovA3XQAY/z+70qhMAEwApQ==","ARC-Message-Signature":"i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707;\n\tt=1777907628; c=relaxed/relaxed;\n\tbh=ydgkvSL5z+MYv6RNhr7y2GSysjQVXtkJqmjVLG7BJOo=;\n\th=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References:\n\t MIME-Version;\n b=SmWORn/lTSfR8XoflbzxdCIm4INyVALF6Zfo3vd6TqhR+SmgEg46eYd53xlu66GXcEUT6S4Vw5PnawEENN2PRgUnJz+o3MsXXawRgnpLjSisPMiBc4hTvj3TaQVcTi9FvcrXxiDJ3MqSuuw+OlbMQk/JahvjNSmrYUniHfXDWlIr400GjndIz17MVcqlOScUBsQd7NZNogUm9HK72p9I6ejM+HbSC3z3xXtbtjua8BeurFaNn9s7q3JSEW/n6ZGZL9RmWMNnkqFNa6gZGrImWZRMpV0SP0kQmdYDqdJAZ9dE59CNvAAsM3PIWR5qO0xGDroD+5N7vk1fzWY8+nh+Sg==","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=NkGx5jZj; dkim-atps=neutral;\n spf=pass (client-ip=148.163.158.5; helo=mx0b-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:date:from:in-reply-to:message-id\n\t:mime-version:references:subject:to; s=pp1; bh=ydgkvSL5z+MYv6RNh\n\tr7y2GSysjQVXtkJqmjVLG7BJOo=; b=NkGx5jZjjSPyUl4iKVIKNPtzbiuPEb7Mn\n\t+ueUr8XmmnxBQ+1hU4yD4ji+fW53a/G4dfld0ZvdNIFmlf0BU0zOXL3e3JP5ijGv\n\tt4zsD7ZItzzq17VC76/u+vK4Wvc7JB+Al+r74aM1syABH8VcFWl2QqgQYE6fVV/Y\n\tAD0u3XNSALSgC7abnscKw8c6DpfMcLgnglXsyic6R8Jmgnya6LpMW2LRG0EthWIw\n\tszkLePAb2FgKgpxWTehFP9gI+wTBAJlmYOPxxJ5AT3j6CfzRBiHbkldOxB3aBzDx\n\tqFOw/0AtLnNme7WjvGxkbcPISZADkYTXgRMzrz2n7/X7+hHHLHisw==","From":"Athira Rajeev ","To":"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, namhyung@kernel.org","Cc":"linux-perf-users@vger.kernel.org, linuxppc-dev@lists.ozlabs.org,\n atrajeev@linux.ibm.com, hbathini@linux.vnet.ibm.com,\n Tejas.Manhas1@ibm.com, Tanushree.Shah@ibm.com, shivani@linux.ibm.com","Subject":"[PATCH V5 2/2] tools/perf: Add kernel-doc comment to\n auxtrace_record__init() function","Date":"Mon, 4 May 2026 20:43:21 +0530","Message-Id":"<20260504151321.12346-2-atrajeev@linux.ibm.com>","X-Mailer":"git-send-email 2.39.5 (Apple Git-154)","In-Reply-To":"<20260504151321.12346-1-atrajeev@linux.ibm.com>","References":"<20260504151321.12346-1-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-Transfer-Encoding":"8bit","X-TM-AS-GCONF":"00","X-Proofpoint-Reinject":"loops=2 maxloops=12","X-Authority-Analysis":"v=2.4 cv=XPQAjwhE c=1 sm=1 tr=0 ts=69f8b7a5 cx=c_pps\n a=5BHTudwdYE3Te8bg5FgnPg==:117 a=5BHTudwdYE3Te8bg5FgnPg==:17\n a=NGcC8JguVDcA:10 a=VkNPw1HP01LnGYTKEx00:22 a=RnoormkPH1_aCDwRdu11:22\n a=Y2IxJ9c9Rs8Kov3niI8_:22 a=VnNF1IyMAAAA:8 a=rIN8eMsy0-pcsuMf_RkA:9","X-Proofpoint-ORIG-GUID":"SSjChCb329VBE86ySS1fYvSvtBT_FHn5","X-Proofpoint-GUID":"b4nYdZbbxEfrWQBz3b_8rVLRxXHhVSkJ","X-Proofpoint-Spam-Details-Enc":"AW1haW4tMjYwNTA0MDE1MiBTYWx0ZWRfX5GR+DpXxmVJJ\n lVNMg7ipRCOLUVGyiEuu+bVCXFVZ06LGVnWs+SbJGP/cjqQxIYrNlW+n0JcvSHRN/4+MjiM2HAg\n E62VJcGL0OE0rScBTCj8c4ko4Th0dp8gSA63sY0TdIakS77dynS4bAlYFVTHZulCVuWcXCGUecs\n 7sEoaUOTlNnDbQnitgQyY+uAreTr6ZCzVNBXksaQhsL3Jel+dGICyQ1oN6FCxjYX+2NRtCgQw8a\n UQe/XUv+SJ1DpXMfCcQ/e4IcLDihJ8xQ7ew1MG9wKLXZiIFDqzU3xL7B+r9i0Q8CE4yt8o7vv56\n 6AIUFlU5HWyi+1R7+QFmoMQWTJp4DPAroojvUdBWesu/+liv+2dfmEHfSeo5v0G+3K/YOdX8DJ9\n s3JPEH60LeoffT74GoF3kcbq0KInBTSlS0Wb0TPhJFohPeKknXwwVHYzvevMnI14U1DXIhcnv4L\n j3P1VUIehnNMKJyNacA==","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_05,2026-04-30_02,2025-10-01_01","X-Proofpoint-Spam-Details":"rule=outbound_notspam policy=outbound score=0\n bulkscore=0 lowpriorityscore=0 suspectscore=0 adultscore=0 spamscore=0\n priorityscore=1501 impostorscore=0 phishscore=0 malwarescore=0 clxscore=1015\n classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0\n reason=mlx scancount=1 engine=8.22.0-2604200000 definitions=main-2605040152","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"},"content":"Add documentation comment describing the parameters\nand return code for auxtrace_record__init() in util/auxtrace.c\n\nSigned-off-by: Athira Rajeev \n---\nChangelog:\nv4 > v5:\nAddressed review comment from Namhyung:\n- Used original placement for __maybe_unused as\n\"struct evlist *evlist __maybe_unused\"\n- Added return code expectation on success case\n\nv3 -> v4:\nAddressed review comment from Sashiko:\nUpdate return value expectation for fail as\nnon zero return err code.\n\nv2 -> v3:\nAddressed review comment from Sashiko:\nUpdate return value expectation for success and fail\ncorrectly.\n\n tools/perf/util/auxtrace.c | 15 +++++++++++++++\n 1 file changed, 15 insertions(+)","diff":"diff --git a/tools/perf/util/auxtrace.c b/tools/perf/util/auxtrace.c\nindex a224687ffbc1..a9f007d47c0b 100644\n--- a/tools/perf/util/auxtrace.c\n+++ b/tools/perf/util/auxtrace.c\n@@ -896,6 +896,21 @@ 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 with @err = 0 on success.\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 {\n","prefixes":["V5","2/2"]}