@@ -12,14 +12,24 @@ with lib;
1212 type = types.bool;
1313 default = true;
1414 description = ''
15− Whether to allow creation of user namespaces. A recurring problem
16− with user namespaces is the presence of code paths where the kernel's
17− permission checking logic fails to account for namespacing, instead
18− permitting a namespaced process to act outside the namespace with the
19− same privileges as it would have inside it. This is particularly
15+ Whether to allow creation of user namespaces.
16+ </para>
17+
18+ <para>
19+ The motivation for disabling user namespaces is the potential
20+ presence of code paths where the kernel's permission checking
21+ logic fails to account for namespacing, instead permitting a
22+ namespaced process to act outside the namespace with the same
23+ privileges as it would have inside it. This is particularly
2024 damaging in the common case of running as root within the namespace.
21− When user namespace creation is disallowed, attempting to create
22− a user namespace fails with "no space left on device" (ENOSPC).
25+ </para>
26+
27+ <para>
28+ When user namespace creation is disallowed, attempting to create a
29+ user namespace fails with "no space left on device" (ENOSPC).
30+ root may re-enable user namespace creation at runtime.
31+ </para>
32+ <para>
2333 '';
2434 };
2535