From mboxrd@z Thu Jan 1 00:00:00 1970 Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.remote-ip=91.218.175.195 ARC-Seal: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; cv=none; t=1794466019; b=opdhl11jIFyv/JhCMNp2BmiVU0vT1qwhN7g6f35GeTp2nRCxzwgW3vPR0tYbZJdN9zyh /9hvBGR76l3pluBqx5f9dcovxrWDVIxgqBhcOYLlQoI0pCm89G4xbluEIOUrFKsZyUWDx +PQRloqogm1EZbePRnAyDzT8XbQD0sUv0M2xZMuNzd+pnYQ6bu+r9j4yvQNL3EIPwXHrF YIxa6x2qdEpkxB7yU/BQiqVl/pLIyaZCUAAxbXMWBLgh0bpi28Yp7RCk0xhbMYRG1iztM q1zw3X7WANzE8wO+KSoq9bJDQLNT0jnGV1a90TxsNsGhff8R+i9cPNdrp/sTvqY+Vew== ARC-Message-Signature: i=1; d=subspace.kernel.org; s=arc20261015; a=rsa-sha256; c=relaxed/relaxed; t=1794466019; h=DMARC-Filter:X-Envelope-To:DKIM-Signature:X-Envelope-To:Received: X-Mizu-Trace-ID:X-Migadu-Flow:From:Date:Subject:MIME-Version: Content-Type:Content-Transfer-Encoding:Message-Id:X-B4-Tracking: X-Change-ID:To:Cc:X-Mailer; bh=3s0ba+JhT7e7ZmcJLS7jtsYDj8qHsofUQXzvKGrQOyE=; b=URoCHVTqat1Z0RFtbg3Qk8CnaBtATZs8B/7CxTXLREsh+C5pq6ju0oAVd4yo1vaqv7/0 hUrgYiWyIyoCK7vdpl4l4FZ9AUqKl89qfTGf4ShsORnxMehcmwx6LBIB3nuM+vjnss3Du nxThXNQSvVk/fGbPpY3QPPw8E+zxuokq7uaRS1bmRkx6xE7GoHNH6SdtTWUtJLLNE6MFT wGZf8fbXEpGTRt8U2KtB1TevqTgZbZmHIAdB4ZPrp1XwgHzxCtW7Zsz7bVS+/F7Fpnxdj EKKfnPBBk8U0c8vbDXmexjjE05YGEvXapx43hAVF5bh9fIYHevve3LuE271TA5B+4JQ== ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass header.from=linux.dev; spf=pass smtp.mailfrom=linux.dev; dkim=pass header.d=linux.dev header.i=@linux.dev header.a=rsa-sha256 header.s=key1 header.b=DvZWRoED; arc=none smtp.remote-ip=91.218.175.195 Received: from mta0.migadu.com (out-195.mta0.migadu.com [91.218.175.195]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature ECDSA (prime256v1) server-digest SHA256) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8FEB6606A323 for ; Thu, 12 Nov 2026 06:46:57 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.2 smtp.subspace.kernel.org 8FEB6606A323 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.dev Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.dev Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key, unprotected) header.d=linux.dev header.i=@linux.dev header.a=rsa-sha256 header.s=key1 header.b=DvZWRoED X-Envelope-To: linux-kernel@vger.kernel.org DKIM-Signature: a=rsa-sha256; bh=VCsgURmrph3MxwNfIKjcE580EzEMYSnhLi99FXbiXVc=; c=simple/simple; d=linux.dev; h=from:to:subject:date:message-id:mime-version:content-type; s=key1; t=1794466015; v=1; x=1795070815; b=DvZWRoED8+5nMqfQGwV2+ymgWuRLUn4JcaktO2Y8WK4yiRPtG+rbxH1ERXr5UzLZBnn25rfZ ty/qBlA1aG/TMWrByrWvKJ0HrjeilgkfdUGAyZSdNEgDR1225nptYNrqqhPraf5gL7Emfh7XmIY mXQ3m0sylmy0jn47AxI/eIPA= X-Envelope-To: linux-kernel@vger.kernel.org Received: by mta12.migadu.com with ESMTPS id 32a893e63a772586; Thu, 12 Nov 2026 06:46:55 +0000 X-Mizu-Trace-ID: 32a893e63a772586 X-Migadu-Flow: FLOW_OUT From: Hangbin Liu Date: Thu, 12 Nov 2026 14:46:36 +0800 Subject: [PATCH net-next] netlink: specs: rt-route: move fixed-header to operations list X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20261112-ynl_fixed_header-v1-1-8475ea19e409@kylinos.cn> X-B4-Tracking: v=1; b=H4sIAAAAAAAC/yWMUQrCMBAFr1L220ATrC1eRaSkyUu7IqskUSqld 2+Cn8Mws1FCZCS6NhtFfDnxSwroU0NusTJDsS9MpjUXrbVRP3mOgVf4cYH1iMr43rrgpu4cBir ZO6L6uryRICvBmun+N+kzPeByPdK+H/HJGLV+AAAA X-Change-ID: 20261112-ynl_fixed_header-2d7acfcb54f8 To: David Ahern , Ido Schimmel , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Donald Hunter Cc: Hangbin Liu , Wessel Jacobi , Randy Dunlap , linux-doc@vger.kernel.org, netdev@vger.kernel.org, linux-kernel@vger.kernel.org, Hangbin Liu X-Mailer: b4 0.16.0 From: Hangbin Liu Wessel reported that fixed-header is not shown in the generated HTML page like rt-link.yaml. The doc generator only renders fields on each entry in the operations list, not operations-level keys. Move fixed-header onto each operation so it appears in the HTML. Reported-by: Wessel Jacobi Closes: https://patch.msgid.link/8610ee11-e1dc-481a-9654-11188a06786a@jacobi.pw Signed-off-by: Hangbin Liu --- I'm not very sure whether we should also set `fixed-header` for `newroute-ntf` and `delroute-ntf`, since these notifications are identical to `getroute`. But because `fixed-header` is defined at the operations level, I've added it to all list fields to match the existing behavior. I rebuilt the HTML documentation, and now `fixed-header` shows up correctly. --- Documentation/netlink/specs/rt-route.yaml | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/netlink/specs/rt-route.yaml b/Documentation/netlink/specs/rt-route.yaml index 48d1659f20f3..b5786b465eef 100644 --- a/Documentation/netlink/specs/rt-route.yaml +++ b/Documentation/netlink/specs/rt-route.yaml @@ -708,13 +708,13 @@ attribute-sets: operations: enum-model: directional - fixed-header: rtmsg name-prefix: rtm- list: - name: getroute doc: Dump route information. attribute-set: route-attrs + fixed-header: rtmsg do: request: value: 26 @@ -772,6 +772,7 @@ operations: name: newroute doc: Create a new route attribute-set: route-attrs + fixed-header: rtmsg do: request: value: 24 @@ -808,6 +809,7 @@ operations: name: delroute doc: Delete an existing route attribute-set: route-attrs + fixed-header: rtmsg do: request: value: 25 @@ -815,11 +817,13 @@ operations: - name: newroute-ntf doc: Notification about a created route. + fixed-header: rtmsg value: 24 notify: getroute - name: delroute-ntf doc: Notification about a deleted route. + fixed-header: rtmsg value: 25 notify: getroute --- base-commit: c88fd6989aea9237a60a4859139a265bfb7ddc0b change-id: 20261112-ynl_fixed_header-2d7acfcb54f8 Best regards, -- Hangbin Liu