On Tue, Feb 17, 2026 at 07:40:33PM +0200, Hristo Venev wrote:

On Tue, 2026-02-17 at 12:17 +0000, Donald Hunter wrote:

quoted

There are yamllint errors:

make -C tools/net/ynl lint
make: Entering directory '/home/donaldh/net-next/tools/net/ynl'
yamllint ../../../Documentation/netlink/specs
../../../Documentation/netlink/specs/nbd.yaml
  159:81    error    line too long (104 > 80 characters)  (line-
length)
  169:6     error    syntax error: expected <block end>, but found
'<block mapping start>' (syntax)
  170:7     error    wrong indentation: expected 5 but found 6 
(indentation)

Thanks, I will fix the lint errors in v2.

quoted

quoted

+doc: See :file:`drivers/block/nbd.c`

Prefer to see a meaningful doc string here.

I will add more proper documentation in v2. I couldn't find any
existing documentation of this netlink interface, so I guess I will
write it myself.

As luck would have it, before I saw this message, I had been wanting to
work on some of the messages that nbd-client still needed, and so I
asked an LLM to analyze the code and generate some docs for me.

Heed the "LLM" part. It's probably not perfect. But it could be a good
starting point. Or not. At any rate, you can find it here:

https://github.com/NetworkBlockDevice/nbd/blob/master/doc/netlink-proto.md

-- 
"I never had a C in history!"
"Yeah, but there was so much less of it when you were my age!"
 -- Joe Brockmeier recounting a conversation with his father, cfgmgmtcamp 2026, Ghent