[PATCH -next -v4 16/17] samples/landlock: Add metadata rights to sandboxer

From: Cai Xinchen

Date: Tue Nov 17 2026 - 09:39:16 EST


Handle the two new access rights in the sandboxer: READ_METADATA joins
the read-only set, WRITE_METADATA the read-write set, and both join
ACCESS_FILE. Bump LANDLOCK_ABI_LAST to 13 and remove the rights for
ABI < 13 in the fallback switch.

Update the trace example in events-landlock.rst accordingly.

Signed-off-by: Cai Xinchen <caixinchen1@xxxxxxxxxx>
---
Documentation/trace/events-landlock.rst | 18 ++++++++++--------
samples/landlock/sandboxer.c | 16 +++++++++++++---
2 files changed, 23 insertions(+), 11 deletions(-)

diff --git a/Documentation/trace/events-landlock.rst b/Documentation/trace/events-landlock.rst
index dc5f05a17c2c..f415eaa0eabf 100644
--- a/Documentation/trace/events-landlock.rst
+++ b/Documentation/trace/events-landlock.rst
@@ -88,7 +88,7 @@ Landlock, not from regular file permissions::
$ LC_ALL=C LL_FS_RO=/usr:/lib:/lib64:/bin:/etc/ld.so.cache LL_FS_RW=/tmp \
./sandboxer cat /etc/passwd
$ cat /sys/kernel/tracing/trace_pipe
- cat-127 [...] landlock_create_ruleset: ruleset=195cc6b76.0 handled_fs=execute|write_file|read_file|read_dir|remove_dir|remove_file|make_char|make_dir|make_reg|make_sock|make_fifo|make_block|make_sym|refer|truncate|ioctl_dev|resolve_unix handled_net= scoped= handled_permissions=
+ cat-127 [...] landlock_create_ruleset: ruleset=195cc6b76.0 handled_fs=execute|write_file|read_file|read_dir|remove_dir|remove_file|make_char|make_dir|make_reg|make_sock|make_fifo|make_block|make_sym|refer|truncate|ioctl_dev|resolve_unix|read_metadata|write_metadata handled_net= scoped= handled_permissions=
cat-127 [...] landlock_create_domain: domain=195cc6b7c parent=0 ruleset=195cc6b76.6
cat-127 [...] landlock_enforce_domain: domain=195cc6b7c complete=1 process_wide=1 no_new_privs=1
cat-127 [...] landlock_deny_access_fs: domain=195cc6b7c same_exec=0 logged=0 blockers=read_file dev=0:17 ino=5901179 path=/etc/passwd
@@ -279,20 +279,22 @@ For example, a program sandboxed with read and execute access to the
whole filesystem reads ``/etc/passwd``; both the ``execve()`` and the
read match the rule covering ``/`` (inode 2), so ``check_rule_inode`` fires
with the requested rights intersected against what that rule grants.
-The ``access_request=`` mask includes ``truncate`` because the file-open hook
-evaluates that optional right alongside the required access, but the
-rule does not grant it, so ``truncate`` never appears in ``grants=``::
+The ``access_request=`` mask includes ``truncate``, ``read_metadata`` and
+``write_metadata`` because the file-open hook evaluates those optional rights
+alongside the required access. The read-only rule grants ``read_metadata``,
+so it appears in ``grants=``, while ``truncate`` and ``write_metadata`` are
+not granted and therefore do not::

- cat-127 [...] landlock_check_rule_inode: domain=1e40cb56f access_request=execute|read_file|truncate dev=0:17 ino=2 grants={execute|read_file}
- cat-127 [...] landlock_check_rule_inode: domain=1e40cb56f access_request=read_file|truncate dev=0:17 ino=2 grants={read_file}
+ cat-127 [...] landlock_check_rule_inode: domain=1e40cb56f access_request=execute|read_file|truncate|read_metadata|write_metadata dev=0:17 ino=2 grants={execute|read_file|read_metadata}
+ cat-127 [...] landlock_check_rule_inode: domain=1e40cb56f access_request=read_file|truncate|read_metadata|write_metadata dev=0:17 ino=2 grants={read_file|read_metadata}

