Re: [PATCH v2 2/2] man/man?/landlock*.?: Document UDP support

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 1643 bytes --]

Hi Günther, Matthieu,

> Date: 2026-11-06 23:02:40+0100
> From: Günther Noack <gnoack3000@gmail.com>
>
[...]
> > @@ -120,8 +120,13 @@ with
> >  A Landlock rule with port 0
> >  and the
> >  .B LANDLOCK_ACCESS_NET_BIND_TCP
> > -right means that requesting to bind on port 0 is allowed
> > -and it will automatically translate to binding on the related port range.
> > +or
> > +.B LANDLOCK_ACCESS_NET_BIND_UDP
> > +right means that requesting to bind on port 0
> > +(explicitly, or implicitly
> > +for instance by sending a datagram on an unbound UDP socket)
> > +is allowed
> > +and it will automatically translate to binding on a kernel-assigned ephemeral port.
> 
> With the caveat of not being a native speaker either, the commas in
> this sentence feel wrong to me.
> 
> Suggestion:
> 
>   A Landlock rule with port 0 and the LANDLOCK_ACCESS_NET_BIND_TCP or
> 
>   LANDLOCK_ACCESS_NET_BIND_UDP right means that requesting to bind to
>                                                                    ^^
>   port 0 (explicitly or implicitly, for instance, by sending a datagram
>                    ^^^           ^^^           ^^^
>   on an unbound socket) is allowed, and it will automatically
>                                  ^^^
>   translate to binding on a kernel-assigned ephemeral port.
> 
> 
> (You might also use the shorter "e.g.," instead of "for instance,".)
> I'm happy to stand corrected, Alejandro has a better grip on correct
> grammar than me. :)

Not a native speaker either, but I agree with Günther.


Have a lovely day!
Alex

-- 
<https://www.alejandro-colomar.es>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]