Re: [PATCH can-next v2] can: bcm: Document cyclic transmission failures

From: Oliver Hartkopp

Date: Wed Nov 18 2026 - 05:28:56 EST




On 18.11.26 10:19, raoxu wrote:
From: Xu Rao <raoxu@xxxxxxxxxxxxx>

The CAN broadcast manager continues its configured cyclic transmission
schedule even when a CAN frame cannot be passed to the configured
network interface.

Such failures are not reported to user space. The failed transmission
is not retried by the broadcast manager, the timing remains unchanged,
and a non-zero count is decremented.

As a result, a TX_EXPIRED notification requested with TX_COUNTEVT
indicates that the configured transmissions at ival1 have been
processed, not that they were successfully sent.

Document this behavior to prevent applications from treating TX_EXPIRED
as confirmation of successful transmission.

Suggested-by: Oliver Hartkopp <socketcan@xxxxxxxxxxxx>
Signed-off-by: Xu Rao <raoxu@xxxxxxxxxxxxx>

Acked-by: Oliver Hartkopp <socketcan@xxxxxxxxxxxx>

Many thanks,
Oliver

---
Changes in v2:
- Target can-next as requested by Oliver Hartkopp.
- Adopt Oliver's suggested wording describing transmission failures
from the user's perspective.
- Clarify the TX_EXPIRED notification semantics and scope the lack of
retries to the broadcast manager.
- Remove implementation details and redundant descriptions.

This documentation-only update follows the review of v1. The earlier
proposal to change BCM transmission accounting was dropped.

Documentation/networking/can.rst | 8 ++++++++
1 file changed, 8 insertions(+)

diff --git a/Documentation/networking/can.rst b/Documentation/networking/can.rst
index 51bc70748f75..ae47f40bf456 100644
--- a/Documentation/networking/can.rst
+++ b/Documentation/networking/can.rst
@@ -892,6 +892,14 @@ only one timer is needed 'count' is set to zero and only 'ival2' is used.
When SET_TIMER and START_TIMER flag were set the timers are activated.
The timer values can be altered at runtime when only SET_TIMER is set.

+If a CAN frame cannot be passed to the configured CAN network interface
+(e.g. due to a full transmit queue or the interface being down), this
+failure is not reported to user space. The transmission sequence
+continues as configured: the frame is not retried by the broadcast
+manager, the timing remains unchanged, and a non-zero ``count`` is
+decremented anyway. Therefore, a ``TX_EXPIRED`` notification (requested
+with ``TX_COUNTEVT``) only indicates that the ``count`` transmissions
+at ``ival1`` have been processed, not that they were successfully sent.

Broadcast Manager message sequence transmission
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
--
2.50.1