The ``[...]`` replaces the ftrace CPU, flags, and timestamp columns. A
single ``grants=`` group means the enforcing domain has one layer. With
two nested sandboxes that each grant the same rights, the rule spans both
layers, so ``grants=`` has one group per layer::

- cat-128 [...] landlock_check_rule_inode: domain=184788b52 access_request=execute|read_file|truncate dev=0:17 ino=2 grants={execute|read_file,execute|read_file}
- cat-128 [...] landlock_check_rule_inode: domain=184788b52 access_request=read_file|truncate dev=0:17 ino=2 grants={read_file,read_file}
+ cat-128 [...] landlock_check_rule_inode: domain=184788b52 access_request=execute|read_file|truncate|read_metadata|write_metadata dev=0:17 ino=2 grants={execute|read_file|read_metadata,execute|read_file|read_metadata}
+ cat-128 [...] landlock_check_rule_inode: domain=184788b52 access_request=read_file|truncate|read_metadata|write_metadata dev=0:17 ino=2 grants={read_file|read_metadata,read_file|read_metadata}

eBPF access
===========
diff --git a/samples/landlock/sandboxer.c b/samples/landlock/sandboxer.c
index 1362f08ff14b..29965ef90bed 100644
--- a/samples/landlock/sandboxer.c
+++ b/samples/landlock/sandboxer.c
@@ -137,6 +137,8 @@ static int parse_path(char *env_path, const char ***const path_list)
LANDLOCK_ACCESS_FS_EXECUTE | \
LANDLOCK_ACCESS_FS_WRITE_FILE | \
LANDLOCK_ACCESS_FS_READ_FILE | \
+ LANDLOCK_ACCESS_FS_READ_METADATA | \
+ LANDLOCK_ACCESS_FS_WRITE_METADATA | \
LANDLOCK_ACCESS_FS_TRUNCATE | \
LANDLOCK_ACCESS_FS_IOCTL_DEV | \
LANDLOCK_ACCESS_FS_RESOLVE_UNIX)
@@ -487,7 +489,8 @@ static bool check_ruleset_scope(const char *const env_var,
#define ACCESS_FS_ROUGHLY_READ ( \
LANDLOCK_ACCESS_FS_EXECUTE | \
LANDLOCK_ACCESS_FS_READ_FILE | \
- LANDLOCK_ACCESS_FS_READ_DIR)
+ LANDLOCK_ACCESS_FS_READ_DIR | \
+ LANDLOCK_ACCESS_FS_READ_METADATA)

#define ACCESS_FS_ROUGHLY_WRITE ( \
LANDLOCK_ACCESS_FS_WRITE_FILE | \
@@ -503,7 +506,8 @@ static bool check_ruleset_scope(const char *const env_var,
LANDLOCK_ACCESS_FS_REFER | \
LANDLOCK_ACCESS_FS_TRUNCATE | \
LANDLOCK_ACCESS_FS_IOCTL_DEV | \
- LANDLOCK_ACCESS_FS_RESOLVE_UNIX)
+ LANDLOCK_ACCESS_FS_RESOLVE_UNIX | \
+ LANDLOCK_ACCESS_FS_WRITE_METADATA)

/* clang-format on */

@@ -570,7 +574,7 @@ static int add_quiet_access(const char *const env_var,
return 0;
}

-#define LANDLOCK_ABI_LAST 12
+#define LANDLOCK_ABI_LAST 13

#define XSTR(s) #s
#define STR(s) XSTR(s)
@@ -780,6 +784,12 @@ int main(const int argc, char *const argv[], char *const *const envp)
ruleset_attr.handled_permissions &=
~(LANDLOCK_PERMISSION_NAMESPACE_USE |
LANDLOCK_PERMISSION_CAPABILITY_USE);
+ __attribute__((fallthrough));
+ case 12:
+ /* Removes metadata rights for ABI < 13 */
+ ruleset_attr.handled_access_fs &=
+ ~(LANDLOCK_ACCESS_FS_READ_METADATA |
+ LANDLOCK_ACCESS_FS_WRITE_METADATA);
/* Must be printed for any ABI < LANDLOCK_ABI_LAST. */
fprintf(stderr,
"Hint: You should update the running kernel "
--
2.18.0.huawei.25