Re: [PATCH v3 1/2] landlock.7: Document Landlock ABI v2 (file reparenting; Linux 5.19)

Alejandro Colomar <[email protected]> Fri, 10 Mar 2023 01:31:22 +0100
Newsgroups dev.linux.lists.landlock,org.kernel.vger.linux-man
Message-ID <[email protected]>
This is an OpenPGP/MIME signed message (RFC 4880 and 3156)
--------------tO0LBOzWLMNo2Gh6dKD9IMnt
Content-Type: multipart/mixed; boundary="------------4sGzgClqbjQsLYshcTH93BpN";
 protected-headers="v1"
From: Alejandro Colomar <[email protected]>
To: =?UTF-8?Q?G=c3=bcnther_Noack?= <[email protected]>,
 =?UTF-8?Q?Micka=c3=abl_Sala=c3=bcn?= <[email protected]>
Cc: [email protected], [email protected]
Message-ID: <[email protected]>
Subject: Re: [PATCH v3 1/2] landlock.7: Document Landlock ABI v2 (file
 reparenting; Linux 5.19)
References: <[email protected]>
 <[email protected]>
In-Reply-To: <[email protected]>

--------------4sGzgClqbjQsLYshcTH93BpN
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

Hello G=C3=BCnther!

On 3/5/23 11:24, G=C3=BCnther Noack wrote:
> +landlock mailing list (feeback welcome)
>=20
> Hello!
>=20
> On Sat, Mar 04, 2023 at 06:16:06PM +0100, G=C3=BCnther Noack wrote:
>> * Add LANDLOCK_ACCESS_FS_REFER to the code example.
>=20
> To follow up on the discussion on the man page update v1 [1] -- let me
> make a constructive proposal for a simpler code example for "best
> effort" fallback in the man page.
>=20
> I feel that implementing the full generic "best effort" fallback logic
> would complicate the example too much:
>=20
>  (a) examples that try to demonstrate too many things at once
>      tend to become confusing to the reader
>  (b) there are readers to whom the full example might not matter:
>      - readers who know what kernel their software runs on
>      - readers in the future or on cutting-edge distributions
>        who can assume that their kernel is likely to be fresh enough

I prefer if examples assume latest and greatest kernel.

Examples of how to support old kernels would be good in complete
tutorials, but over-complicate a short example.

Cheers,

Alex

--=20
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5

--------------4sGzgClqbjQsLYshcTH93BpN--

--------------tO0LBOzWLMNo2Gh6dKD9IMnt
Content-Type: application/pgp-signature; name="OpenPGP_signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="OpenPGP_signature"

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEE6jqH8KTroDDkXfJAnowa+77/2zIFAmQKeloACgkQnowa+77/
2zI/Xw//cubqRonWvPq+y0nFqjlJ5HsV25cggfurLCUvIPxeGJuoBHy23xOpuh8s
u6KOmX14mrc6uilqiU2T98xJQoEfI4QyPo4HAEPeEr8KPd9ZqjKfAv774kjJQhTJ
3OMy9O6DAID0V1+BpkmoywjA0KnNKvxv+DuBrR+AegY59sJ7cfVavH370O0vKXZP
9z0kUHBgB2iE3QrFllWr4qqm7Bx2gFAFLAbrxbZp4IPxjtbZUq0+NWs3GElGhIRf
0SsFLL5PqWR+Yp3KR7EHkqLA7dbLoK3sPtnBEge1PLSj/SRVOXYGpCzdfTGAX7ll
/5dGllLjcp16xnjvHJvbke8vsb84y17WP2K24qq7KbMOOQ2qGI8PoAdRbpgi5xzr
qm3J1tK0wSy0I1EE1Bhttebv9Dke3lgtJZ0b/1EUv8gsweXaKUB0YtiQLMYPFDoG
Q5yFH4gmJRZk0Q3zoOlcJGztC5PjG2iKm8wiX37BjsCYw+AFJrgspuka0fqyDALR
jJ3mfqScK4if1JY9vfajFFgiuyG7kxbYQk+bi1P33c+OACeaLXmIlyoa6am/08j9
iYAfUzgoSaVXYgNtmXZHvsrLvWwGWuw641JbgablXuO3Vfb+dLjr1rhiVM8InwLk
vdRT3cKC1Esw2/37UIGWxMLBvc7A0aDUDJoJNeuoFn1oPE2ZDZk=
=5JSx
-----END PGP SIGNATURE-----

--------------tO0LBOzWLMNo2Gh6dKD9IMnt--