Thread (17 messages) 17 messages, 4 authors, 2022-09-29

Re: [PATCH net-next 1/6] docs: add more netlink docs (incl. spec docs)

From: Guillaume Nault <hidden>
Date: 2022-09-29 15:11:56
Also in: linux-doc

On Thu, Sep 29, 2022 at 07:32:24AM -0700, Jakub Kicinski wrote:
On Thu, 29 Sep 2022 15:34:13 +0200 Guillaume Nault wrote:
quoted
quoted
+Make sure to pass the request info to genl_notify() to allow ``NLM_F_ECHO``
+to take effect.  
Do you mean that netlink commands should properly handle NLM_F_ECHO,
although they should also design their API so that users don't need it?
Yes, ECHO should be supported but as an extra, not something that
is crucial to write a basic script without assuming full ownership 
of the system...

IOW support the logging use case you mentioned but don't do the NEWLINK
thing.

Should I clarify or rephrase? The ECHO section needs to be read with
the one above it to get the full answer.
Maybe we can make this more explicit.
Something like:

-Having to rely on ``NLM_F_ECHO`` is a hack, not a valid design.
+Users shouldn't have to use ``NLM_F_ECHO`` to get a handle on the created
+object.

(or keep both sentences, I feel they fit well together).

Then maybe explain in the next section why support for NLM_F_ECHO is
desirable anyway:

 Make sure to pass the request info to genl_notify() to allow ``NLM_F_ECHO``
-to take effect.
+to take effect. This is usefull for programs that need precise feedback from
+ the kernel (for example for logging purpose).
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help