Debian Codegraph @

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

raw
1 '\" t
2 .TH "SYSTEMD\-SYSCTL\&.SERVICE" "8" "" "systemd 261~rc3" "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)\&. When invoked with positional arguments, the configuration specified by the command line arguments is executed\&. If the string
41 "\-"
42 is specified instead of a filename, the configuration is read from standard input\&. If the argument is a file name (without any slashes), all configuration directories are searched for a matching file and the file found that has the highest priority is executed\&. If the argument is a path, that file is used directly without searching the configuration directories for any other matching file\&.
43 .PP
44 In addition,
45 \fB\-\-prefix=\fR
46 option may be used to limit which sysctl settings are applied\&.
47 .PP
48 See
49 \fBsysctl.d\fR(5)
50 for information about the configuration of sysctl settings\&. After sysctl configuration is changed on disk, it must be written to the files in
51 /proc/sys/
52 before it takes effect\&. It is possible to update specific settings, or simply to reload all configuration, see Examples below\&.
53 .SH "OPTIONS"
54 .PP
55 \fB\-\-prefix=\fR
56 .RS 4
57 Only apply rules with the specified prefix\&.
58 .sp
59 Added in version 230\&.
60 .RE
61 .PP
62 \fB\-\-strict=\fR
63 .RS 4
64 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\&.
65 .sp
66 Added in version 252\&.
67 .RE
68 .PP
69 \fB\-\-inline\fR
70 .RS 4
71 Treat each positional argument as a separate configuration line instead of a file name\&.
72 .sp
73 Added in version 259\&.
74 .RE
75 .PP
76 \fB\-\-cat\-config\fR
77 .RS 4
78 Copy the contents of config files to standard output\&. Before each file, the filename is printed as a comment\&.
79 .RE
80 .PP
81 \fB\-\-tldr\fR
82 .RS 4
83 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\&.
84 .RE
85 .PP
86 \fB\-\-no\-pager\fR
87 .RS 4
88 Do not pipe output into a pager\&.
89 .RE
90 .PP
91 \fB\-h\fR, \fB\-\-help\fR
92 .RS 4
93 Print a short help text and exit\&.
94 .RE
95 .PP
96 \fB\-\-version\fR
97 .RS 4
98 Print a short version string and exit\&.
99 .RE
100 .SH "CREDENTIALS"
101 .PP
102 \fBsystemd\-sysctl\fR
103 supports the service credentials logic as implemented by
104 \fIImportCredential=\fR/\fILoadCredential=\fR/\fISetCredential=\fR
105 (see
106 \fBsystemd.exec\fR(5)
107 for details)\&. The following credentials are used when passed in:
108 .PP
109 \fIsysctl\&.extra\fR
110 .RS 4
111 The contents of this credential may contain additional lines to operate on\&. The credential contents should follow the same format as any other
112 sysctl\&.d/
113 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\&.
114 .sp
115 Added in version 252\&.
116 .RE
117 .PP
118 Note that by default the
119 systemd\-sysctl\&.service
120 unit file is set up to inherit the
121 "sysctl\&.extra"
122 credential from the service manager\&.
123 .SH "EXAMPLES"
124 .PP
125 \fBExample\ \&1.\ \&Reset all sysctl settings\fR
126 .sp
127 .if n \{\
128 .RS 4
129 .\}
130 .nf
131 systemctl restart systemd\-sysctl
132 .fi
133 .if n \{\
134 .RE
135 .\}
136 .PP
137 \fBExample\ \&2.\ \&View coredump handler configuration\fR
138 .sp
139 .if n \{\
140 .RS 4
141 .\}
142 .nf
143 # sysctl kernel\&.core_pattern
144 kernel\&.core_pattern = |/usr/libexec/abrt\-hook\-ccpp %s %c %p %u %g %t %P %I
145 .fi
146 .if n \{\
147 .RE
148 .\}
149 .PP
150 \fBExample\ \&3.\ \&Update coredump handler configuration\fR
151 .sp
152 .if n \{\
153 .RS 4
154 .\}
155 .nf
156 # /usr/lib/systemd/systemd\-sysctl \-\-prefix kernel\&.core_pattern
157 .fi
158 .if n \{\
159 .RE
160 .\}
161 .PP
162 This searches all the directories listed in
163 \fBsysctl.d\fR(5)
164 for configuration files and writes
165 /proc/sys/kernel/core_pattern\&.
166 .PP
167 \fBExample\ \&4.\ \&Update coredump handler configuration according to a specific file\fR
168 .sp
169 .if n \{\
170 .RS 4
171 .\}
172 .nf
173 # /usr/lib/systemd/systemd\-sysctl 50\-coredump\&.conf
174 .fi
175 .if n \{\
176 .RE
177 .\}
178 .PP
179 This applies all the settings found in
180 50\-coredump\&.conf\&. Either
181 /etc/sysctl\&.d/50\-coredump\&.conf, or
182 /run/sysctl\&.d/50\-coredump\&.conf, or
183 /usr/lib/sysctl\&.d/50\-coredump\&.conf
184 will be used, in the order of preference\&.
185 .PP
186 See
187 \fBsysctl\fR(8)
188 for various ways to directly apply sysctl settings\&.
189 .SH "SEE ALSO"
190 .PP
191 \fBsystemd\fR(1), \fBsysctl.d\fR(5), \fBsysctl\fR(8)