blob: 1bedab498104af95a2f52257fe0ee728276fc092 [file] [log] [blame]
Jonathan Corbet7358bb22016-10-26 16:14:52 -06001The Linux kernel user's and administrator's guide
2=================================================
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -03003
Jonathan Corbet7358bb22016-10-26 16:14:52 -06004The following is a collection of user-oriented documents that have been
5added to the kernel over time. There is, as yet, little overall order or
6organization here this material was not written to be a single, coherent
7document! With luck things will improve quickly over time.
8
9This initial section contains overall information, including the README
10file describing the kernel as a whole, documentation on kernel parameters,
Mauro Carvalho Chehab337c1882016-11-07 17:03:18 -020011etc.
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030012
13.. toctree::
Jonathan Corbet7358bb22016-10-26 16:14:52 -060014 :maxdepth: 1
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030015
16 README
Jonathan Corbet7358bb22016-10-26 16:14:52 -060017 kernel-parameters
18 devices
Mauro Carvalho Chehab57043242019-04-22 16:48:00 -030019 sysctl/index
Jonathan Corbet7358bb22016-10-26 16:14:52 -060020
Mauro Carvalho Chehaba7ee04b2020-10-30 08:40:36 +010021 abi
Mauro Carvalho Chehab63fdc462020-11-30 16:36:34 +010022 features
Mauro Carvalho Chehaba7ee04b2020-10-30 08:40:36 +010023
Thomas Gleixner65fd4cb2019-02-19 11:10:49 +010024This section describes CPU vulnerabilities and their mitigations.
Thomas Gleixner3ec8ce52018-07-13 16:23:26 +020025
26.. toctree::
27 :maxdepth: 1
28
Thomas Gleixner65fd4cb2019-02-19 11:10:49 +010029 hw-vuln/index
Thomas Gleixner3ec8ce52018-07-13 16:23:26 +020030
Jonathan Corbet7358bb22016-10-26 16:14:52 -060031Here is a set of documents aimed at users who are trying to track down
32problems and bugs in particular.
33
34.. toctree::
35 :maxdepth: 1
Mauro Carvalho Chehab337c1882016-11-07 17:03:18 -020036
Thorsten Leemhuis3e544d72020-12-04 07:43:49 +010037 reporting-issues
Jonathan Corbet7358bb22016-10-26 16:14:52 -060038 security-bugs
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030039 bug-hunting
Mauro Carvalho Chehabc7309042016-11-07 17:03:17 -020040 bug-bisect
Mauro Carvalho Chehab337c1882016-11-07 17:03:18 -020041 tainted-kernels
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030042 ramoops
Mauro Carvalho Chehab9d850252016-09-21 09:51:11 -030043 dynamic-debug-howto
Jonathan Corbet7358bb22016-10-26 16:14:52 -060044 init
Mauro Carvalho Chehab330d4812019-06-13 15:21:39 -030045 kdump/index
Mauro Carvalho Chehab59809fe2019-06-18 16:06:08 -030046 perf/index
Daniel W. S. Almeida00d7c1e2020-07-18 13:51:03 -030047 pstore-blk
Jonathan Corbet7358bb22016-10-26 16:14:52 -060048
49This is the beginning of a section with information of interest to
50application developers. Documents covering various aspects of the kernel
51ABI will be found here.
52
53.. toctree::
54 :maxdepth: 1
Mauro Carvalho Chehab337c1882016-11-07 17:03:18 -020055
Jonathan Corbet7358bb22016-10-26 16:14:52 -060056 sysfs-rules
57
58The rest of this manual consists of various unordered guides on how to
59configure specific aspects of kernel behavior to your liking.
60
61.. toctree::
62 :maxdepth: 1
Mauro Carvalho Chehab337c1882016-11-07 17:03:18 -020063
Changbin Du680e6ff2019-04-25 23:30:54 +080064 acpi/index
Mauro Carvalho Chehab83bbf6e2019-06-27 12:59:40 -030065 aoe/index
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020066 auxdisplay/index
67 bcache
68 binderfs
69 binfmt-misc
70 blockdev/index
Masami Hiramatsu7b9b8162020-01-11 01:05:06 +090071 bootconfig
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020072 braille-console
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030073 btmrvl
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020074 cgroup-v1/index
75 cgroup-v2
76 cifs/index
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030077 clearing-warn-once
78 cpu-load
79 cputopology
Jonathan Neuschäferd4300c42019-10-12 19:11:10 +020080 dell_rbu
Mauro Carvalho Chehab6cf2a732019-06-18 12:40:23 -030081 device-mapper/index
Jonathan Neuschäfer320bfd92020-02-14 18:41:33 +010082 edid
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030083 efi-stub
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020084 ext4
Gabriel Krisman Bertazic0baf9a2021-10-25 16:27:46 -030085 filesystem-monitoring
Daniel W. S. Almeida2f123b9a2020-01-10 20:24:23 -030086 nfs/index
Mauro Carvalho Chehabc2746a12019-06-28 08:14:42 -030087 gpio/index
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030088 highuid
89 hw_random
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020090 initrd
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030091 iostats
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020092 java
93 jfs
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030094 kernel-per-CPU-kthreads
Mauro Carvalho Chehab9e1cbed2019-06-13 15:07:43 -030095 laptops/index
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -030096 lcd-panel-cgram
97 ldm
98 lockup-watchdogs
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +020099 LSM/index
100 md
Mauro Carvalho Chehab32e2eae2020-03-04 13:08:03 +0100101 media/index
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +0200102 mm/index
103 module-signing
104 mono
105 namespaces/index
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -0300106 numastat
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +0200107 parport
108 perf-security
109 pm/index
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -0300110 pnp
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +0200111 rapidio
112 ras
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -0300113 rtc
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +0200114 serial-console
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -0300115 svga
Gabriel Krisman Bertazia4452e62020-11-27 14:32:38 -0500116 syscall-user-dispatch
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +0200117 sysrq
118 thunderbolt
119 ufs
120 unicode
121 vga-softcursor
Mauro Carvalho Chehab4f4cfa62019-06-27 14:56:51 -0300122 video-output
Jonathan Neuschäfer2c1d7ff2019-10-12 19:11:09 +0200123 xfs
Markus Heiser6f2ec3a2016-10-26 08:23:16 +0200124
125.. only:: subproject and html
126
127 Indices
128 =======
129
130 * :ref:`genindex`