Show a cover letter.

GET /api/1.1/covers/2227711/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 2227711,
    "url": "http://patchwork.ozlabs.org/api/1.1/covers/2227711/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/linux-pci/cover/20260424-parse_iommu_cells-v14-0-fd02f11b6c38@oss.qualcomm.com/",
    "project": {
        "id": 28,
        "url": "http://patchwork.ozlabs.org/api/1.1/projects/28/?format=api",
        "name": "Linux PCI development",
        "link_name": "linux-pci",
        "list_id": "linux-pci.vger.kernel.org",
        "list_email": "linux-pci@vger.kernel.org",
        "web_url": null,
        "scm_url": null,
        "webscm_url": null
    },
    "msgid": "<20260424-parse_iommu_cells-v14-0-fd02f11b6c38@oss.qualcomm.com>",
    "date": "2026-04-24T05:56:07",
    "name": "[v14,0/3] of: parsing of multi #{iommu,msi}-cells in maps",
    "submitter": {
        "id": 92739,
        "url": "http://patchwork.ozlabs.org/api/1.1/people/92739/?format=api",
        "name": "Vijayanand Jitta",
        "email": "vijayanand.jitta@oss.qualcomm.com"
    },
    "mbox": "http://patchwork.ozlabs.org/project/linux-pci/cover/20260424-parse_iommu_cells-v14-0-fd02f11b6c38@oss.qualcomm.com/mbox/",
    "series": [
        {
            "id": 501304,
            "url": "http://patchwork.ozlabs.org/api/1.1/series/501304/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/linux-pci/list/?series=501304",
            "date": "2026-04-24T05:56:07",
            "name": "of: parsing of multi #{iommu,msi}-cells in maps",
            "version": 14,
            "mbox": "http://patchwork.ozlabs.org/series/501304/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/2227711/comments/",
    "headers": {
        "Return-Path": "\n <linux-pci+bounces-53103-incoming=patchwork.ozlabs.org@vger.kernel.org>",
        "X-Original-To": [
            "incoming@patchwork.ozlabs.org",
            "linux-pci@vger.kernel.org"
        ],
        "Delivered-To": "patchwork-incoming@legolas.ozlabs.org",
        "Authentication-Results": [
            "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=qualcomm.com header.i=@qualcomm.com header.a=rsa-sha256\n header.s=qcppdkim1 header.b=MQtcYpEU;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com\n header.a=rsa-sha256 header.s=google header.b=b0mtxIKD;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=172.234.253.10; helo=sea.lore.kernel.org;\n envelope-from=linux-pci+bounces-53103-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)",
            "smtp.subspace.kernel.org;\n\tdkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com\n header.b=\"MQtcYpEU\";\n\tdkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com\n header.b=\"b0mtxIKD\"",
            "smtp.subspace.kernel.org;\n arc=none smtp.client-ip=205.220.180.131",
            "smtp.subspace.kernel.org;\n dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com",
            "smtp.subspace.kernel.org;\n spf=pass smtp.mailfrom=oss.qualcomm.com"
        ],
        "Received": [
            "from sea.lore.kernel.org (sea.lore.kernel.org [172.234.253.10])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g22L45QkKz1xvV\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 24 Apr 2026 15:57:32 +1000 (AEST)",
            "from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby sea.lore.kernel.org (Postfix) with ESMTP id 6D2813010BAA\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 24 Apr 2026 05:57:28 +0000 (UTC)",
            "from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 3952C346FAB;\n\tFri, 24 Apr 2026 05:57:28 +0000 (UTC)",
            "from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com\n [205.220.180.131])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id 308F8346E6D\n\tfor <linux-pci@vger.kernel.org>; Fri, 24 Apr 2026 05:57:26 +0000 (UTC)",
            "from pps.filterd (m0279871.ppops.net [127.0.0.1])\n\tby mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id\n 63O3A0Dx756701\n\tfor <linux-pci@vger.kernel.org>; Fri, 24 Apr 2026 05:57:25 GMT",
            "from mail-pg1-f199.google.com (mail-pg1-f199.google.com\n [209.85.215.199])\n\tby mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4dqr4bjcc9-1\n\t(version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT)\n\tfor <linux-pci@vger.kernel.org>; Fri, 24 Apr 2026 05:57:25 +0000 (GMT)",
            "by mail-pg1-f199.google.com with SMTP id\n 41be03b00d2f7-c7989b7cdd0so7500682a12.1\n        for <linux-pci@vger.kernel.org>; Thu, 23 Apr 2026 22:57:24 -0700 (PDT)",
            "from hu-vjitta-hyd.qualcomm.com ([202.46.23.25])\n        by smtp.gmail.com with ESMTPSA id\n 41be03b00d2f7-c79770512afsm17288101a12.31.2026.04.23.22.57.12\n        (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n        Thu, 23 Apr 2026 22:57:23 -0700 (PDT)"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1777010248; cv=none;\n b=i1jk9KvugD8h+AH0vHmHaazFnqeQv/DlMFi5z5H/qb5aHYqFFiAvUXwpAkQtVZkchUnVRCdDvABQDH3yDSKePiwpnM+ySNEDSAHrWQf39Kzbkn3JYY12ZIgMXfITCN2ASadtKmSY8npV+JpEwzDEOIlUL4KGV1kUW+38s/NDckA=",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1777010248; c=relaxed/simple;\n\tbh=PeFaW7Kdrw7pS2+czBSVD/S1WiB/N+6erzrmdMB/5Y8=;\n\th=From:Subject:Date:Message-Id:MIME-Version:Content-Type:To:Cc;\n b=XRBQD8eK+TVbUP60X3kTK+5x7VkG5TefmbsAXpXo3KWFQ5XrwXXQDyIU1U8cw4v2zCvu832JJ0EGPuAET9qgBfVsZPi2V4EABKF33D6aUk4kWJtKv3b24prav5CAJTQysnR3AItFfywBmhbhmQEwe45wy/2+wnAqhkif5BShgEo=",
        "ARC-Authentication-Results": "i=1; smtp.subspace.kernel.org;\n dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com;\n spf=pass smtp.mailfrom=oss.qualcomm.com;\n dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com\n header.b=MQtcYpEU;\n dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com\n header.b=b0mtxIKD; arc=none smtp.client-ip=205.220.180.131",
        "DKIM-Signature": [
            "v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h=\n\tcc:content-transfer-encoding:content-type:date:from:message-id\n\t:mime-version:subject:to; s=qcppdkim1; bh=yTMN2l5WkkkwpWqXhyGv2M\n\tqcOf1QG4ZJfDdEl00tCos=; b=MQtcYpEUYiNQ6ouvYFCY2hN7w3wo8Buj0qjRiY\n\tCs0V26GdDiI+8cixO9L0s0GnotUXPU8KmW2esxPobQoRrgws7mf8/sBbUwqf3/5I\n\tWX21nQs9JKIAXhCr6frgHg2PJk/Jb19jf+CAxtbdrrrNhuR/io1XbPtLYxWdqeEa\n\tGKJfQJHDyKrvYvzLyqt3cYfCM8CsDZQUqKTT4rstdydZpL9aM6hzshD3mhGukIFe\n\tV7fQiubMYXayk0ncykH0WF8j5wU1MozQpfvFgvH/mtA90uk13P83jOB3nAndEZ9a\n\tLY1am2uRPuODluYYviP6O5n7FjEtVKvm1rHMWgaRl7N9eP8g==",
            "v=1; a=rsa-sha256; c=relaxed/relaxed;\n        d=oss.qualcomm.com; s=google; t=1777010244; x=1777615044;\n darn=vger.kernel.org;\n        h=cc:to:content-transfer-encoding:mime-version:message-id:date\n         :subject:from:from:to:cc:subject:date:message-id:reply-to;\n        bh=yTMN2l5WkkkwpWqXhyGv2MqcOf1QG4ZJfDdEl00tCos=;\n        b=b0mtxIKDn1VDTMLtfRUq82uIaHxR3dfGMUmMICrw7afJOLW6HBMp55zMIOUAJPAnS+\n         NZXbZ0E29KchkzJTRo7P9T5UwwvPJU0u2JOcHVOLGYdyZClrHgEEzF1N+d9KTj23bzek\n         0I/SjUxUn/wf8uG7i1+ndmhWWFLCJEZQzeYO72aodaNjqWH48sxUCAJ3seUfeCW2hqdx\n         38dBRb8f/fqB6zi4w+jryRN8s8k273nDNUsD17LQK23fwDvKcj6Ti94OvrfBeoipwr6O\n         6aUGsO4Rw+CnzW2zb8tUXuFvMEC4cXHH987kUJPu0sO6tQDnkm2NiLc/ERwQRIhM91Kq\n         foUQ=="
        ],
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n        d=1e100.net; s=20251104; t=1777010244; x=1777615044;\n        h=cc:to:content-transfer-encoding:mime-version:message-id:date\n         :subject:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date\n         :message-id:reply-to;\n        bh=yTMN2l5WkkkwpWqXhyGv2MqcOf1QG4ZJfDdEl00tCos=;\n        b=bRlQ1jz72Dp8GtkYLaigvLXfTpGw7Wtvkd6ubr7V8eK6yiF1wcM9yRswnyEZFX2O8P\n         LSFWtyGKkmuxwmi6YkGWNrfqCHuKyuWvRluXxMiUQQljYY7Ess1yMinhw0sKX0as9FKM\n         uREZzA3RdiPrPUAeWy2FgOMxGagnDzSsQrUdASUsTTRW/pXR9watkOdAyAvmc/8enxgt\n         E4gCz7A/rOea5RqMSmj/2JpFbn4VyxbfpcOFaZWJ05OhaTbfVFEfBeguSIB4VTDIwOUp\n         1ygZd0mKN2XMjmT5gDMWegsuaG8hbLGfeVai5QBYDzWyo3rxNvRNkhuhul7ULf6NJf52\n         MIKA==",
        "X-Forwarded-Encrypted": "i=1;\n AFNElJ8djT0pao5zm1NiSnPO1HB/lHuob2EaRvnFESJEtqdRjAuY+k3HhROYWA3szwtV7Wh1FbMPK4vEhaY=@vger.kernel.org",
        "X-Gm-Message-State": "AOJu0Yyuu8KKz/jVSojtXJ/RKAPJN7nB1Lsn/btW0gJtRVtDDDTHk7/6\n\tNHBbHUZTVF0IrI0lUdlEG9JdZpv+4Ri/4DYcoGIHN3VL8RLUVn/fZF105kDhpmYt3MoDOzLuJ1d\n\trZKmlsld1oJPHtIR43LCNRs8yUfn4Dt8J78lymnuBo54vp7U/SABm30L+D3JCcp4=",
        "X-Gm-Gg": "AeBDieuuB+bzZ4X63+qYvnDAptaiLimefhr7r2kSLhmU8+fO2scNVpcVn/aRJJQSsHe\n\tpq4RSo55A8xJWcJpkP77Sh/1uUp9hqHeTLSOHML2JWaq0LlYIm3K5V3z1AJeVwU6SzuHzxs74Kq\n\tPkvNnW6nh/uGpiYjfH3qOFfbL/s0hrRY3jbnj/uDJYCHzYRmUGIOxS+cy/MPPPAV00RWW/sxhx9\n\tucVKHE0vwJXJApyZHzSc5Is+TlND4GJ7/gdxYvSIZRkiGztF2WdJ2VlK/+eB6hb9tTm7LYv6QNy\n\tt+MeR6ygTgVr/wk3ZHJOmVSudf6CbdtOwvDnFEnz0sD0t9XN2kZgMhq90l3+h5ig4OZUUhYjjxU\n\tvFXtU+XuBzbbHpiArN33DF7IDESPTjYSFPl7sJzLvR1mEg0zLEl+FG2J1tW1vUW8uBz4=",
        "X-Received": [
            "by 2002:a05:6a20:7292:b0:39f:ebf7:5ba6 with SMTP id\n adf61e73a8af0-3a08d7abf91mr32181499637.25.1777010243934;\n        Thu, 23 Apr 2026 22:57:23 -0700 (PDT)",
            "by 2002:a05:6a20:7292:b0:39f:ebf7:5ba6 with SMTP id\n adf61e73a8af0-3a08d7abf91mr32181453637.25.1777010243387;\n        Thu, 23 Apr 2026 22:57:23 -0700 (PDT)"
        ],
        "From": "Vijayanand Jitta <vijayanand.jitta@oss.qualcomm.com>",
        "Subject": "[PATCH v14 0/3] of: parsing of multi #{iommu,msi}-cells in maps",
        "Date": "Fri, 24 Apr 2026 11:26:07 +0530",
        "Message-Id": "<20260424-parse_iommu_cells-v14-0-fd02f11b6c38@oss.qualcomm.com>",
        "Precedence": "bulk",
        "X-Mailing-List": "linux-pci@vger.kernel.org",
        "List-Id": "<linux-pci.vger.kernel.org>",
        "List-Subscribe": "<mailto:linux-pci+subscribe@vger.kernel.org>",
        "List-Unsubscribe": "<mailto:linux-pci+unsubscribe@vger.kernel.org>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "8bit",
        "X-B4-Tracking": "v=1; b=H4sIAPgF62kC/33PwW7DIAwG4FepOI8KQ2Bhp73HNFWOMStS2nSwR\n puqvPtoL8uB7GLpt+zP8k0UzomLeNndROY5lTSda4DuaSfoiOcPlinUhtBKO2UUyAvmwoc0nU7\n XA/E4FglkzLPrkYcBRd27ZI7p+4G+vdd8TOVryj+PG7O/d//TZi+V7AIMxExkGV6nUvafVxypT\n u1rEXd0BrWWfEsCVSlyOhKiRQj9FgUrStsmBZWCyBEtKe41bVF6RZnmf6ArFZhiMMoyo9+izB/\n Vqb5JmUpF9BrYa+dgaFDLsvwCdDU36+YBAAA=",
        "X-Change-ID": "20260301-parse_iommu_cells-1c33768aebba",
        "To": "Nipun Gupta <nipun.gupta@amd.com>,\n Nikhil Agarwal <nikhil.agarwal@amd.com>, Joerg Roedel <joro@8bytes.org>,\n Will Deacon <will@kernel.org>, Robin Murphy <robin.murphy@arm.com>,\n Marc Zyngier <maz@kernel.org>, Lorenzo Pieralisi <lpieralisi@kernel.org>,\n Thomas Gleixner <tglx@kernel.org>, Saravana Kannan <saravanak@kernel.org>,\n Richard Zhu <hongxing.zhu@nxp.com>, Lucas Stach <l.stach@pengutronix.de>,\n\t=?utf-8?q?Krzysztof_Wilczy=C5=84ski?= <kwilczynski@kernel.org>,\n Manivannan Sadhasivam <mani@kernel.org>, Bjorn Helgaas <bhelgaas@google.com>,\n Frank Li <Frank.Li@nxp.com>, Sascha Hauer <s.hauer@pengutronix.de>,\n Pengutronix Kernel Team <kernel@pengutronix.de>,\n Fabio Estevam <festevam@gmail.com>, Juergen Gross <jgross@suse.com>,\n Stefano Stabellini <sstabellini@kernel.org>,\n Oleksandr Tyshchenko <oleksandr_tyshchenko@epam.com>,\n Dmitry Baryshkov <dmitry.baryshkov@oss.qualcomm.com>,\n Konrad Dybcio <konrad.dybcio@oss.qualcomm.com>,\n Bjorn Andersson <bjorn.andersson@oss.qualcomm.com>,\n Rob Herring <robh@kernel.org>, Conor Dooley <conor+dt@kernel.org>,\n Krzysztof Kozlowski <krzk+dt@kernel.org>,\n Prakash Gupta <prakash.gupta@oss.qualcomm.com>,\n Vikash Garodia <vikash.garodia@oss.qualcomm.com>",
        "Cc": "linux-kernel@vger.kernel.org, iommu@lists.linux.dev,\n        linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org,\n        linux-pci@vger.kernel.org, imx@lists.linux.dev,\n        xen-devel@lists.xenproject.org, linux-arm-msm@vger.kernel.org,\n        Vijayanand Jitta <vijayanand.jitta@oss.qualcomm.com>,\n        Charan Teja Kalla <charan.kalla@oss.qualcomm.com>",
        "X-Mailer": "b4 0.15.2",
        "X-Developer-Signature": "v=1; a=ed25519-sha256; t=1777010232; l=8281;\n i=vijayanand.jitta@oss.qualcomm.com; s=20260301; h=from:subject:message-id;\n bh=PeFaW7Kdrw7pS2+czBSVD/S1WiB/N+6erzrmdMB/5Y8=;\n b=fEKGmPri8LDYPP4nIodsRoCyeyYT1OGPS0OqEqaH/APENLrZpB+Q8nuTYzbfPqq917ee5aP2w\n JYKMUiobPcFDsrp7EnUv2N9T4k7yYV5sMOp4PQ9MR9EoL3rLLaW0Suj",
        "X-Developer-Key": "i=vijayanand.jitta@oss.qualcomm.com; a=ed25519;\n pk=Lpi7Cs3wHe8KZtqvyci7FTOLzsKpEHKGCaPNZw+1zRI=",
        "X-Proofpoint-Spam-Details-Enc": "AW1haW4tMjYwNDI0MDA1MSBTYWx0ZWRfX1NdQrIw7K3g8\n Hqj2Hsf8Use2rmvskYW5uiCBy5FwsW2XALLjbvdvpK5t3JPP0xJ42d9q2TjlZVxUrxHVN6g1w/U\n oPaaxYNAKjLMT3GDLi+tU9E0oXbr8JYH03eYETrig2sUQ8A4KazeLx2iQgW67WMHO9po7nbKa1y\n HrVj9ieh52FgyU41HJlTfse46VLr8aC5uAK+klHx7jIKt13SDtsQvKDEwv4Lp7q2aiThoMAvQqn\n 62qHJkQ78PmMncsxOKZ/Mrf360B/a7b0V3O2ECj0VpBJtM0WyKtaO89upHeh8T8z4rosKOYz5qg\n nBbYO2Oid9u1I/ydvyO5I/ehS/55skDo/GOpTpd7oRkL8YYwfurkj4bBX15TQTcPKKWAx7AQD9N\n gCmIvZXf0Za0308YyUAwF/oOcn1Ll2xnLBFGc734KSfGQmp+sEu/XTpEyr+4lt1LAAsZwugNc05\n RU+c7vGmUse+eyCAEyg==",
        "X-Authority-Analysis": "v=2.4 cv=TtnWQjXh c=1 sm=1 tr=0 ts=69eb0645 cx=c_pps\n a=Oh5Dbbf/trHjhBongsHeRQ==:117 a=ZePRamnt/+rB5gQjfz0u9A==:17\n a=IkcTkHD0fZMA:10 a=A5OVakUREuEA:10 a=s4-Qcg_JpJYA:10\n a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=3WHJM1ZQz_JShphwDgj5:22\n a=VwQbUJbxAAAA:8 a=COk6AnOGAAAA:8 a=NEAV23lmAAAA:8 a=bC-a23v3AAAA:8\n a=EUspDBNiAAAA:8 a=zd2uoN0lAAAA:8 a=tA7aZXjiAAAA:8 a=7CQSdrXTAAAA:8\n a=8AirrxEcAAAA:8 a=1XWaLZrsAAAA:8 a=pGLkceISAAAA:8 a=iox4zFpeAAAA:8\n a=DBfv99YmAAAA:8 a=JfrnYn6hAAAA:8 a=cWRNjhkoAAAA:8 a=fRNrpDd4OrOfg74B-YAA:9\n a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=_Vgx9l1VpLgwpw_dHYaR:22\n a=TjNXssC_j7lpFel5tvFf:22 a=FO4_E8m0qiDe52t0p3_H:22 a=kIIFJ0VLUOy1gFZzwZHL:22\n a=a-qgeE7W1pNrGK8U0ZQC:22 a=ST-jHhOKWsTCqRlWije3:22 a=WzC6qhA0u3u7Ye7llzcV:22\n a=1CNFftbPRP8L7MoqJWF3:22 a=sVa6W5Aao32NNC1mekxh:22",
        "X-Proofpoint-ORIG-GUID": "pF4KB6n4w-iMjNxxF7WLmbfAVBLDqp37",
        "X-Proofpoint-GUID": "pF4KB6n4w-iMjNxxF7WLmbfAVBLDqp37",
        "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-04-23_03,2026-04-21_02,2025-10-01_01",
        "X-Proofpoint-Spam-Details": "rule=outbound_notspam policy=outbound score=0\n priorityscore=1501 impostorscore=0 malwarescore=0 clxscore=1015 adultscore=0\n spamscore=0 bulkscore=0 suspectscore=0 phishscore=0 lowpriorityscore=0\n classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0\n reason=mlx scancount=1 engine=8.22.0-2604200000 definitions=main-2604240051"
    },
    "content": "So far our parsing of {iommu,msi}-map properties has always blindly\nassumed that the output specifiers will always have exactly 1 cell.\nThis typically does happen to be the case, but is not actually enforced\n(and the PCI msi-map binding even explicitly states support for 0 or 1\ncells) - as a result we've now ended up with dodgy DTs out in the field\nwhich depend on this behaviour to map a 1-cell specifier for a 2-cell\nprovider, despite that being bogus per the bindings themselves.\n\nSince there is some potential use[1] in being able to map at least\nsingle input IDs to multi-cell output specifiers (and properly support\n0-cell outputs as well), add support for properly parsing and using the\ntarget nodes' #cells values, albeit with the unfortunate complication of\nstill having to work around expectations of the old behaviour too.\n\t\t\t\t\t\t\t-- Robin.\n\nUnlike single #{}-cell, it is complex to establish a linear relation\nbetween input 'id' and output specifier for multi-cell properties, thus\nit is always expected that len never going to be > 1.\n\nThese changes have been tested on QEMU for the arm64 architecture.\n\nSince, this would also need update in dt-schema, raised PR[2] for the\nsame.\n\n[1] https://lore.kernel.org/all/20250627-video_cb-v3-0-51e18c0ffbce@quicinc.com/\n[2] PR for iommu-map dtschema: https://github.com/devicetree-org/dt-schema/pull/184\n\nV14:\n  - Updated Patch 2 (\"of: Factor arguments passed to of_map_id() into a struct\") to\n    fix below two issues in of_msi_xlate() that were introduced by the API refactoring:\n\n    1) The refactoring changed of_map_id()'s dual-purpose **target parameter to\n    an explicit filter_np parameter. In of_msi_xlate(), this caused\n    of_map_msi_id() to return 0 (pass-through) instead of -ENODEV when a node\n    has no msi-map, terminating the device hierarchy walk prematurely before\n    reaching the root complex node that has the msi-map. This broke MSI\n    allocation for PCIe endpoint devices (e.g., wcn7850 Wi-Fi on ARM64).\n\n    2) Additionally, fsl_mc_get_msi_id() passes msi_np == NULL to of_msi_xlate(),\n    which would dereference NULL with the new API.\n\n  Link to v13:\n  https://patch.msgid.link/20260408-parse_iommu_cells-v13-0-fa921e92661b@oss.qualcomm.com\n\nV13:\n  - Fix bad_map handling in of_map_id(): 'cells' is re-initialized to 0\n    on each loop iteration, so the !bad_map guard was insufficient, cells\n    stayed 0 for all entries after the first. Fix by explicitly setting\n    cells=1 when bad_map is true on every iteration.\n  - Collected Acked-by from Frank Li.\n\n  Link to v12:\n  https://patch.msgid.link/20260331-parse_iommu_cells-v12-0-decfd305eea9@oss.qualcomm.com\n\nV12:\n  - Call of_node_put() unconditionally in imx_pcie_add_lut_by_rid()\n    thereby addressing comments from Bjorn Helgaas.\n\n  Link to v11:\n  https://lore.kernel.org/r/20260325-parse_iommu_cells-v11-0-1fefa5c0e82c@oss.qualcomm.com\n\nV11:\n  - Added explicit filter_np parameter to of_map_id() and of_map_msi_id()\n    per Dmitry Baryshkov's review feedback, making the filter explicit\n    instead of overloading arg->np as both input filter and output parameter.\n  - Removed of_node_put() from inside of_map_id(), making the caller responsible\n    for reference management. Updated of_msi_xlate() to properly handle reference counting.\n  - Collected ACKed by tags, and fixed minor typos.\n  Link to v10:\n  https://lore.kernel.org/r/20260309-parse_iommu_cells-v10-0-c62fcaa5a1d8@oss.qualcomm.com\n\nV10:\n  - Move of_map_iommu_id()/of_map_msi_id() from include/linux/of.h to\n    drivers/of/base.c as out-of-line helpers per feedback from Marc Zyngier\n    and Rob Herring.\n  - Add kernel-doc to document both helpers for discoverability and\n    usage clarity.\n  - Fix of_map_msi_id() wrapper and all its callers (cdx_msi.c,\n    irq-gic-its-msi-parent.c, drivers/of/irq.c) to correctly use the new\n    struct of_phandle_args-based API with proper of_node_put() handling\n    as per feeback from Dmitry.\n  Link to v9:\n  https://lore.kernel.org/r/20260301-parse_iommu_cells-v9-0-4d1bceecc5e1@oss.qualcomm.com\n\nV9:\n  - Updated TO/CC list based on feedback to include all relevant\n    maintainers.\n  - No functional changes to the patches themselves.\n\n  Link to V8:\n  https://lore.kernel.org/all/20260226074245.3098486-1-vijayanand.jitta@oss.qualcomm.com/\n\nV8:\n  - Removed mentions of of_map_args from commit message to match code.\n\n  Link to V7:\n  https://lore.kernel.org/all/20260210101157.2145113-1-vijayanand.jitta@oss.qualcomm.com/\n\nV7:\n  - Removed of_map_id_args structure and replaced it with\n    of_phandle_args as suggested by Dmitry.\n\n  Link to V6:\n  https://lore.kernel.org/all/20260121055400.937856-1-vijayanand.jitta@oss.qualcomm.com/\n\nV6:\n  - Fixed build error reported by kernel test bot.\n\n  Link to V5:\n  https://lore.kernel.org/all/20260118181125.1436036-1-vijayanand.jitta@oss.qualcomm.com/\n\nV5:\n  - Fixed Build Warnings.\n  - Raised PR for iommu-map dtschema: https://github.com/devicetree-org/dt-schema/pull/184\n\n  Link to V4:\n  https://lore.kernel.org/all/20251231114257.2382820-1-vijayanand.jitta@oss.qualcomm.com/\n\nV4:\n  - Added Reviewed-by tag.\n  - Resolved warnings reported by kernel test bot, minor code\n    reorganization.\n\n  Link to V3:\n  https://lore.kernel.org/all/20251221213602.2413124-1-vijayanand.jitta@oss.qualcomm.com/\n\nV3:\n  - Added Reviewed-by tag.\n  - Updated of_map_id_args struct as a wrapper to of_phandle_args and\n    added comment description as suggested by Rob Herring.\n\n  Link to V2:\n  https://lore.kernel.org/all/20251204095530.8627-1-vijayanand.jitta@oss.qualcomm.com/\n\nV2:\n  - Incorporated the patches from Robin that does the clean implementation.\n  - Dropped the patches the were adding multi-map support from this series\n    as suggested.\n\nV1:\n https://lore.kernel.org/all/cover.1762235099.git.charan.kalla@oss.qualcomm.com/\n\nRFC:\n https://lore.kernel.org/all/20250928171718.436440-1-charan.kalla@oss.qualcomm.com/#r\n\nSigned-off-by: Vijayanand Jitta <vijayanand.jitta@oss.qualcomm.com>\n---\nTo: Nipun Gupta <nipun.gupta@amd.com>\nTo: Nikhil Agarwal <nikhil.agarwal@amd.com>\nTo: Joerg Roedel <joro@8bytes.org>\nTo: Will Deacon <will@kernel.org>\nTo: Robin Murphy <robin.murphy@arm.com>\nTo: Lorenzo Pieralisi <lpieralisi@kernel.org>\nTo: Marc Zyngier <maz@kernel.org>\nTo: Thomas Gleixner <tglx@kernel.org>\nTo: Rob Herring <robh@kernel.org>\nTo: Saravana Kannan <saravanak@kernel.org>\nTo: Richard Zhu <hongxing.zhu@nxp.com>\nTo: Lucas Stach <l.stach@pengutronix.de>\nTo: Krzysztof Wilczyński <kwilczynski@kernel.org>\nTo: Manivannan Sadhasivam <mani@kernel.org>\nTo: Bjorn Helgaas <bhelgaas@google.com>\nTo: Frank Li <Frank.Li@nxp.com>\nTo: Sascha Hauer <s.hauer@pengutronix.de>\nTo: Pengutronix Kernel Team <kernel@pengutronix.de>\nTo: Fabio Estevam <festevam@gmail.com>\nTo: Juergen Gross <jgross@suse.com>\nTo: Stefano Stabellini <sstabellini@kernel.org>\nTo: Oleksandr Tyshchenko <oleksandr_tyshchenko@epam.com>\nCc: linux-arm-msm@vger.kernel.org\nCc: linux-kernel@vger.kernel.org\nCc: iommu@lists.linux.dev\nCc: linux-arm-kernel@lists.infradead.org\nCc: devicetree@vger.kernel.org\nCc: linux-pci@vger.kernel.org\nCc: imx@lists.linux.dev\nCc: xen-devel@lists.xenproject.org\n\n---\nCharan Teja Kalla (1):\n      of: Factor arguments passed to of_map_id() into a struct\n\nRobin Murphy (2):\n      of: Add convenience wrappers for of_map_id()\n      of: Respect #{iommu,msi}-cells in maps\n\n drivers/cdx/cdx_msi.c                    |   8 +-\n drivers/iommu/of_iommu.c                 |   6 +-\n drivers/irqchip/irq-gic-its-msi-parent.c |  11 +-\n drivers/of/base.c                        | 215 ++++++++++++++++++++++++-------\n drivers/of/irq.c                         |  31 ++++-\n drivers/pci/controller/dwc/pci-imx6.c    |  34 +++--\n drivers/pci/controller/pcie-apple.c      |   6 +-\n drivers/xen/grant-dma-ops.c              |   5 +-\n include/linux/of.h                       |  30 ++++-\n 9 files changed, 257 insertions(+), 89 deletions(-)\n---\nbase-commit: 3fa5e5702a82d259897bd7e209469bc06368bf31\nchange-id: 20260301-parse_iommu_cells-1c33768aebba\n\nBest regards,\n--  \nVijayanand Jitta <vijayanand.jitta@oss.qualcomm.com>"
}