emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

docs: Explain sysctl --system better

Browse Source 
The sysctl.8 manpage explained the directory order but not that the
files were then ordered and run in lexiographic order no matter
the directory name.

References:
 procps-ng/procps#200
This commit is contained in:
Craig Small 2021-03-29 22:07:08 +11:00
parent 6b8980a3b6
commit 6d08b92374
1 changed files with 28 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
sysctl.8
View File

@ -6,7 +6,7 @@
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details." .\" GNU General Public License for more details."
.TH SYSCTL "8" "2020-02-27" "procps-ng" "System Administration" .TH SYSCTL "8" "2021-03-29" "procps-ng" "System Administration"
.SH NAME .SH NAME
sysctl \- configure kernel parameters at runtime sysctl \- configure kernel parameters at runtime
.SH SYNOPSIS .SH SYNOPSIS
@ -76,22 +76,9 @@ values listing.
Print value without new line. Print value without new line.
.TP .TP
\fB\-\-system\fR \fB\-\-system\fR
Load settings from all system configuration files. Files are read from Load settings from all system configuration files. See the
directories in the following list in given order from top to bottom. .B SYSTEM FILE PRECEDENCE
Once a file of a given filename is loaded, any file of the same name section below.
in subsequent directories is ignored.
.br
/etc/sysctl.d/*.conf
.br
/run/sysctl.d/*.conf
.br
/usr/local/lib/sysctl.d/*.conf
.br
/usr/lib/sysctl.d/*.conf
.br
/lib/sysctl.d/*.conf
.br
/etc/sysctl.conf
.TP .TP
\fB\-r\fR, \fB\-\-pattern\fR \fIpattern\fR \fB\-r\fR, \fB\-\-pattern\fR \fIpattern\fR
Only apply settings that match Only apply settings that match
@ -123,6 +110,30 @@ Display help text and exit.
.TP .TP
\fB\-V\fR, \fB\-\-version\fR \fB\-V\fR, \fB\-\-version\fR
Display version information and exit. Display version information and exit.
.SH SYSTEM FILE PRECEDENCE
When using the \fB\-\-system\fR option,
.B sysctl
will read files from directories in the following list in given
order from top to bottom. Once a file of a given filename is loaded, any
file of the same name in subsequent directories is ignored.
/etc/sysctl.d/*.conf
.br
/run/sysctl.d/*.conf
.br
/usr/local/lib/sysctl.d/*.conf
.br
/usr/lib/sysctl.d/*.conf
.br
/lib/sysctl.d/*.conf
.br
/etc/sysctl.conf
All configuration files are sorted in lexicographic order, regardless of the
directory they reside in. Configuration files can either be completely
replaced (by having a new configuration file with the same name in a
directory of higher priority) or partially replaced (by having a configuration
file that is ordered later).
.SH EXAMPLES .SH EXAMPLES
/sbin/sysctl \-a /sbin/sysctl \-a
.br .br