Skip to content

Commit 9803787

Browse files
committed
landlock: Improve documentation of previous limitations
Improve consistency of previous limitations' subsection titles, and expand a bit the IOCTL section. This changes some HTML anchors and may break some external links though. Cc: Konstantin Meskhidze <[email protected]> Cc: Tahera Fahimi <[email protected]> Reviewed-by: Günther Noack <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Mickaël Salaün <[email protected]>
1 parent 8e929cb commit 9803787

File tree

1 file changed

+11
-10
lines changed

1 file changed

+11
-10
lines changed

Documentation/userspace-api/landlock.rst

Lines changed: 11 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Landlock: unprivileged access control
88
=====================================
99

1010
:Author: Mickaël Salaün
11-
:Date: September 2024
11+
:Date: October 2024
1212

1313
The goal of Landlock is to enable to restrict ambient rights (e.g. global
1414
filesystem or network access) for a set of processes. Because Landlock
@@ -563,33 +563,34 @@ always allowed when using a kernel that only supports the first or second ABI.
563563
Starting with the Landlock ABI version 3, it is now possible to securely control
564564
truncation thanks to the new ``LANDLOCK_ACCESS_FS_TRUNCATE`` access right.
565565

566-
Network support (ABI < 4)
567-
-------------------------
566+
TCP bind and connect (ABI < 4)
567+
------------------------------
568568

569569
Starting with the Landlock ABI version 4, it is now possible to restrict TCP
570570
bind and connect actions to only a set of allowed ports thanks to the new
571571
``LANDLOCK_ACCESS_NET_BIND_TCP`` and ``LANDLOCK_ACCESS_NET_CONNECT_TCP``
572572
access rights.
573573

574-
IOCTL (ABI < 5)
575-
---------------
574+
Device IOCTL (ABI < 5)
575+
----------------------
576576

577577
IOCTL operations could not be denied before the fifth Landlock ABI, so
578578
:manpage:`ioctl(2)` is always allowed when using a kernel that only supports an
579579
earlier ABI.
580580

581581
Starting with the Landlock ABI version 5, it is possible to restrict the use of
582-
:manpage:`ioctl(2)` using the new ``LANDLOCK_ACCESS_FS_IOCTL_DEV`` right.
582+
:manpage:`ioctl(2)` on character and block devices using the new
583+
``LANDLOCK_ACCESS_FS_IOCTL_DEV`` right.
583584

584-
Abstract UNIX socket scoping (ABI < 6)
585-
--------------------------------------
585+
Abstract UNIX socket (ABI < 6)
586+
------------------------------
586587

587588
Starting with the Landlock ABI version 6, it is possible to restrict
588589
connections to an abstract :manpage:`unix(7)` socket by setting
589590
``LANDLOCK_SCOPE_ABSTRACT_UNIX_SOCKET`` to the ``scoped`` ruleset attribute.
590591

591-
Signal scoping (ABI < 6)
592-
------------------------
592+
Signal (ABI < 6)
593+
----------------
593594

594595
Starting with the Landlock ABI version 6, it is possible to restrict
595596
:manpage:`signal(7)` sending by setting ``LANDLOCK_SCOPE_SIGNAL`` to the

0 commit comments

Comments
 (0)