summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man5/systemd.resource-control.5
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man5/systemd.resource-control.5')
-rw-r--r--upstream/fedora-rawhide/man5/systemd.resource-control.560
1 files changed, 37 insertions, 23 deletions
diff --git a/upstream/fedora-rawhide/man5/systemd.resource-control.5 b/upstream/fedora-rawhide/man5/systemd.resource-control.5
index 3e1a9ae0..a2829b60 100644
--- a/upstream/fedora-rawhide/man5/systemd.resource-control.5
+++ b/upstream/fedora-rawhide/man5/systemd.resource-control.5
@@ -1,5 +1,5 @@
'\" t
-.TH "SYSTEMD\&.RESOURCE\-CONTROL" "5" "" "systemd 255" "systemd.resource-control"
+.TH "SYSTEMD\&.RESOURCE\-CONTROL" "5" "" "systemd 256~rc3" "systemd.resource-control"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -161,6 +161,7 @@ user\-\fInnn\fR\&.slice\&. Drop\-ins with local configuration that affect user 1
/etc/systemd/system/user\-1000\&.slice,
/etc/systemd/system/user\-1000\&.slice\&.d/*\&.conf, but also
/etc/systemd/system/user\-\&.slice\&.d/*\&.conf\&. This last directory applies to all user slices\&.
+.SS ""
.PP
See the
\m[blue]\fBNew Control Group Interfaces\fR\m[]\&\s-2\u[1]\d\s+2
@@ -422,7 +423,10 @@ Takes a memory size in bytes\&. If the value is suffixed with K, M, G or T, the
"infinity", no memory throttling is applied\&. This controls the
"memory\&.high"
control group attribute\&. For details about this control group attribute, see
-\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&.
+\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&. The effective configuration is reported as
+\fIEffectiveMemoryHigh=\fR
+(see also
+\fIEffectiveMemoryMax=\fR)\&.
.sp
While
\fIStartupMemoryHigh=\fR
@@ -451,7 +455,9 @@ Takes a memory size in bytes\&. If the value is suffixed with K, M, G or T, the
"infinity", no memory limit is applied\&. This controls the
"memory\&.max"
control group attribute\&. For details about this control group attribute, see
-\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&.
+\m[blue]\fBMemory Interface Files\fR\m[]\&\s-2\u[5]\d\s+2\&. The effective configuration is reported as
+\fIEffectiveMemoryMax=\fR
+(the value is the most stringent limit of the unit and parent slices and it is capped by physical memory)\&.
.sp
While
\fIStartupMemoryMax=\fR
@@ -516,6 +522,19 @@ allows prioritizing specific services at boot\-up and shutdown differently than
Added in version 253\&.
.RE
.PP
+\fIMemoryZSwapWriteback=\fR
+.RS 4
+This setting controls the
+\fBmemory\fR
+controller in the unified hierarchy\&.
+.sp
+Takes a boolean argument\&. When true, pages stored in the Zswap cache are permitted to be written to the backing storage, false otherwise\&. Defaults to true\&. This allows disabling writeback of swap pages for IO\-intensive applications, while retaining the ability to store compressed pages in Zswap\&. See the kernel\*(Aqs
+\m[blue]\fBZswap\fR\m[]\&\s-2\u[6]\d\s+2
+documentation for more details\&.
+.sp
+Added in version 256\&.
+.RE
+.PP
\fIAllowedMemoryNodes=\fR, \fIStartupAllowedMemoryNodes=\fR
.RS 4
These settings control the
@@ -569,7 +588,8 @@ Specify the maximum number of tasks that may be created in the unit\&. This ensu
"infinity", no tasks limit is applied\&. This controls the
"pids\&.max"
control group attribute\&. For details about this control group attribute, the
-\m[blue]\fBpids controller\fR\m[]\&\s-2\u[7]\d\s+2\&.
+\m[blue]\fBpids controller\fR\m[]\&\s-2\u[7]\d\s+2\&. The effective configuration is reported as
+\fIEffectiveTasksMax=\fR\&.
.sp
The system default for this setting may be controlled with
\fIDefaultTasksMax=\fR
@@ -702,6 +722,8 @@ The system default for this setting may be controlled with
in
\fBsystemd-system.conf\fR(5)\&.
.sp
+Note that this functionality is currently only available for system services, not for per\-user services\&.
+.sp
Added in version 235\&.
.RE
.PP
@@ -833,9 +855,9 @@ Added in version 235\&.
.PP
\fISocketBindAllow=\fR\fI\fIbind\-rule\fR\fR, \fISocketBindDeny=\fR\fI\fIbind\-rule\fR\fR
.RS 4
-Allow or deny binding a socket address to a socket by matching it with the
-\fIbind\-rule\fR
-and applying a corresponding action if there is a match\&.
+Configures restrictions on the ability of unit processes to invoke
+\fBbind\fR(2)
+on a socket\&. Both allow and deny rules may defined that restrict which addresses a socket may be bound to\&.
.sp
\fIbind\-rule\fR
describes socket properties such as
@@ -964,6 +986,11 @@ and
\fBcgroup/bind6\fR
cgroup\-bpf hooks\&.
.sp
+Note that these settings apply to any
+\fBbind\fR(2)
+system call invocation by the unit processes, regardless in which network namespace they are placed\&. Or in other words: changing the network namespace is not a suitable mechanism for escaping these restrictions on
+\fBbind()\fR\&.
+.sp
Examples:
.sp
.if n \{\
@@ -1739,20 +1766,7 @@ Added in version 252\&.
.RE
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsystemd-system.conf\fR(5),
-\fBsystemd.unit\fR(5),
-\fBsystemd.service\fR(5),
-\fBsystemd.slice\fR(5),
-\fBsystemd.scope\fR(5),
-\fBsystemd.socket\fR(5),
-\fBsystemd.mount\fR(5),
-\fBsystemd.swap\fR(5),
-\fBsystemd.exec\fR(5),
-\fBsystemd.directives\fR(7),
-\fBsystemd.special\fR(7),
-\fBsystemd-oomd.service\fR(8), The documentation for control groups and specific controllers in the Linux kernel:
-\m[blue]\fBControl Groups v2\fR\m[]\&\s-2\u[2]\d\s+2\&.
+\fBsystemd\fR(1), \fBsystemd-system.conf\fR(5), \fBsystemd.unit\fR(5), \fBsystemd.service\fR(5), \fBsystemd.slice\fR(5), \fBsystemd.scope\fR(5), \fBsystemd.socket\fR(5), \fBsystemd.mount\fR(5), \fBsystemd.swap\fR(5), \fBsystemd.exec\fR(5), \fBsystemd.directives\fR(7), \fBsystemd.special\fR(7), \fBsystemd-oomd.service\fR(8), The documentation for control groups and specific controllers in the Linux kernel: \m[blue]\fBControl Groups v2\fR\m[]\&\s-2\u[2]\d\s+2
.SH "NOTES"
.IP " 1." 4
New Control Group Interfaces
@@ -1782,12 +1796,12 @@ Memory Interface Files
.IP " 6." 4
Zswap
.RS 4
-\%https://www.kernel.org/doc/html/latest/admin-guide/mm/zswap.html
+\%https://docs.kernel.org/admin-guide/mm/zswap.html
.RE
.IP " 7." 4
pids controller
.RS 4
-\%https://www.kernel.org/doc/html/latest/admin-guide/cgroup-v2.html#pid
+\%https://docs.kernel.org/admin-guide/cgroup-v2.html#pid
.RE
.IP " 8." 4
IO Interface Files