Skip to content

Update Landlock docs to Landlock ABI v8

Günther Noack linux-man 3 versions – Applied

Status from this message: I've applied the both patches of the patch set. Thanks!

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v4 Latest2 patches 2 repliesApplied
  2. v34 patches 1 replySuperseded
  3. v24 patches 3 repliesApplied

Changes in v4 from the cover letter

- mention ABI versions for flags next to the tagged paragraph title where they are described
- 1/2: do that in landlock_restrict_self.2 (based on v3's patch 4)
- 2/2: do that in landlock_add_rule.2 as well
- earlier patches 1,2,3 from v3 were already merged

Patches in v4 Applied

#Subject and filesSizeRepliesApplied
1/2man/man2/landlock_restrict_self.2: Document ABI requirement for logging flagsman/man2/landlock_restrict_self.2+3 -30 replies
2/2man/man2/landlock_add_rule.2: mention ABI version for LANDLOCK_RULE_NET_PORTman/man2/landlock_add_rule.2+1 -10 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v4 yet.

Read the v4 thread

Cover letter [PATCH v4 0/2] Update Landlock docs to Landlock ABI v8

Hello!

Thanks for the review! Here's the fourth round of the patch set, this time just adding the missing ABI version information. Added another small patch in the same style for the adjacent Landlock man page where it applies. (The third Landlock manpage, landlock_create_ruleset.2, doesn't need it because one flag is available since the start and the errata flag is available where needed and backported everywhere, as previously discussed.)

Kept the cover letter title as is, to reduce confusion (but the part where Landlock ABI v8 gets described is already submitted).

–Günther

P.S.: I have a half-finished commit for the upcoming Linux 7.1 release as well; I can send this one soon, I assume it's OK to send these slightly before the release, given that the code is already on Linux master?

Change Log
==========

v4:
- mention ABI versions for flags next to the tagged paragraph title where they are described
- 1/2: do that in landlock_restrict_self.2 (based on v3's patch 4)
- 2/2: do that in landlock_add_rule.2 as well
- earlier patches 1,2,3 from v3 were already merged

v3:
- split the size/attr clarifications from the "errata" patch into a separate commit
- earlier patch from v2 about the "scoped" EINVAL error was already merged

v2:
- landlock_create_ruleset.2: added a tiny patch to add a missing mention of "scoped" in the errors list.
- landlock_create_ruleset.2: various reformulations for errata
- earlier patch from v1 about the default ABI version assumption was already merged (thanks!)

Günther Noack (2):
man/man2/landlock_restrict_self.2: Document ABI requirement for
logging flags
man/man2/landlock_add_rule.2: mention ABI version for
LANDLOCK_RULE_NET_PORT

 man/man2/landlock_add_rule.2      | 2 +-
 man/man2/landlock_restrict_self.2 | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)
Signature · 1 line
2.53.0