Skip to content

Commit de4b09a

Browse files
samasth-norwayl0kod
authored andcommitted
landlock: Document audit blocker field format
Add comprehensive documentation for the ``blockers`` field format in AUDIT_LANDLOCK_ACCESS records, including all possible prefixes (fs., net., scope.) and their meanings. Also fix a typo and update the documentation date to reflect these changes. Signed-off-by: Samasth Norway Ananda <samasth.norway.ananda@oracle.com> Link: https://lore.kernel.org/r/20260128031814.2945394-4-samasth.norway.ananda@oracle.com Signed-off-by: Mickaël Salaün <mic@digikod.net>
1 parent fe72ce6 commit de4b09a

1 file changed

Lines changed: 33 additions & 2 deletions

File tree

Documentation/admin-guide/LSM/landlock.rst

Lines changed: 33 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Landlock: system-wide management
66
================================
77

88
:Author: Mickaël Salaün
9-
:Date: March 2025
9+
:Date: January 2026
1010

1111
Landlock can leverage the audit framework to log events.
1212

@@ -38,6 +38,37 @@ AUDIT_LANDLOCK_ACCESS
3838
domain=195ba459b blockers=fs.refer path="/usr/bin" dev="vda2" ino=351
3939
domain=195ba459b blockers=fs.make_reg,fs.refer path="/usr/local" dev="vda2" ino=365
4040

41+
42+
The ``blockers`` field uses dot-separated prefixes to indicate the type of
43+
restriction that caused the denial:
44+
45+
**fs.*** - Filesystem access rights (ABI 1+):
46+
- fs.execute, fs.write_file, fs.read_file, fs.read_dir
47+
- fs.remove_dir, fs.remove_file
48+
- fs.make_char, fs.make_dir, fs.make_reg, fs.make_sock
49+
- fs.make_fifo, fs.make_block, fs.make_sym
50+
- fs.refer (ABI 2+)
51+
- fs.truncate (ABI 3+)
52+
- fs.ioctl_dev (ABI 5+)
53+
54+
**net.*** - Network access rights (ABI 4+):
55+
- net.bind_tcp - TCP port binding was denied
56+
- net.connect_tcp - TCP connection was denied
57+
58+
**scope.*** - IPC scoping restrictions (ABI 6+):
59+
- scope.abstract_unix_socket - Abstract UNIX socket connection denied
60+
- scope.signal - Signal sending denied
61+
62+
Multiple blockers can appear in a single event (comma-separated) when
63+
multiple access rights are missing. For example, creating a regular file
64+
in a directory that lacks both ``make_reg`` and ``refer`` rights would show
65+
``blockers=fs.make_reg,fs.refer``.
66+
67+
The object identification fields (path, dev, ino for filesystem; opid,
68+
ocomm for signals) depend on the type of access being blocked and provide
69+
context about what resource was involved in the denial.
70+
71+
4172
AUDIT_LANDLOCK_DOMAIN
4273
This record type describes the status of a Landlock domain. The ``status``
4374
field can be either ``allocated`` or ``deallocated``.
@@ -86,7 +117,7 @@ This command generates two events, each identified with a unique serial
86117
number following a timestamp (``msg=audit(1729738800.268:30)``). The first
87118
event (serial ``30``) contains 4 records. The first record
88119
(``type=LANDLOCK_ACCESS``) shows an access denied by the domain `1a6fdc66f`.
89-
The cause of this denial is signal scopping restriction
120+
The cause of this denial is signal scoping restriction
90121
(``blockers=scope.signal``). The process that would have receive this signal
91122
is the init process (``opid=1 ocomm="systemd"``).
92123

0 commit comments

Comments
 (0)