Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
docs: admin-guide: bring some order to the "everything else" section
The bulk of the admin guide had become a big pile of stuff haphazardly
tossed together, mostly in the catch-all "everything else" section. Split
that section into a few broad categories and sort the documents into them
as appropriate.
No documents have been added or removed, they are just reordered. Note
that many of these documents are severely obsolete and should be considered
for removal.
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20241213182057.343527-4-corbet@lwn.net
+109
-70
+109
-70
Documentation/admin-guide/index.rst
+109
-70
Documentation/admin-guide/index.rst
···
18
18
:maxdepth: 1
19
19
20
20
README
21
-
kernel-parameters
22
21
devices
23
-
sysctl/index
24
22
25
23
features
26
24
27
-
This section describes CPU vulnerabilities and their mitigations.
25
+
A big part of the kernel's administrative interface is the /proc and sysfs
26
+
virtual filesystems; these documents describe how to interact with tem
27
+
28
+
.. toctree::
29
+
:maxdepth: 1
30
+
31
+
sysfs-rules
32
+
sysctl/index
33
+
cputopology
34
+
abi
35
+
36
+
Security-related documentation:
28
37
29
38
.. toctree::
30
39
:maxdepth: 1
31
40
32
41
hw-vuln/index
42
+
LSM/index
43
+
perf-security
44
+
45
+
Booting the kernel
46
+
------------------
47
+
48
+
.. toctree::
49
+
:maxdepth: 1
50
+
51
+
bootconfig
52
+
kernel-parameters
53
+
efi-stub
54
+
initrd
55
+
33
56
34
57
Tracking down and identifying problems
35
58
--------------------------------------
···
76
53
kdump/index
77
54
perf/index
78
55
pstore-blk
56
+
clearing-warn-once
57
+
kernel-per-CPU-kthreads
58
+
lockup-watchdogs
59
+
RAS/index
60
+
sysrq
79
61
80
-
sysfs
81
-
-----
82
62
83
-
A big part of the kernel's administrative interface is the sysfs virtual
84
-
filesystem; these documents describe how to interact with sysfs.
63
+
Core-kernel subsystems
64
+
----------------------
65
+
66
+
These documents describe core-kernel administration interfaces that are
67
+
likely to be of interest on almost any system.
85
68
86
69
.. toctree::
87
70
:maxdepth: 1
88
71
89
-
sysfs-rules
90
-
abi
72
+
cgroup-v2
73
+
cgroup-v1/index
74
+
cpu-load
75
+
mm/index
76
+
module-signing
77
+
namespaces/index
78
+
numastat
79
+
pm/index
80
+
syscall-user-dispatch
81
+
82
+
Support for non-native binary formats. Note that some of these
83
+
documents are ... old ...
84
+
85
+
.. toctree::
86
+
:maxdepth: 1
87
+
88
+
binfmt-misc
89
+
java
90
+
mono
91
+
92
+
93
+
Block-layer and filesystem administration
94
+
-----------------------------------------
95
+
96
+
.. toctree::
97
+
:maxdepth: 1
98
+
99
+
bcache
100
+
binderfs
101
+
blockdev/index
102
+
cifs/index
103
+
device-mapper/index
104
+
ext4
105
+
filesystem-monitoring
106
+
nfs/index
107
+
iostats
108
+
jfs
109
+
md
110
+
ufs
111
+
xfs
112
+
113
+
Device-specific guides
114
+
----------------------
115
+
116
+
How to configure your hardware within your Linux system.
117
+
118
+
.. toctree::
119
+
:maxdepth: 1
120
+
121
+
acpi/index
122
+
aoe/index
123
+
auxdisplay/index
124
+
braille-console
125
+
btmrvl
126
+
dell_rbu
127
+
edid
128
+
gpio/index
129
+
hw_random
130
+
laptops/index
131
+
lcd-panel-cgram
132
+
media/index
133
+
nvme-multipath
134
+
parport
135
+
pnp
136
+
rapidio
137
+
rtc
138
+
serial-console
139
+
svga
140
+
thermal/index
141
+
thunderbolt
142
+
vga-softcursor
143
+
video-output
91
144
92
145
Workload analysis
93
146
-----------------
···
182
83
Everything else
183
84
---------------
184
85
185
-
The rest of this manual consists of various unordered guides on how to
186
-
configure specific aspects of kernel behavior to your liking.
86
+
A few hard-to-categorize and generally obsolete documents.
187
87
188
88
.. toctree::
189
89
:maxdepth: 1
190
90
191
-
acpi/index
192
-
aoe/index
193
-
auxdisplay/index
194
-
bcache
195
-
binderfs
196
-
binfmt-misc
197
-
blockdev/index
198
-
bootconfig
199
-
braille-console
200
-
btmrvl
201
-
cgroup-v1/index
202
-
cgroup-v2
203
-
cifs/index
204
-
clearing-warn-once
205
-
cpu-load
206
-
cputopology
207
-
dell_rbu
208
-
device-mapper/index
209
-
edid
210
-
efi-stub
211
-
ext4
212
-
filesystem-monitoring
213
-
nfs/index
214
-
gpio/index
215
91
highuid
216
-
hw_random
217
-
initrd
218
-
iostats
219
-
java
220
-
jfs
221
-
kernel-per-CPU-kthreads
222
-
laptops/index
223
-
lcd-panel-cgram
224
92
ldm
225
-
lockup-watchdogs
226
-
LSM/index
227
-
md
228
-
media/index
229
-
mm/index
230
-
module-signing
231
-
mono
232
-
namespaces/index
233
-
numastat
234
-
parport
235
-
perf-security
236
-
pm/index
237
-
pnp
238
-
rapidio
239
-
RAS/index
240
-
rtc
241
-
serial-console
242
-
svga
243
-
syscall-user-dispatch
244
-
sysrq
245
-
thermal/index
246
-
thunderbolt
247
-
ufs
248
93
unicode
249
-
vga-softcursor
250
-
video-output
251
-
xfs
252
-
nvme-multipath
253
94
254
95
.. only:: subproject and html
255
96