History

Merge git://git.kernel.org/pub/scm/linux/kernel/git/netdev/net

Cross-merge networking fixes after downstream PR (net-6.15-rc5). No conflicts or adjacent changes.

Jakub Kicinski committed 1 year ago

Commit 337079d2 parents deeed35 ebd297a342 files · +4720 −2358Browse files

Showing the changes to include/uapi/linux (2 of 342 files). Show all

Unified · Split

2 files
  1. include/uapi/linux/ethtool_netlink_generated.h +0 −5
  2. include/uapi/linux/landlock.h +57 −30
include/uapi/linux/ethtool_netlink_generated.h+0−5
@@ -31,11 +31,6 @@ enum ethtool_header_flags { · 30 unmodified lines
3131 ETHTOOL_FLAG_STATS = 4,
3232 };
3333
34−enum {
35− ETHTOOL_PHY_UPSTREAM_TYPE_MAC,
36− ETHTOOL_PHY_UPSTREAM_TYPE_PHY,
37−};
38−
3934 enum ethtool_tcp_data_split {
4035 ETHTOOL_TCP_DATA_SPLIT_UNKNOWN,
4136 ETHTOOL_TCP_DATA_SPLIT_DISABLED,
include/uapi/linux/landlock.h+57−30
@@ -53,43 +53,70 @@ struct landlock_ruleset_attr { · 52 unmodified lines
5353 __u64 scoped;
5454 };
5555
56−/*
57− * sys_landlock_create_ruleset() flags:
56+/**
57+ * DOC: landlock_create_ruleset_flags
58+ *
59+ * **Flags**
5860 *
59− * - %LANDLOCK_CREATE_RULESET_VERSION: Get the highest supported Landlock ABI
60− * version.
61− * - %LANDLOCK_CREATE_RULESET_ERRATA: Get a bitmask of fixed issues.
61+ * %LANDLOCK_CREATE_RULESET_VERSION
62+ * Get the highest supported Landlock ABI version (starting at 1).
63+ *
64+ * %LANDLOCK_CREATE_RULESET_ERRATA
65+ * Get a bitmask of fixed issues for the current Landlock ABI version.
6266 */
6367 /* clang-format off */
6468 #define LANDLOCK_CREATE_RULESET_VERSION (1U << 0)
6569 #define LANDLOCK_CREATE_RULESET_ERRATA (1U << 1)
6670 /* clang-format on */
6771
68−/*
69− * sys_landlock_restrict_self() flags:
70− *
71− * - %LANDLOCK_RESTRICT_SELF_LOG_SAME_EXEC_OFF: Do not create any log related to the
72− * enforced restrictions. This should only be set by tools launching unknown
73− * or untrusted programs (e.g. a sandbox tool, container runtime, system
74− * service manager). Because programs sandboxing themselves should fix any
75− * denied access, they should not set this flag to be aware of potential
76− * issues reported by system's logs (i.e. audit).
77− * - %LANDLOCK_RESTRICT_SELF_LOG_NEW_EXEC_ON: Explicitly ask to continue
78− * logging denied access requests even after an :manpage:`execve(2)` call.
79− * This flag should only be set if all the programs than can legitimately be
80− * executed will not try to request a denied access (which could spam audit
81− * logs).
82− * - %LANDLOCK_RESTRICT_SELF_LOG_SUBDOMAINS_OFF: Do not create any log related
83− * to the enforced restrictions coming from future nested domains created by
84− * the caller or its descendants. This should only be set according to a
85− * runtime configuration (i.e. not hardcoded) by programs launching other
86− * unknown or untrusted programs that may create their own Landlock domains
87− * and spam logs. The main use case is for container runtimes to enable users
88− * to mute buggy sandboxed programs for a specific container image. Other use
89− * cases include sandboxer tools and init systems. Unlike
90− * %LANDLOCK_RESTRICT_SELF_LOG_SAME_EXEC_OFF,
91− * %LANDLOCK_RESTRICT_SELF_LOG_SUBDOMAINS_OFF does not impact the requested
92− * restriction (if any) but only the future nested domains.
72+/**
73+ * DOC: landlock_restrict_self_flags
74+ *
75+ * **Flags**
76+ *
77+ * By default, denied accesses originating from programs that sandbox themselves
78+ * are logged via the audit subsystem. Such events typically indicate unexpected
79+ * behavior, such as bugs or exploitation attempts. However, to avoid excessive
80+ * logging, access requests denied by a domain not created by the originating
81+ * program are not logged by default. The rationale is that programs should know
82+ * their own behavior, but not necessarily the behavior of other programs. This
83+ * default configuration is suitable for most programs that sandbox themselves.
84+ * For specific use cases, the following flags allow programs to modify this
85+ * default logging behavior.
86+ *
87+ * The %LANDLOCK_RESTRICT_SELF_LOG_SAME_EXEC_OFF and
88+ * %LANDLOCK_RESTRICT_SELF_LOG_NEW_EXEC_ON flags apply to the newly created
89+ * Landlock domain.
90+ *
91+ * %LANDLOCK_RESTRICT_SELF_LOG_SAME_EXEC_OFF
92+ * Disables logging of denied accesses originating from the thread creating
93+ * the Landlock domain, as well as its children, as long as they continue
94+ * running the same executable code (i.e., without an intervening
95+ * :manpage:`execve(2)` call). This is intended for programs that execute
96+ * unknown code without invoking :manpage:`execve(2)`, such as script
97+ * interpreters. Programs that only sandbox themselves should not set this
98+ * flag, so users can be notified of unauthorized access attempts via system
99+ * logs.
100+ *
101+ * %LANDLOCK_RESTRICT_SELF_LOG_NEW_EXEC_ON
102+ * Enables logging of denied accesses after an :manpage:`execve(2)` call,
103+ * providing visibility into unauthorized access attempts by newly executed
104+ * programs within the created Landlock domain. This flag is recommended
105+ * only when all potential executables in the domain are expected to comply
106+ * with the access restrictions, as excessive audit log entries could make
107+ * it more difficult to identify critical events.
108+ *
109+ * %LANDLOCK_RESTRICT_SELF_LOG_SUBDOMAINS_OFF
110+ * Disables logging of denied accesses originating from nested Landlock
111+ * domains created by the caller or its descendants. This flag should be set
112+ * according to runtime configuration, not hardcoded, to avoid suppressing
113+ * important security events. It is useful for container runtimes or
114+ * sandboxing tools that may launch programs which themselves create
115+ * Landlock domains and could otherwise generate excessive logs. Unlike
116+ * ``LANDLOCK_RESTRICT_SELF_LOG_SAME_EXEC_OFF``, this flag only affects
117+ * future nested domains, not the one being created. It can also be used
118+ * with a @ruleset_fd value of -1 to mute subdomain logs without creating a
119+ * domain.
93120 */
94121 /* clang-format off */
95122 #define LANDLOCK_RESTRICT_SELF_LOG_SAME_EXEC_OFF (1U << 0)