From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 309EFF433DF for ; Thu, 16 Apr 2026 03:26:53 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender:List-Subscribe:List-Help :List-Post:List-Archive:List-Unsubscribe:List-Id:Content-Transfer-Encoding: Content-Type:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Owner; bh=vDK6pAlGwxYE897uZGp1sSM8FaPwo0OHKjiLMvDJlSM=; b=XCyKYun6gHai5tUhv9MvDT+H2R Cv19vwZvr2u+il2+DvpuRNmyyqp82z+pxYkhZwcu/0KrHKbhqZX9a3PVbNo/hqH0Klnw7QlEZfdxQ iMxz/ptEXIKEt1L8TeMdEedUHtK2zoIE1Jfs5eEFirQVdHzNc0mX5Aap4PkHYN69M3EVOKRPWF4u7 dug/dlRQoi25g0Zbd75hv1Wr4zu/RdSXX+1cAG9VaNWQLge+DYXNyXHPnKEl5bYtfiNOI97luUtuE eB3XJdfdSw1DtkGg4b5pH2+2/7USdkxtMxwfPNkspvuVPO3vX6+d3qPaqD3qbT98ndXz6IqyKkc7H GlbivHwQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.98.2 #2 (Red Hat Linux)) id 1wDDNM-00000001vU2-0ssB; Thu, 16 Apr 2026 03:26:44 +0000 Received: from mx0a-0031df01.pphosted.com ([205.220.168.131]) by bombadil.infradead.org with esmtps (Exim 4.98.2 #2 (Red Hat Linux)) id 1wDDNJ-00000001vTg-2hu4 for linux-arm-kernel@lists.infradead.org; Thu, 16 Apr 2026 03:26:42 +0000 Received: from pps.filterd (m0279865.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 63G15tQD579795 for ; Thu, 16 Apr 2026 03:26:40 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= vDK6pAlGwxYE897uZGp1sSM8FaPwo0OHKjiLMvDJlSM=; b=SWY9Qd3WKivoaF5z JCNUWFn6lHYDHyOuTykCB5IdRbNsUrvJXHcbkMpoXZzEFaGmmiVh4/iNs5m2m3/d 1ctBxyEGpnQhAu31duNagl7MvxO6Dphq86jgT8s1bddtRVBYt5aiZvC0Q06xHb4f pJ5mQ251/oFa31hOjocFi81oL7nTanhTsaxGMhiRvRj3+79HdoaaaOzK6DQpIlj8 DMKRTns25lEdApCluihx1mohx8vnRlScMBm04DII0VQ2demD5TuPnhQ0Qu4l9aQk +r4A6uDr4avQHRyxxypoO1lgUgcJ9ZoXxMNexwA1OoF0Yg1Uo5d1Y4vVKNY0rEpu 3CT5jQ== Received: from mail-pg1-f198.google.com (mail-pg1-f198.google.com [209.85.215.198]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4djcr8t3pd-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Thu, 16 Apr 2026 03:26:40 +0000 (GMT) Received: by mail-pg1-f198.google.com with SMTP id 41be03b00d2f7-c769b25315eso9493738a12.2 for ; Wed, 15 Apr 2026 20:26:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1776310000; x=1776914800; darn=lists.infradead.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=vDK6pAlGwxYE897uZGp1sSM8FaPwo0OHKjiLMvDJlSM=; b=BsL22Lvukw7gNRbkfOgZXyMxb7BEW3RDU0Aeu8irjzh9M9USVCol0gluT60+hPJp7Q 0bhPeEIVtgG85hm5G1AbTbH6iLq7PGFpKjEyL9cOF7Y/MRikCyhtTC8MhCFTggNebCxO N2N+3vSD8HQJYs61+RLhqMcTOF9BaOq9LFVSF3h+O1Pd0AFu3nFwfLVPBmRTSsS9kMiK peoESIlaIWQ63ntjmF3qqbEN/bijZEqTirNOIcI8Qm7qzMbUiqU22Rro2/035DeVRc0P 8xv9rANjXxOwbofPUy6LU2nUtZbrrGhHzwjFZxlMAvCjgBLeEqh2J+kQQNdirwdn7uS5 W16Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776310000; x=1776914800; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=vDK6pAlGwxYE897uZGp1sSM8FaPwo0OHKjiLMvDJlSM=; b=E7WVi0mIf5iQaU7EW9hI5x2VgKLQ+MrFRE08X2UVhWr7DaZnS9HdWZLBWOiMueMbHQ hrEddOBCCx0xNVl9kAMPj7QAP6x8pQQgJW74eczDJR/AYR4k7J0/ESQ+CJgMT1MzjaSs 3wyQcHGSgfMvCHa7jRlVcD0bK755mfJDOU3TkcYZosXuJU7ontN5JbbF5h37fJ302ZJs ZDzbJKHOVqKn1qMUW+N/4xZAoA4i89N6ONUHhk4ZzbRZU9dcDCe2tiV6vJy3c6zbxgbU DvUa44AlsbQk49X2KxV03Utd2QXjIV6ZfSVZsZZvu7ErVFVHgqkSXcfwt1Y+7+Y55OZx XRfg== X-Forwarded-Encrypted: i=1; AFNElJ8L6YjtKgvEz15h8EwqDQfbWy0K4CoUrDeKiR5Hp69fMl0cxuk2BASb7QxmgOOHfk1RdvFopk/GkOAYnKtbHcR/@lists.infradead.org X-Gm-Message-State: AOJu0Yxp0ZKb9t8ncXUPJKCkCiaNWIbgjd/FH3StN2vQjv1AXOoihQEo 9f/ch8RLdlP9G2LMt272mm2pzpNa1rYHJJDEhJwnY8lk77K3SxDRbya7DFr/hEjFtmNgoLdJSMe Z7r7QTWK8Chzp9GkzX7H3NGdRKUUgLrSyma+Ro9X858Ykhib+cSayTr7jEngPMzjFof7x5PnvQ2 h1CQ== X-Gm-Gg: AeBDievpivStP5ezW/69upR9dGLxkF298yaiYYTDypsdZeYaHEdJQGJXEq1BIBFjDxH cJokHMIrxfeF+VpkTvp8p1YJ8Sf0vWrPKG6nXBTEf6pswbldCD8tBAnrwwrl64xx50BUiv9u9yP E3yTMmXo4+QN/hd21moXx6+3VlJm7B2uXZttw10AqYcvHapzqZqCriuwj84EEg49AS8sxpyVDGd w4PEHEb+9mGjAT5PVTleWCXuDTPo3Lsy3oPyxWPXNCGQ0Qg+yrJg/9T5OXydlUFcsTJz8qQ3Fcf mJs1oxgFK0EM9ZCWMP+NEnNKueOHRp6hCJsvSNBQGZzQwvIOJL1zVUEROskCTRD57NIYYRn8KHu ZRlS1Xx4G64pWICqisxbesjH17zDq/mSH283SYRhwdPvSQrUXmDyqiPuh X-Received: by 2002:a05:6a00:3924:b0:82c:77cd:50e8 with SMTP id d2e1a72fcca58-82f0c30f593mr23470689b3a.27.1776309999753; Wed, 15 Apr 2026 20:26:39 -0700 (PDT) X-Received: by 2002:a05:6a00:3924:b0:82c:77cd:50e8 with SMTP id d2e1a72fcca58-82f0c30f593mr23470629b3a.27.1776309999089; Wed, 15 Apr 2026 20:26:39 -0700 (PDT) Received: from [10.219.57.109] ([202.46.23.19]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-82f6707b6b8sm4265094b3a.22.2026.04.15.20.26.29 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 15 Apr 2026 20:26:38 -0700 (PDT) Message-ID: <555b2695-1feb-482b-aec2-d6f3f2b2ef0e@oss.qualcomm.com> Date: Thu, 16 Apr 2026 08:56:24 +0530 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v13 3/3] of: Respect #{iommu,msi}-cells in maps To: Nipun Gupta , Nikhil Agarwal , Joerg Roedel , Will Deacon , Robin Murphy , Marc Zyngier , Lorenzo Pieralisi , Thomas Gleixner , Saravana Kannan , Richard Zhu , Lucas Stach , =?UTF-8?Q?Krzysztof_Wilczy=C5=84ski?= , Manivannan Sadhasivam , Bjorn Helgaas , Frank Li , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Juergen Gross , Stefano Stabellini , Oleksandr Tyshchenko , Dmitry Baryshkov , Konrad Dybcio , Bjorn Andersson , Rob Herring , Conor Dooley , Krzysztof Kozlowski , Prakash Gupta , Vikash Garodia Cc: linux-kernel@vger.kernel.org, iommu@lists.linux.dev, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-pci@vger.kernel.org, imx@lists.linux.dev, xen-devel@lists.xenproject.org, linux-arm-msm@vger.kernel.org, Charan Teja Kalla References: <20260408-parse_iommu_cells-v13-0-fa921e92661b@oss.qualcomm.com> <20260408-parse_iommu_cells-v13-3-fa921e92661b@oss.qualcomm.com> Content-Language: en-US From: Vijayanand Jitta In-Reply-To: <20260408-parse_iommu_cells-v13-3-fa921e92661b@oss.qualcomm.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Authority-Analysis: v=2.4 cv=Gc8nWwXL c=1 sm=1 tr=0 ts=69e056f0 cx=c_pps a=Qgeoaf8Lrialg5Z894R3/Q==:117 a=j4ogTh8yFefVWWEFDRgCtg==:17 a=IkcTkHD0fZMA:10 a=A5OVakUREuEA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=Um2Pa8k9VHT-vaBCBUpS:22 a=7CQSdrXTAAAA:8 a=EUspDBNiAAAA:8 a=OsyBWCJeBE2wmg0BnjgA:9 a=QEXdDO2ut3YA:10 a=x9snwWr2DeNwDh03kgHS:22 a=a-qgeE7W1pNrGK8U0ZQC:22 X-Proofpoint-GUID: LMTIgzeom6fG6MRbknybbe8XcPR2SqHP X-Proofpoint-ORIG-GUID: LMTIgzeom6fG6MRbknybbe8XcPR2SqHP X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNDE2MDAyOSBTYWx0ZWRfXzEOqJmGCsEB5 qgW0Dsb6+vzcyd3QYB55f3nxvTNV+0OIbUzhP2/1pvhsg58qBRSYToJ8k49fCpfRmPUeA35eaDh kO/c7tsIFbCouIVsI52QOzhHctEav4TAhbVxM1CKtvRBSGDvxbAlMsBIDquhSkzRf4cD1HAOuvF ZjzdkFMongbzWV+IvOKzqahrYq0/vxdvR5yvktU5/K/8EjGJtystYNqWYVGw+ScCjqEf5MUlJ7H /s6hQCCCFewi2U/hXRgZNKh2YclO2wNZL13BbD4RdLUxgNAcB1H5e4z2j655NfBusnsNlp/Dfxc NRnGyAz0GvY/9jt0lOmBaq9u+LvdX4YD9rWMrxiqFp5sN+/mAv9H2/fgPMvnaag2AoQ+Y9wzaVY xE35zPyCeeCNBbL0ZFrzzf++OA09dEax7247LVzx0/QA8fAB/u+k5YndMahBet8o8zegBwAuN3K nZ4CXOFsIULrmv/pU1g== X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49 definitions=2026-04-16_01,2026-04-13_04,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 phishscore=0 adultscore=0 malwarescore=0 bulkscore=0 clxscore=1015 suspectscore=0 lowpriorityscore=0 priorityscore=1501 impostorscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2604070000 definitions=main-2604160029 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20260415_202641_709711_5131ACED X-CRM114-Status: GOOD ( 42.44 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org On 4/8/2026 3:33 PM, Vijayanand Jitta wrote: > From: Robin Murphy > > So far our parsing of {iommu,msi}-map properties has always blindly > assumed that the output specifiers will always have exactly 1 cell. > This typically does happen to be the case, but is not actually enforced > (and the PCI msi-map binding even explicitly states support for 0 or 1 > cells) - as a result we've now ended up with dodgy DTs out in the field > which depend on this behaviour to map a 1-cell specifier for a 2-cell > provider, despite that being bogus per the bindings themselves. > > Since there is some potential use in being able to map at least single > input IDs to multi-cell output specifiers (and properly support 0-cell > outputs as well), add support for properly parsing and using the target > nodes' #cells values, albeit with the unfortunate complication of still > having to work around expectations of the old behaviour too. > > Since there are multi-cell output specifiers, the callers of of_map_id() > may need to get the exact cell output value for further processing. > Update of_map_id() to set args_count in the output to reflect the actual > number of output specifier cells. > > Signed-off-by: Robin Murphy > Signed-off-by: Charan Teja Kalla > Signed-off-by: Vijayanand Jitta > --- > drivers/of/base.c | 157 +++++++++++++++++++++++++++++++++++++++++------------ > include/linux/of.h | 6 +- > 2 files changed, 125 insertions(+), 38 deletions(-) > > diff --git a/drivers/of/base.c b/drivers/of/base.c > index b3d002015192..2554e4f1a181 100644 > --- a/drivers/of/base.c > +++ b/drivers/of/base.c > @@ -2096,18 +2096,48 @@ int of_find_last_cache_level(unsigned int cpu) > return cache_level; > } > > +/* > + * Some DTs have an iommu-map targeting a 2-cell IOMMU node while > + * specifying only 1 cell. Fortunately they all consist of value '1' > + * as the 2nd cell entry with the same target, so check for that pattern. > + * > + * Example: > + * IOMMU node: > + * #iommu-cells = <2>; > + * > + * Device node: > + * iommu-map = <0x0000 &smmu 0x0000 0x1>, > + * <0x0100 &smmu 0x0100 0x1>; > + */ > +static bool of_check_bad_map(const __be32 *map, int len) > +{ > + __be32 phandle = map[1]; > + > + if (len % 4) > + return false; > + for (int i = 0; i < len; i += 4) { > + if (map[i + 1] != phandle || map[i + 3] != cpu_to_be32(1)) > + return false; > + } > + return true; > +} > + > /** > * of_map_id - Translate an ID through a downstream mapping. > * @np: root complex device node. > * @id: device ID to map. > * @map_name: property name of the map to use. > + * @cells_name: property name of target specifier cells. > * @map_mask_name: optional property name of the mask to use. > * @filter_np: optional device node to filter matches by, or NULL to match any. > * If non-NULL, only map entries targeting this node will be matched. > * @arg: pointer to a &struct of_phandle_args for the result. On success, > - * @arg->args[0] will contain the translated ID. If a map entry was > - * matched, @arg->np will be set to the target node with a reference > - * held that the caller must release with of_node_put(). > + * @arg->args_count will be set to the number of output specifier cells > + * as defined by @cells_name in the target node, and > + * @arg->args[0..args_count-1] will contain the translated output > + * specifier values. If a map entry was matched, @arg->np will be set > + * to the target node with a reference held that the caller must release > + * with of_node_put(). > * > * Given a device ID, look up the appropriate implementation-defined > * platform ID and/or the target device which receives transactions on that > @@ -2116,17 +2146,19 @@ int of_find_last_cache_level(unsigned int cpu) > * Return: 0 on success or a standard error code on failure. > */ > int of_map_id(const struct device_node *np, u32 id, > - const char *map_name, const char *map_mask_name, > + const char *map_name, const char *cells_name, > + const char *map_mask_name, > const struct device_node *filter_np, struct of_phandle_args *arg) > { > u32 map_mask, masked_id; > - int map_len; > + int map_bytes, map_len, offset = 0; > + bool bad_map = false; > const __be32 *map = NULL; > > if (!np || !map_name || !arg) > return -EINVAL; > > - map = of_get_property(np, map_name, &map_len); > + map = of_get_property(np, map_name, &map_bytes); > if (!map) { > if (filter_np) > return -ENODEV; > @@ -2136,11 +2168,9 @@ int of_map_id(const struct device_node *np, u32 id, > return 0; > } > > - if (!map_len || map_len % (4 * sizeof(*map))) { > - pr_err("%pOF: Error: Bad %s length: %d\n", np, > - map_name, map_len); > - return -EINVAL; > - } > + if (map_bytes % sizeof(*map)) > + goto err_map_len; > + map_len = map_bytes / sizeof(*map); > > /* The default is to select all bits. */ > map_mask = 0xffffffff; > @@ -2153,39 +2183,84 @@ int of_map_id(const struct device_node *np, u32 id, > of_property_read_u32(np, map_mask_name, &map_mask); > > masked_id = map_mask & id; > - for ( ; map_len > 0; map_len -= 4 * sizeof(*map), map += 4) { > + > + while (offset < map_len) { > struct device_node *phandle_node; > - u32 id_base = be32_to_cpup(map + 0); > - u32 phandle = be32_to_cpup(map + 1); > - u32 out_base = be32_to_cpup(map + 2); > - u32 id_len = be32_to_cpup(map + 3); > + u32 id_base, phandle, id_len, id_off, cells = 0; > + const __be32 *out_base; > + > + if (map_len - offset < 2) > + goto err_map_len; > + > + id_base = be32_to_cpup(map + offset); > > if (id_base & ~map_mask) { > - pr_err("%pOF: Invalid %s translation - %s-mask (0x%x) ignores id-base (0x%x)\n", > - np, map_name, map_name, > - map_mask, id_base); > + pr_err("%pOF: Invalid %s translation - %s (0x%x) ignores id-base (0x%x)\n", > + np, map_name, map_mask_name, map_mask, id_base); > return -EFAULT; > } > > - if (masked_id < id_base || masked_id >= id_base + id_len) > - continue; > - > + phandle = be32_to_cpup(map + offset + 1); > phandle_node = of_find_node_by_phandle(phandle); > if (!phandle_node) > return -ENODEV; > > + if (bad_map) { > + cells = 1; > + } else if (of_property_read_u32(phandle_node, cells_name, &cells)) { > + pr_err("%pOF: missing %s property\n", phandle_node, cells_name); > + of_node_put(phandle_node); > + return -EINVAL; > + } > + > + if (map_len - offset < 3 + cells) { > + of_node_put(phandle_node); > + goto err_map_len; > + } > + > + if (offset == 0 && cells == 2) { > + bad_map = of_check_bad_map(map, map_len); > + if (bad_map) { > + pr_warn_once("%pOF: %s mismatches target %s, assuming extra cell of 0\n", > + np, map_name, cells_name); > + cells = 1; > + } > + } > + > + out_base = map + offset + 2; > + offset += 3 + cells; > + > + id_len = be32_to_cpup(map + offset - 1); > + if (id_len > 1 && cells > 1) { > + /* > + * With 1 output cell we reasonably assume its value > + * has a linear relationship to the input; with more, > + * we'd need help from the provider to know what to do. > + */ > + pr_err("%pOF: Unsupported %s - cannot handle %d-ID range with %d-cell output specifier\n", > + np, map_name, id_len, cells); > + of_node_put(phandle_node); > + return -EINVAL; > + } > + id_off = masked_id - id_base; > + if (masked_id < id_base || id_off >= id_len) { > + of_node_put(phandle_node); > + continue; > + } > + > if (filter_np && filter_np != phandle_node) { > of_node_put(phandle_node); > continue; > } > > arg->np = phandle_node; > - arg->args[0] = masked_id - id_base + out_base; > - arg->args_count = 1; > + for (int i = 0; i < cells; i++) > + arg->args[i] = id_off + be32_to_cpu(out_base[i]); > + arg->args_count = cells; > > pr_debug("%pOF: %s, using mask %08x, id-base: %08x, out-base: %08x, length: %08x, id: %08x -> %08x\n", > - np, map_name, map_mask, id_base, out_base, > - id_len, id, masked_id - id_base + out_base); > + np, map_name, map_mask, id_base, be32_to_cpup(out_base), > + id_len, id, id_off + be32_to_cpup(out_base)); > return 0; > } > > @@ -2196,6 +2271,10 @@ int of_map_id(const struct device_node *np, u32 id, > arg->args[0] = id; > arg->args_count = 1; > return 0; > + > +err_map_len: > + pr_err("%pOF: Error: Bad %s length: %d\n", np, map_name, map_bytes); > + return -EINVAL; > } > EXPORT_SYMBOL_GPL(of_map_id); > > @@ -2205,18 +2284,21 @@ EXPORT_SYMBOL_GPL(of_map_id); > * @id: Requester ID of the device (e.g. PCI RID/BDF or a platform > * stream/device ID) used as the lookup key in the iommu-map table. > * @arg: pointer to a &struct of_phandle_args for the result. On success, > - * @arg->args[0] contains the translated ID. If a map entry was matched, > - * @arg->np holds a reference to the target node that the caller must > - * release with of_node_put(). > + * @arg->args_count will be set to the number of output specifier cells > + * and @arg->args[0..args_count-1] will contain the translated output > + * specifier values. If a map entry was matched, @arg->np holds a > + * reference to the target node that the caller must release with > + * of_node_put(). > * > - * Convenience wrapper around of_map_id() using "iommu-map" and "iommu-map-mask". > + * Convenience wrapper around of_map_id() using "iommu-map", "#iommu-cells", > + * and "iommu-map-mask". > * > * Return: 0 on success or a standard error code on failure. > */ > int of_map_iommu_id(const struct device_node *np, u32 id, > struct of_phandle_args *arg) > { > - return of_map_id(np, id, "iommu-map", "iommu-map-mask", NULL, arg); > + return of_map_id(np, id, "iommu-map", "#iommu-cells", "iommu-map-mask", NULL, arg); > } > EXPORT_SYMBOL_GPL(of_map_iommu_id); > > @@ -2229,17 +2311,20 @@ EXPORT_SYMBOL_GPL(of_map_iommu_id); > * to match any. If non-NULL, only map entries targeting this node will > * be matched. > * @arg: pointer to a &struct of_phandle_args for the result. On success, > - * @arg->args[0] contains the translated ID. If a map entry was matched, > - * @arg->np holds a reference to the target node that the caller must > - * release with of_node_put(). > + * @arg->args_count will be set to the number of output specifier cells > + * and @arg->args[0..args_count-1] will contain the translated output > + * specifier values. If a map entry was matched, @arg->np holds a > + * reference to the target node that the caller must release with > + * of_node_put(). > * > - * Convenience wrapper around of_map_id() using "msi-map" and "msi-map-mask". > + * Convenience wrapper around of_map_id() using "msi-map", "#msi-cells", > + * and "msi-map-mask". > * > * Return: 0 on success or a standard error code on failure. > */ > int of_map_msi_id(const struct device_node *np, u32 id, > const struct device_node *filter_np, struct of_phandle_args *arg) > { > - return of_map_id(np, id, "msi-map", "msi-map-mask", filter_np, arg); > + return of_map_id(np, id, "msi-map", "#msi-cells", "msi-map-mask", filter_np, arg); > } > EXPORT_SYMBOL_GPL(of_map_msi_id); > diff --git a/include/linux/of.h b/include/linux/of.h > index 8548cd9eb4f1..51ac8539f2c3 100644 > --- a/include/linux/of.h > +++ b/include/linux/of.h > @@ -462,7 +462,8 @@ const char *of_prop_next_string(const struct property *prop, const char *cur); > bool of_console_check(const struct device_node *dn, char *name, int index); > > int of_map_id(const struct device_node *np, u32 id, > - const char *map_name, const char *map_mask_name, > + const char *map_name, const char *cells_name, > + const char *map_mask_name, > const struct device_node *filter_np, struct of_phandle_args *arg); > > int of_map_iommu_id(const struct device_node *np, u32 id, > @@ -934,7 +935,8 @@ static inline void of_property_clear_flag(struct property *p, unsigned long flag > } > > static inline int of_map_id(const struct device_node *np, u32 id, > - const char *map_name, const char *map_mask_name, > + const char *map_name, const char *cells_name, > + const char *map_mask_name, > const struct device_node *filter_np, > struct of_phandle_args *arg) > { > Gentle ping. Thanks, Vijay