linux-kernel - Re: [PATCH 2/2] docs: can: update SocketCAN documentation for CAN XL

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20260112175049.10716-1-rakuram.e96@gmail.com>
Date: Mon, 12 Jan 2026 23:20:49 +0530
From: Rakuram Eswaran <rakuram.e96@...il.com>
To: socketcan@...tkopp.net,
	rakuram.e96@...il.com
Cc: corbet@....net,
	davem@...emloft.net,
	edumazet@...gle.com,
	horms@...nel.org,
	kuba@...nel.org,
	linux-can@...r.kernel.org,
	linux-doc@...r.kernel.org,
	linux-kernel@...r.kernel.org,
	mailhol@...nel.org,
	mkl@...gutronix.de,
	netdev@...r.kernel.org,
	pabeni@...hat.com
Subject: Re: [PATCH 2/2] docs: can: update SocketCAN documentation for CAN XL

On Wed, 31 Dec 2025 at 23:47, Rakuram Eswaran <rakuram.e96@...il.com> wrote:
>
> Extend the SocketCAN documentation to cover CAN XL support, including
> the updated frame layout, MTU definitions, mixed-mode operation, and
> bitrate/XBTR configuration. The new text also explains how error
> signalling behaviour differs between CAN FD, CAN XL mixed-mode, and
> CAN-XL-only operation, as implemented in the current kernel stack.
>
> In addition, provide example iproute2 "ip" tool commands demonstrating
> how to configure CAN XL interfaces and corresponding bittiming
> attributes.
>
> These updates align the documentation with the behaviour of recent
> CAN XL implementations and help users and developers set up correct
> test environments.
>
> Signed-off-by: Rakuram Eswaran <rakuram.e96@...il.com>
> ---
> Tested the documentation build with Sphinx; no errors or warnings.
>
> Used below command for testing:
>      make htmldocs SPHINX_WARNINGS_LOG=warnings.log
>
>  Documentation/networking/can.rst | 615 +++++++++++++++++++++++++++++++++------
>  1 file changed, 518 insertions(+), 97 deletions(-)
>

Hello Oliver,

Any feedback on this documentation update patch before sending v2?

Best Regards,
Rakuram