can: add a note that RECV_OWN_MSGS frames are subject to filtering
authorErik Flodin <erik@flodin.me>
Tue, 20 Apr 2021 19:12:00 +0000 (21:12 +0200)
committerMarc Kleine-Budde <mkl@pengutronix.de>
Sat, 24 Apr 2021 12:36:51 +0000 (14:36 +0200)
commit924e464f4a8a0bb9e011ed37342e7c23c1670dc2
tree312372bbc28a8fd85e7a399aade25b2e788732e5
parent1c9690dd308efd05e7f390c15bc4f26842822bf5
can: add a note that RECV_OWN_MSGS frames are subject to filtering

Some parts of the documentation may lead the reader to think that the
socket's own frames are always received when CAN_RAW_RECV_OWN_MSGS is
enabled, but all frames are subject to filtering.

As explained by Marc Kleine-Budde:

On TX complete of a CAN frame it's pushed into the RX path of the
networking stack, along with the information of the originating socket.

Then the CAN frame is delivered into AF_CAN, where it is passed on to
all registered receivers depending on filters. One receiver is the
sending socket in CAN_RAW. Then in CAN_RAW the it is checked if the
sending socket has RECV_OWN_MSGS enabled.

Link: https://lore.kernel.org/r/20210420191212.42753-1-erik@flodin.me
Signed-off-by: Erik Flodin <erik@flodin.me>
Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de>
Documentation/networking/can.rst