[lkml]   [2021]   [Jul]   [6]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
Patch in this message
Subject[PATCH v1 2/4] landlock_create_ruleset.2: Document new syscall
From: Mickaël Salaün <>

This is an adaptation of

Signed-off-by: Mickaël Salaün <>
man2/landlock_create_ruleset.2 | 134 +++++++++++++++++++++++++++++++++
1 file changed, 134 insertions(+)
create mode 100644 man2/landlock_create_ruleset.2

diff --git a/man2/landlock_create_ruleset.2 b/man2/landlock_create_ruleset.2
new file mode 100644
index 000000000000..5fe0f8fd808e
--- /dev/null
+++ b/man2/landlock_create_ruleset.2
@@ -0,0 +1,134 @@
+.\" Copyright © 2017-2020 Mickaël Salaün <>
+.\" Copyright © 2019-2020 ANSSI
+.\" Copyright © 2021 Microsoft Corporation
+.\" Permission is granted to make and distribute verbatim copies of this
+.\" manual provided the copyright notice and this permission notice are
+.\" preserved on all copies.
+.\" Permission is granted to copy and distribute modified versions of this
+.\" manual under the conditions for verbatim copying, provided that the
+.\" entire resulting derived work is distributed under the terms of a
+.\" permission notice identical to this one.
+.\" Since the Linux kernel and libraries are constantly changing, this
+.\" manual page may be incorrect or out-of-date. The author(s) assume no
+.\" responsibility for errors or omissions, or for damages resulting from
+.\" the use of the information contained herein. The author(s) may not
+.\" have taken the same level of care in the production of this manual,
+.\" which is licensed free of charge, as they might when working
+.\" professionally.
+.\" Formatted or processed versions of this manual, if unaccompanied by
+.\" the source, must acknowledge the copyright and authors of this work.
+.TH LANDLOCK_CREATE_RULESET 2 2021-06-27 Linux "Linux Programmer's Manual"
+landlock_create_ruleset \- create a new Landlock ruleset
+.BR "#include <linux/landlock.h>" " /* Definition of " LANDLOCK_* " constants */"
+.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */"
+.BI "int syscall(SYS_landlock_create_ruleset,
+.BI " const struct landlock_ruleset_attr " attr ,
+.BI " size_t " size " , __u32 " flags );
+A Landlock ruleset identifies a set of rules (i.e. actions on objects).
+.BR landlock_create_ruleset (2)
+system call enables creating a new file descriptor identifying a ruleset.
+This file descriptor can then be used by
+.BR landlock_add_rule (2)
+.BR landlock_restrict_self (2)
+\&. See
+.BR landlock (7)
+for a global overview.
+.I attr
+specifies the properties of the new ruleset. It points to the following
+.IP +4n
+struct landlock_ruleset_attr {
+ __u64 handled_access_fs;
+.I handled_access_fs
+is a bitmask of actions that is handled by this ruleset and should then be
+forbidden if no rule explicitly allow them
+.BR "Filesystem actions"
+.BR landlock (7)
+This enables simply restricting ambient rights (e.g., global filesystem
+access) and is needed for compatibility reasons.
+.I size
+must be specified as
+.I sizeof(struct landlock_ruleset_attr)
+for compatibility reasons.
+.I flags
+must be 0 if
+.I attr
+is used. Otherwise,
+.I flags
+can be set to:
+.I attr
+is NULL and
+.I size
+is 0, then the returned value is the highest supported Landlock ABI version
+(starting at 1). This version can be used for a best-effort security
+approach, which is encouraged when user space is not pinned to a specific
+kernel version. All features documented in these man pages are available
+with the version 1.
+On success,
+.BR landlock_create_ruleset (2)
+returns a new Landlock ruleset file descriptor, or a Landlock ABI version
+according to
+.I flags
+.BR landlock_create_ruleset (2)
+can failed for the following reasons:
+Landlock is supported by the kernel but disabled at boot time.
+.I flags
+, or unknown access, or too small
+.I size
+.I size
+is too big.
+.I attr
+was not a valid address.
+Empty accesses (i.e.
+.I attr->handled_access_fs
+is 0).
+Landlock was added in Linux 5.13.
+.BR landlock (7),
+.BR landlock_add_rule (2),
+.BR landlock_restrict_self (2)
 \ /
  Last update: 2021-07-06 20:23    [W:0.037 / U:0.396 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site