get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/2232085/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 2232085,
    "url": "http://patchwork.ozlabs.org/api/patches/2232085/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/linuxppc-dev/patch/20260502143237.23456-2-atrajeev@linux.ibm.com/",
    "project": {
        "id": 2,
        "url": "http://patchwork.ozlabs.org/api/projects/2/?format=api",
        "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/",
        "list_archive_url": "https://lore.kernel.org/linuxppc-dev/",
        "list_archive_url_format": "https://lore.kernel.org/linuxppc-dev/{}/",
        "commit_url_format": "https://git.kernel.org/pub/scm/linux/kernel/git/powerpc/linux.git/commit/?id={}"
    },
    "msgid": "<20260502143237.23456-2-atrajeev@linux.ibm.com>",
    "list_archive_url": "https://lore.kernel.org/linuxppc-dev/20260502143237.23456-2-atrajeev@linux.ibm.com/",
    "date": "2026-05-02T14:32:37",
    "name": "[V4,2/2] tools/perf: Add kernel-doc comment to auxtrace_record__init() function",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "5c4964e4aea60cd6f06e9307f42db0e2e5bfd1c9",
    "submitter": {
        "id": 90290,
        "url": "http://patchwork.ozlabs.org/api/people/90290/?format=api",
        "name": "Athira Rajeev",
        "email": "atrajeev@linux.ibm.com"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/linuxppc-dev/patch/20260502143237.23456-2-atrajeev@linux.ibm.com/mbox/",
    "series": [
        {
            "id": 502532,
            "url": "http://patchwork.ozlabs.org/api/series/502532/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/linuxppc-dev/list/?series=502532",
            "date": "2026-05-02T14:32:36",
            "name": "[V4,1/2] powerpc tools perf: Initialize error code in auxtrace_record_init function",
            "version": 4,
            "mbox": "http://patchwork.ozlabs.org/series/502532/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/2232085/comments/",
    "check": "success",
    "checks": "http://patchwork.ozlabs.org/api/patches/2232085/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "\n <linuxppc-dev+bounces-20383-incoming=patchwork.ozlabs.org@lists.ozlabs.org>",
        "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=sj0RxkX5;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.ozlabs.org\n (client-ip=112.213.38.117; helo=lists.ozlabs.org;\n envelope-from=linuxppc-dev+bounces-20383-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=sj0RxkX5;\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 [112.213.38.117])\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 4g79PD721Fz1y04\n\tfor <incoming@patchwork.ozlabs.org>; Sun, 03 May 2026 00:33:04 +1000 (AEST)",
            "from boromir.ozlabs.org (localhost [127.0.0.1])\n\tby lists.ozlabs.org (Postfix) with ESMTP id 4g79PB28SHz30Jy;\n\tSun, 03 May 2026 00:33:02 +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 4g79P91xl9z2xnh\n\tfor <linuxppc-dev@lists.ozlabs.org>; Sun, 03 May 2026 00:33:00 +1000 (AEST)",
            "from pps.filterd (m0356517.ppops.net [127.0.0.1])\n\tby mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id\n 64247b4U1939539;\n\tSat, 2 May 2026 14:32:56 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 4dw9y116us-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tSat, 02 May 2026 14:32:55 +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 642EOm0V015317;\n\tSat, 2 May 2026 14:32:54 GMT",
            "from smtprelay04.fra02v.mail.ibm.com ([9.218.2.228])\n\tby ppma23.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4dw9jdhd7j-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n\tSat, 02 May 2026 14:32:54 +0000 (GMT)",
            "from smtpav02.fra02v.mail.ibm.com (smtpav02.fra02v.mail.ibm.com\n [10.20.54.101])\n\tby smtprelay04.fra02v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id\n 642EWo7q29033004\n\t(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);\n\tSat, 2 May 2026 14:32:51 GMT",
            "from smtpav02.fra02v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id DB1BF20043;\n\tSat,  2 May 2026 14:32:50 +0000 (GMT)",
            "from smtpav02.fra02v.mail.ibm.com (unknown [127.0.0.1])\n\tby IMSVA (Postfix) with ESMTP id A490420040;\n\tSat,  2 May 2026 14:32:45 +0000 (GMT)",
            "from localhost.localdomain (unknown [9.124.223.37])\n\tby smtpav02.fra02v.mail.ibm.com (Postfix) with ESMTP;\n\tSat,  2 May 2026 14:32:45 +0000 (GMT)"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1777732382;\n\tcv=none;\n b=j0upkzhpZ1ASL3LYof6qedORBjNHUFEZjNfePTuthJSkbm6K/fNswhyljhkCmk9zhV6VI8l3ziZUNMfJ6SddnXwgY68lQkRXAV6iStXDfkGtoPgTL3up9zU9cIoiZuoej1r2nwXtb0xXdPqhsIvog1sV9rHBAmo2UijUVEBH425hWo3hMEfuw8ZWocF2EIQIweNJqezOLq/qMZpdjIGBeRIMt71x6BggTZq8p4rb0vvqyH3AzdDA2zptehqauxTbDU/ATUlo+TLZbFbh2GQ6jKMq3KzAhVYgfD6M0AOYNuHtjPs7bMAzTCE8V6cpeCPKlTTEfX5hNHuqtXZi1xI4eA==",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707;\n\tt=1777732382; c=relaxed/relaxed;\n\tbh=eqJA8MRmkd2Q9TvN4XIxdpFWNzKxVhQNWHzHl9wQxxM=;\n\th=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References:\n\t MIME-Version;\n b=I5UG3lXGemVxYs+sk8OEJBRFVFHwpUrR/ImnQQBx4SKoRQokFxjel3m1WOWbiygbwiVZq6jRvtg0GV2LaPJgJ3RKz2qOQiuP8nqGpadnXyIS6GJtJ7YLtpMvivDuGpqaCtQwpyVzITG5uRYe4w03JNlcHYsWyN7V6gu1HTaE83A2CLt/M+5c8yTLY+rxUl4s7eYCOJXd0l32VyBzWLP9KdW3lfIltdR5MhM3x6qicXKn337pUKoZdHU61J1r4cEsa/JBUpvW8M/1zVRqbpNIqASWQXls9aPRMmObofuJB8s8J8MsXY/Pd798Wr+NHo9zppJpQGnNjYAG+WeawLYqwg==",
        "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=sj0RxkX5; 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:date:from:in-reply-to:message-id\n\t:mime-version:references:subject:to; s=pp1; bh=eqJA8MRmkd2Q9TvN4\n\tXIxdpFWNzKxVhQNWHzHl9wQxxM=; b=sj0RxkX5lP/vMYclN0Q3AFzRR3hX09nSe\n\ttHniGXyZC0FhwL9MvsQ45IH/ZSGFB86h4XfJR+OTdLpdpkPj/vAPKCebwHeyYRiK\n\tUsETPCm5rX05glhchIQlZXiDDU2gWecU2RS7jAyrvYjeMA2dcSIZ36DAcmWMnTPV\n\t1IRz48AqZE72lGh+znA8wRaAakvtB69leWV204D/RP8QSBbjGpu2TCQhrkbLXYgP\n\tC4W73eoSpjZUbvOqyw0diomXPUmE1hp1JuzgaaxXLizReYV+HfD2F0H+fMe9aRZZ\n\tKh9sTbZeh31qn3W22w7ml7JfGPgsbSs06oLqxSaaD1RYcTtEjSnwQ==",
        "From": "Athira Rajeev <atrajeev@linux.ibm.com>",
        "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 V4 2/2] tools/perf: Add kernel-doc comment to\n auxtrace_record__init() function",
        "Date": "Sat,  2 May 2026 20:02:37 +0530",
        "Message-Id": "<20260502143237.23456-2-atrajeev@linux.ibm.com>",
        "X-Mailer": "git-send-email 2.39.5 (Apple Git-154)",
        "In-Reply-To": "<20260502143237.23456-1-atrajeev@linux.ibm.com>",
        "References": "<20260502143237.23456-1-atrajeev@linux.ibm.com>",
        "X-Mailing-List": "linuxppc-dev@lists.ozlabs.org",
        "List-Id": "<linuxppc-dev.lists.ozlabs.org>",
        "List-Help": "<mailto:linuxppc-dev+help@lists.ozlabs.org>",
        "List-Owner": "<mailto:linuxppc-dev+owner@lists.ozlabs.org>",
        "List-Post": "<mailto:linuxppc-dev@lists.ozlabs.org>",
        "List-Archive": "<https://lore.kernel.org/linuxppc-dev/>,\n  <https://lists.ozlabs.org/pipermail/linuxppc-dev/>",
        "List-Subscribe": "<mailto:linuxppc-dev+subscribe@lists.ozlabs.org>,\n  <mailto:linuxppc-dev+subscribe-digest@lists.ozlabs.org>,\n  <mailto:linuxppc-dev+subscribe-nomail@lists.ozlabs.org>",
        "List-Unsubscribe": "<mailto:linuxppc-dev+unsubscribe@lists.ozlabs.org>",
        "Precedence": "list",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "X-TM-AS-GCONF": "00",
        "X-Proofpoint-Reinject": "loops=2 maxloops=12",
        "X-Proofpoint-ORIG-GUID": "MxW92nbsoroDrGprQccOKyKqxuzsGpV7",
        "X-Proofpoint-GUID": "KBfdaCVg5GSQbs2a1WcrKt-jkNjBG0TQ",
        "X-Proofpoint-Spam-Details-Enc": "AW1haW4tMjYwNTAyMDE0MSBTYWx0ZWRfXz8gZmUta0j1i\n IyrIw+Vr4UVii8l2rL3jtre9HuQilEgIx+kTRL5WS9ayxXX3/7VkQLQ/W6znry3ZVfQWcjHrjug\n GsvB3qg46TNRrEA7nASU/+5hlwcF1+uk3guVDbzD+Xjcqc31qM/jIXNTfUh5FH3c6UEktPpGXLE\n G3Gz1vTyqxMBgRqg9Vid2XAKVfNiRlupz3uSf0DeXVhLhJYCOxNl6w32wi10Q9YBlfNJ+97tv1X\n dLWBzoyQPmFlojw8Fuq82rKMnHQPsAPlz3x/y7FMGuiA0I6/fRye1lBugJ6UdSJzxcgWPLBG+fS\n szz0PyCiZj39Sw838wA7CCBJHdhy/Y/8emr0NkxLv3eElRRNTvVyOO/hQ9r/gjwR1NxJUkRw0BC\n HolHuntdD9ljxp72hkR0W2onN85iXSy3Ge+IuToRL3X3ZUxF8uxTImnS+rzdb/8GPkRZMvBn6yo\n 0eAprYvn2qHajDfRLiw==",
        "X-Authority-Analysis": "v=2.4 cv=UbFhjqSN c=1 sm=1 tr=0 ts=69f60b18 cx=c_pps\n a=3Bg1Hr4SwmMryq2xdFQyZA==:117 a=3Bg1Hr4SwmMryq2xdFQyZA==:17\n a=NGcC8JguVDcA:10 a=VkNPw1HP01LnGYTKEx00:22 a=RnoormkPH1_aCDwRdu11:22\n a=U7nrCbtTmkRpXpFmAIza:22 a=VnNF1IyMAAAA:8 a=V_ROcSP5cVqbivJN_SYA:9",
        "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-02_03,2026-04-30_02,2025-10-01_01",
        "X-Proofpoint-Spam-Details": "rule=outbound_notspam policy=outbound score=0\n clxscore=1015 spamscore=0 lowpriorityscore=0 malwarescore=0 suspectscore=0\n adultscore=0 priorityscore=1501 bulkscore=0 phishscore=0 impostorscore=0\n classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0\n reason=mlx scancount=1 engine=8.22.0-2604200000 definitions=main-2605020141",
        "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\nUsing \"struct evlist *evlist __maybe_unused\", gives below\nwarning 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\nUpdated  parameter as \"struct evlist __maybe_unused *evlist\"\nWith the change, there is no erros/warnings with kernel-doc\n\nSigned-off-by: Athira Rajeev <atrajeev@linux.ibm.com>\n---\nChangelog:\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 | 17 ++++++++++++++++-\n 1 file changed, 16 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/tools/perf/util/auxtrace.c b/tools/perf/util/auxtrace.c\nindex 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+ * 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",
    "prefixes": [
        "V4",
        "2/2"
    ]
}