From nobody Sat Jul 25 01:40:44 2026 Received: from mx0a-0031df01.pphosted.com (mx0a-0031df01.pphosted.com [205.220.168.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 63E6B394788 for ; Tue, 21 Jul 2026 06:09:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.168.131 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784614167; cv=none; b=reAfqVT9nIrxXdYGPzNYt/mns8APlsjJwRPeXI1kQkM+PHf3cqvlzg1zp5E1mFTSU6Yc50DoXp1YfQ935mdJdZ1Mt/CzdpB8wJV+dkeloLwdA/D7GgM3cJV48v9ZSqiSxdZ4L7hGnTpI8g3a/cfJ3DaVZCGAtp/Zlf4WjTgqJHk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784614167; c=relaxed/simple; bh=McUMQGIZDBMY3HDgi/4pLbhIy41U5MUFfJns5COLfWM=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type; b=mn0u0OdWwWvwQQItR97hfgO6qeSTtoiRTzMN5dj7soYEMHTTd6pKEhfF+o2zOwhAbtC6+2rVZ9t103pHRb/LuDvJBG2AvmYIgAHpYSnhOG83M0ldK5h5gHauFACV2WQVhyuLRXhjmjG/75s1SriA4fs8ZfuEur2qs6ihJ71J82I= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=S/lmI9Lj; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=Lq+nfuBA; arc=none smtp.client-ip=205.220.168.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="S/lmI9Lj"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="Lq+nfuBA" Received: from pps.filterd (m0279867.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 66KNCWgb933315 for ; Tue, 21 Jul 2026 06:09:25 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:message-id :mime-version:subject:to; s=qcppdkim1; bh=eQDiN+oK7/btljQ9huRs0D TiPt9j6OWdrHFpRdeVSSU=; b=S/lmI9LjEDbRkxFYJFeVwFgEUKj1YJwKahsyXQ XaxJ2Y5rvgIQbMiVfhnvsHL2oKYHKDxnMQnYCcUf+fWAl3/MEZBhIaobkhnQ/9er Z/RyXyIVX3jfcouhAFXV/pJhOIlJWoCO2BcYXNFyCnEuBGZ8fceP5x3iL7NawBmI nkm3u7JjuVN6QUMyQ+/DuFpROsyfi1zNlyX7W/Qt09qwcm0rYNpOnmkGHRltBlGG HGgHdUfChPbZYTwQrnbZvacnwcli+b8vysQm0L8npBcW8PW5IRhB1Eeu2Ed1XfQm 79OhRFKOi60OHRGsydNE8uVRAwa9J5rVGyyMjY7qEjXR9pSw== Received: from mail-qt1-f199.google.com (mail-qt1-f199.google.com [209.85.160.199]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4fhqv5tm4n-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 21 Jul 2026 06:09:25 +0000 (GMT) Received: by mail-qt1-f199.google.com with SMTP id d75a77b69052e-51c21c01cf3so167517721cf.2 for ; Mon, 20 Jul 2026 23:09:25 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1784614164; x=1785218964; darn=vger.kernel.org; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to :content-type; bh=eQDiN+oK7/btljQ9huRs0DTiPt9j6OWdrHFpRdeVSSU=; b=Lq+nfuBAwC4L7UdQWz6JHMT1OgzucUGWkLW176G2if84Al99CsvMM/A8BIDlT8OFdI 6JbUc64AWfaGqo5o1CclmvtfuxYzxV8qxzgyA2Bq1ZOpqWA5M/Hv4xzbSQJwmS9xYTgE W6+JIrWkq+eaYmnesTHHM+hOHAJqJTF944Lb6geG+/E1acLryiOezZX2ax5/EjFJIZ+k TXNP/hdwUc3V+XH24rO08UVLCkrxyg58CrdNUJX8TO7jYazYVQIzpQbua5CEVHUKX0Pn o1cD5yqQHdsQHxpfewlSphy36NNs3zYGwylJMpPNKkQcRLfqXy5pbS+1wzL7pmAN0BZx nEyw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1784614164; x=1785218964; h=content-transfer-encoding:content-type:mime-version:message-id:date :subject:cc:to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject :date:message-id:reply-to:content-type; bh=eQDiN+oK7/btljQ9huRs0DTiPt9j6OWdrHFpRdeVSSU=; b=eRGp1YxFTR+NfdkXcJxtYpcuVTWrtag/adYvF57ALuqvRq8662yIkxEdHkbSaBZeHa xY9KIgkTqP6T/czv10Zc/mdVfV039tXIEjz7fDNYj4TXkjvbgZ99JDrhjrEhZ9Q4JYmm KGGs7ejAgUgHk9r/TAwzqg+0/OOyn4cQJIdoI9onU98vkRw+9NW7Ijz3J6MAr5Kfzfuu 47ACJA5XCyYaGCxc7SbGKKqBrY/nS4iS3DmlRZ5nh0cSO/9wgWnnxKDKMc0F7G3kmJ0Q r5znF2dzimMnLQJ5Nzcrv/rerRGxmENPhH4k0OgrhP2QrSF6kgnuya5rrMuQZ1yXNOPR Bo+w== X-Forwarded-Encrypted: i=1; AHgh+RoB4AMwbNXA6MfBGAXoTaE1eodMKKt2u5W6EVPqHpxbJ3gaHDWwwZMqIX3ZSgoaZfb/MgwSxum2wU+Ka6g=@vger.kernel.org X-Gm-Message-State: AOJu0YxBKD6D8JReBcnNZD1HaZ6Ng0xvYkxaGmRxNk4LOE6dcBxa1gBo CpKkPgeZBXBswG9SV+58zvHEMNRmxDXrLTX7CgH1mODkzgyoalHiI3cKN3SzZ3GJMgfRzFsfnM5 A2hfbkqetC1lUXViwaWnY71f1xIoAhH4PyrIxkM6Q39GbaNKjZqBHreM09y6tWS2wuNI= X-Gm-Gg: AfdE7cmOElOlAnl1uUVcaV1xOVrEnrB55eeQs+jYjRBUNbuinQCYqClYQxWVxIkZOug kRZ9oTrJBySWw7MxqB0zNfgdIe/NpNMHa64mMXdnYzoCmahMsg+bKXjmGt9jx+g8gXVNq70jC2r J11aYEG2lZv4/gwZPa1V5fcbLWYjPrx4soBBM0cFqgfeUUkc2OZUhSK2yV6KI6IfZzd1cOfRG4x knNS1mYRGllNxObO4AsP1rrfb+ITPebT9mevHzPMi6jKjOJs+ZIyp4x4pKR80JofF/edGrkGQK3 6V4TYwI/DUWQ7hhS9ci8IquWdu2RzB4vurUYPwjH+524vB+/73LwbbqugEFcfyaFvYHt4+35RYP HRy0dAzni1OxT/xLC X-Received: by 2002:a05:622a:e152:20b0:521:8ef0:b4e1 with SMTP id d75a77b69052e-5218ef0b685mr103432071cf.29.1784614164414; Mon, 20 Jul 2026 23:09:24 -0700 (PDT) X-Received: by 2002:a05:622a:e152:20b0:521:8ef0:b4e1 with SMTP id d75a77b69052e-5218ef0b685mr103431881cf.29.1784614163863; Mon, 20 Jul 2026 23:09:23 -0700 (PDT) Received: from quoll ([178.197.223.174]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-49548e0fcdbsm288414315e9.2.2026.07.20.23.09.21 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 20 Jul 2026 23:09:22 -0700 (PDT) From: Krzysztof Kozlowski To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , Jonathan Corbet , Shuah Khan , devicetree@vger.kernel.org, workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Krzysztof Kozlowski , Saravana Kannan , Frank Li Subject: [PATCH v4] docs: dt: maintainer: Add Devicetree and OF maintainer profile document Date: Tue, 21 Jul 2026 08:09:16 +0200 Message-ID: <20260721060916.12465-2-krzysztof.kozlowski@oss.qualcomm.com> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=5396; i=krzysztof.kozlowski@oss.qualcomm.com; h=from:subject; bh=McUMQGIZDBMY3HDgi/4pLbhIy41U5MUFfJns5COLfWM=; b=owEBbQKS/ZANAwAKAcE3ZuaGi4PXAcsmYgBqXw0MSva036b3XierNfJ7QJo7u91qaDKcFJVTa t12vPhORjeJAjMEAAEKAB0WIQTd0mIoPREbIztuuKjBN2bmhouD1wUCal8NDAAKCRDBN2bmhouD 11n7D/9C+t77cVBPRHCQnVFB0NMzSMMC+db1ewD0DYHsEBR5qpU0mNX/gojv0AklFDlH+GWsPBy xiWTyZ7nfKexaOg6Pb0d89/kGGeQQD53cQ0kFylHw87+Tudf9ikZ47UmGXoBW/ldTHw6LgqqG8I a/XhgmbcZnU8Fm6HWogyGID7D+zdl6Jx1lqlieGBApCn+zLSt8coNJJH7+g53Zt0bFi5lsmp3JM uC7CtFazx6oDpuj/3A6aZSZ8yHlazbDaeSyERKVRMzliAciWgBc8Y4ubxe0Mod8cpsms3RACaJD vGedNcEeht7VfiDPoL+Y4drG3qRpW+VhHrYqXfSDvq47xoKZtkdpMXp6oiwDcHuEHKoOVRPvx4k IaOsXtjq5CvOVfAnnduaLcgaJb3vbSbb/k0u4obRRFbNPYmnluCe1Qp8F6KyxhxosCdQJw4tos8 0XX7/Ltc/jNLcrO3FLBH2wVjnOKiJdyY2DhPfOFr2KdOk0njo2tb5juxAz3gtZETbPNpoH/0aYN 6s8FftwwF8cvO8d/pQDUjcSK5AkBYlsnyfaSATqPvb+5+mBVgTKzplMQerH66nhicMCt6ZqJ7JI 93eXkb2/09C3HKwAJ7eAL9w5cDmtVxKq+G5Y4jDBqnVYGf+z+rwtCBUtgd5lV5VMiaCV7Js0yV9 64uyxHQn4aQjAiA== X-Developer-Key: i=krzysztof.kozlowski@oss.qualcomm.com; a=openpgp; fpr=9BD07E0E0C51F8D59677B7541B93437D3B41629B Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-Proofpoint-GUID: aDEygBBIECXGYaqLLnRf_PFWyZOy-tIB X-Proofpoint-ORIG-GUID: aDEygBBIECXGYaqLLnRf_PFWyZOy-tIB X-Authority-Analysis: v=2.4 cv=e+U2j6p/ c=1 sm=1 tr=0 ts=6a5f0d15 cx=c_pps a=WeENfcodrlLV9YRTxbY/uA==:117 a=N6niishs+lR9UBL1FN3Qrw==:17 a=IkcTkHD0fZMA:10 a=RAioF0-LDSMA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=eoimf2acIAo5FJnRuUoq:22 a=VwQbUJbxAAAA:8 a=gEfo2CItAAAA:8 a=8AirrxEcAAAA:8 a=EUspDBNiAAAA:8 a=sLr6tAuWVrO0SpXXj6sA:9 a=3ZKOabzyN94A:10 a=QEXdDO2ut3YA:10 a=kacYvNCVWA4VmyqE58fU:22 a=sptkURWiP4Gy88Gu7hUp:22 a=ST-jHhOKWsTCqRlWije3:22 X-Proofpoint-Spam-Info: AW1haW4tMjYwNzIxMDA2MiBTYWx0ZWRfXz44qjE/eBSUU uXMoGdadSMswAUbOzBj5ddpsIJYp6OhHxtuMUpQFKU3p6Yfc9C8b0kYQhiXnSWHKSe6qQhSnO7v bdtn9I6RHx30Lc+fA4/3exS/g7KETC4= X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNzIxMDA2MiBTYWx0ZWRfX/XTgktlZHcP3 ZnPyQPATQ9qzPwZF1c900ztn6TdGL944oBKuxyqIPHDC1R7MeX4RKB58vh6Arur55Q0GzJTQnyi ICoe9RXtmsGtQY/zrlWca2foZzxqrxnkSdU9cNt1B0GOD3/mzht+YUI28L6ZvQMTu9clQ1gp6gY 8gvlf/UStXpayXvDLOIu6+I9wKlAmgIYgRidQbbdndhejg/1H5ysnM6FALTEVXniDMRWVwbW7mW BYE3lq6bmA8SrDUvh/5FBhWLlPr5iQDT1WvBe90B4F09uPU3HxMwkTkhCrO3h+zuv4QNMttZ1l6 3pLQtaoIAqgX1wRw6uk0bwkSrl3HUC4g0XeUCm/Wch3AdSndDJXI107u6fcjAluNQIEGllxPqUG t9e5Z1QYosslDqpZyNjrEtWJR4Z3iLUnb2RXyD8abgWQ/tNfxA+Se8j4T+YYSHt7ZwEn8Ih2Gth qv/30/X2QLXEDqACXJQ== X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-07-20_06,2026-07-20_03,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=0 bulkscore=0 priorityscore=1501 adultscore=0 lowpriorityscore=0 impostorscore=0 phishscore=0 clxscore=1015 malwarescore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2607210062 Document how Devicetree and Open Firmware maintainers handle their subsystem, especially focusing on two caveats: Devicetree subsystem handles patches with a minor difference comparing to other subsystems: while DT maintainers pick up OF code, they only provide review of DT bindings without applying these. All three DT bindings maintainers rely currently on Patchwork and due to enormous amount of emails per day, regardless how much DT maintainers try, they cannot read all the emails. Cc: Rob Herring Cc: Conor Dooley Cc: Saravana Kannan Cc: devicetree@vger.kernel.org Reviewed-by: Frank Li Signed-off-by: Krzysztof Kozlowski --- I expect patch to be picked up by Rob, after review. Changes in v4: 1. Add Rb 2. Reword as Rob requested, add DTS passing dtbs_check Changes in v3: 1. Add also F: entry Changes in v2: 1. Correct typos and trailing white spaces. 2. Fix order of P: after C: in maintainers. --- .../process/maintainer-devicetree.rst | 72 +++++++++++++++++++ MAINTAINERS | 3 + 2 files changed, 75 insertions(+) create mode 100644 Documentation/process/maintainer-devicetree.rst diff --git a/Documentation/process/maintainer-devicetree.rst b/Documentatio= n/process/maintainer-devicetree.rst new file mode 100644 index 000000000000..ecc3ed638725 --- /dev/null +++ b/Documentation/process/maintainer-devicetree.rst @@ -0,0 +1,72 @@ +.. SPDX-License-Identifier: GPL-2.0 + +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +Devicetree and Open Firmware Subsystem +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Other Process Documents +----------------------- + +Please see the documents in Documentation/devicetree/bindings/ for informa= tion +on how to write proper Devicetree bindings and how to submit patches. + +Patch Review and Handling +------------------------- + +Patches handled by Devicetree maintainers are processed differently depend= ing +on the patch type: + +1. Core OF driver code, e.g. drivers/of/: + patches are reviewed and applied by DT maintainers. + +2. Devicetree bindings: + patches are reviewed by DT maintainers, but should be applied by subsys= tem + maintainers except in certain cases. See also *For kernel maintainers*= in + Documentation/devicetree/bindings/submitting-patches.rst. + +3. DTS and drivers: + DT maintainers might provide comments, but review is generally not expe= cted. + DTS must pass schema checks (dtbs_check) or at least do not add any + new warnings. + +Patchwork +~~~~~~~~~ + +Devicetree maintainers review patches using Patchwork, so the current stat= us of +a patch can be checked there. For typical driver submissions, Patchwork +receives the entire patch set, but only a few patches are usually Devicetr= ee +bindings that are reviewed by DT maintainers. + +Explanation of Patchwork statuses: + + - **New**: Not yet processed by the automation toolset. + - **Needs ACK**: Waiting for review by DT maintainers. + - **Handled Elsewhere**: Non-DT patch; not being reviewed here. + - **RFC**: Patch was likely ignored because it was an incomplete RFC. + - **Changes Requested**: Patch was reviewed and DT maintainers expect cha= nges. + - **Accepted**: Patch was reviewed and applied by DT maintainers to their= tree. + - **Not Applicable**: Patch was reviewed and is likely in good shape, wit= h a + *Reviewed-by* or *Acked-by* tag provided, but DT maintainers expect som= eone + else to apply it. + +Patch Re-review and Pinging +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Due to the high volume of email traffic, Devicetree maintainers do not read +every email they receive and instead rely on Patchwork during the review +process. They also often skip patches that have already been reviewed. + +As a result, maintainers might miss: + +1. Questions about already reviewed patches. +2. Pings, for example when a patch has been reviewed by DT maintainers but= has + not been picked up by subsystem maintainers. + +Such cases can be addressed by: + +1. Pinging DT maintainers on the IRC channel. +2. Dropping the DT maintainer=E2=80=99s *Acked-by* or *Reviewed-by* tag wh= en sending a new + version of the patch set, together with an explanation in the patch + changelog describing why the tag was removed and what is expected from = DT + maintainers. + diff --git a/MAINTAINERS b/MAINTAINERS index 0b6b9e6b3900..be6aa5d174c5 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -20285,6 +20285,7 @@ S: Maintained Q: http://patchwork.kernel.org/project/devicetree/list/ W: http://www.devicetree.org/ C: irc://irc.libera.chat/devicetree +P: Documentation/process/maintainer-devicetree.rst T: git git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux.git F: Documentation/ABI/testing/sysfs-firmware-ofw F: drivers/of/ @@ -20306,8 +20307,10 @@ L: devicetree@vger.kernel.org S: Maintained Q: http://patchwork.kernel.org/project/devicetree/list/ C: irc://irc.libera.chat/devicetree +P: Documentation/process/maintainer-devicetree.rst T: git git://git.kernel.org/pub/scm/linux/kernel/git/robh/linux.git F: Documentation/devicetree/ +F: Documentation/process/maintainer-devicetree.rst F: arch/*/boot/dts/ F: include/dt-bindings/ =20 --=20 2.53.0