Debian Codegraph @

upstream/debian-trixie/man8/systemd-sysctl.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-SYSCTL\&.SERVICE" "8" "" "systemd 257.13" "systemd-sysctl.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-sysctl.service, systemd-sysctl \- Configure kernel parameters at boot
24 .SH "SYNOPSIS"
25 .HP \w'\fB/usr/lib/systemd/systemd\-sysctl\fR\ 'u
26 \fB/usr/lib/systemd/systemd\-sysctl\fR [OPTIONS...] [\fICONFIGFILE\fR...]
27 .PP
28 systemd\-sysctl\&.service
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-sysctl\&.service
32 is an early boot service that configures
33 \fBsysctl\fR(8)
34 kernel parameters by invoking
35 \fB/usr/lib/systemd/systemd\-sysctl\fR\&.
36 .PP
37 When invoked with no arguments,
38 \fB/usr/lib/systemd/systemd\-sysctl\fR
39 applies all directives from configuration files listed in
40 \fBsysctl.d\fR(5)\&. If one or more filenames are passed on the command line, only the directives in these files are applied\&.
41 .PP
42 In addition,
43 \fB\-\-prefix=\fR
44 option may be used to limit which sysctl settings are applied\&.
45 .PP
46 See
47 \fBsysctl.d\fR(5)
48 for information about the configuration of sysctl settings\&. After sysctl configuration is changed on disk, it must be written to the files in
49 /proc/sys/
50 before it takes effect\&. It is possible to update specific settings, or simply to reload all configuration, see Examples below\&.
51 .SH "OPTIONS"
52 .PP
53 \fB\-\-prefix=\fR
54 .RS 4
55 Only apply rules with the specified prefix\&.
56 .sp
57 Added in version 230\&.
58 .RE
59 .PP
60 \fB\-\-strict=\fR
61 .RS 4
62 Always return non\-zero exit code on failure (including invalid sysctl variable name and insufficient permissions), unless the sysctl variable name is prefixed with a "\-" character\&.
63 .sp
64 Added in version 252\&.
65 .RE
66 .PP
67 \fB\-\-cat\-config\fR
68 .RS 4
69 Copy the contents of config files to standard output\&. Before each file, the filename is printed as a comment\&.
70 .RE
71 .PP
72 \fB\-\-tldr\fR
73 .RS 4
74 Copy the contents of config files to standard output\&. Only the "interesting" parts of the configuration files are printed, comments and empty lines are skipped\&. Before each file, the filename is printed as a comment\&.
75 .RE
76 .PP
77 \fB\-\-no\-pager\fR
78 .RS 4
79 Do not pipe output into a pager\&.
80 .RE
81 .PP
82 \fB\-h\fR, \fB\-\-help\fR
83 .RS 4
84 Print a short help text and exit\&.
85 .RE
86 .PP
87 \fB\-\-version\fR
88 .RS 4
89 Print a short version string and exit\&.
90 .RE
91 .SH "CREDENTIALS"
92 .PP
93 \fBsystemd\-sysctl\fR
94 supports the service credentials logic as implemented by
95 \fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR
96 (see
97 \fBsystemd.exec\fR(5)
98 for details)\&. The following credentials are used when passed in:
99 .PP
100 \fIsysctl\&.extra\fR
101 .RS 4
102 The contents of this credential may contain additional lines to operate on\&. The credential contents should follow the same format as any other
103 sysctl\&.d/
104 drop\-in configuration file\&. If this credential is passed it is processed after all of the drop\-in files read from the file system\&. The settings configured in the credential hence take precedence over those in the file system\&.
105 .sp
106 Added in version 252\&.
107 .RE
108 .PP
109 Note that by default the
110 systemd\-sysctl\&.service
111 unit file is set up to inherit the
112 "sysctl\&.extra"
113 credential from the service manager\&.
114 .SH "EXAMPLES"
115 .PP
116 \fBExample\ \&1.\ \&Reset all sysctl settings\fR
117 .sp
118 .if n \{\
119 .RS 4
120 .\}
121 .nf
122 systemctl restart systemd\-sysctl
123 .fi
124 .if n \{\
125 .RE
126 .\}
127 .PP
128 \fBExample\ \&2.\ \&View coredump handler configuration\fR
129 .sp
130 .if n \{\
131 .RS 4
132 .\}
133 .nf
134 # sysctl kernel\&.core_pattern
135 kernel\&.core_pattern = |/usr/libexec/abrt\-hook\-ccpp %s %c %p %u %g %t %P %I
136 .fi
137 .if n \{\
138 .RE
139 .\}
140 .PP
141 \fBExample\ \&3.\ \&Update coredump handler configuration\fR
142 .sp
143 .if n \{\
144 .RS 4
145 .\}
146 .nf
147 # /usr/lib/systemd/systemd\-sysctl \-\-prefix kernel\&.core_pattern
148 .fi
149 .if n \{\
150 .RE
151 .\}
152 .PP
153 This searches all the directories listed in
154 \fBsysctl.d\fR(5)
155 for configuration files and writes
156 /proc/sys/kernel/core_pattern\&.
157 .PP
158 \fBExample\ \&4.\ \&Update coredump handler configuration according to a specific file\fR
159 .sp
160 .if n \{\
161 .RS 4
162 .\}
163 .nf
164 # /usr/lib/systemd/systemd\-sysctl 50\-coredump\&.conf
165 .fi
166 .if n \{\
167 .RE
168 .\}
169 .PP
170 This applies all the settings found in
171 50\-coredump\&.conf\&. Either
172 /etc/sysctl\&.d/50\-coredump\&.conf, or
173 /run/sysctl\&.d/50\-coredump\&.conf, or
174 /usr/lib/sysctl\&.d/50\-coredump\&.conf
175 will be used, in the order of preference\&.
176 .PP
177 See
178 \fBsysctl\fR(8)
179 for various ways to directly apply sysctl settings\&.
180 .SH "SEE ALSO"
181 .PP
182 \fBsystemd\fR(1), \fBsysctl.d\fR(5), \fBsysctl\fR(8)