Thomas Gleixner | ec8f24b | 2019-05-19 13:07:45 +0100 | [diff] [blame] | 1 | # SPDX-License-Identifier: GPL-2.0-only |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 2 | config PROC_FS |
David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 3 | bool "/proc file system support" if EXPERT |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 4 | default y |
| 5 | help |
| 6 | This is a virtual file system providing information about the status |
| 7 | of the system. "Virtual" means that it doesn't take up any space on |
| 8 | your hard disk: the files are created on the fly by the kernel when |
| 9 | you try to access them. Also, you cannot read the files with older |
| 10 | version of the program less: you need to use more or cat. |
| 11 | |
| 12 | It's totally cool; for example, "cat /proc/interrupts" gives |
| 13 | information about what the different IRQs are used for at the moment |
| 14 | (there is a small number of Interrupt ReQuest lines in your computer |
| 15 | that are used by the attached devices to gain the CPU's attention -- |
| 16 | often a source of trouble if two devices are mistakenly configured |
| 17 | to use the same IRQ). The program procinfo to display some |
| 18 | information about your system gathered from the /proc file system. |
| 19 | |
| 20 | Before you can use the /proc file system, it has to be mounted, |
| 21 | meaning it has to be given a location in the directory hierarchy. |
| 22 | That location should be /proc. A command such as "mount -t proc proc |
| 23 | /proc" or the equivalent line in /etc/fstab does the job. |
| 24 | |
| 25 | The /proc file system is explained in the file |
Mauro Carvalho Chehab | 0c1bc6b | 2020-04-14 18:48:37 +0200 | [diff] [blame] | 26 | <file:Documentation/filesystems/proc.rst> and on the proc(5) manpage |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 27 | ("man 5 proc"). |
| 28 | |
| 29 | This option will enlarge your kernel by about 67 KB. Several |
| 30 | programs depend on this, so everyone should say Y here. |
| 31 | |
| 32 | config PROC_KCORE |
| 33 | bool "/proc/kcore support" if !ARM |
| 34 | depends on PROC_FS && MMU |
Omar Sandoval | 23c8509 | 2018-08-21 21:55:20 -0700 | [diff] [blame] | 35 | select CRASH_CORE |
Randy Dunlap | 1c3fc3e | 2013-11-12 15:11:16 -0800 | [diff] [blame] | 36 | help |
| 37 | Provides a virtual ELF core file of the live kernel. This can |
| 38 | be read with gdb and other ELF tools. No modifications can be |
| 39 | made using this mechanism. |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 40 | |
| 41 | config PROC_VMCORE |
WANG Cong | a4f7326 | 2010-10-26 14:21:21 -0700 | [diff] [blame] | 42 | bool "/proc/vmcore support" |
| 43 | depends on PROC_FS && CRASH_DUMP |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 44 | default y |
Krzysztof Kozlowski | 3d82191 | 2019-12-04 16:50:11 -0800 | [diff] [blame] | 45 | help |
| 46 | Exports the dump image of crashed kernel in ELF format. |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 47 | |
Rahul Lakkireddy | 2724273 | 2018-05-02 15:17:17 +0530 | [diff] [blame] | 48 | config PROC_VMCORE_DEVICE_DUMP |
| 49 | bool "Device Hardware/Firmware Log Collection" |
| 50 | depends on PROC_VMCORE |
| 51 | default n |
| 52 | help |
| 53 | After kernel panic, device drivers can collect the device |
| 54 | specific snapshot of their hardware or firmware before the |
| 55 | underlying devices are initialized in crash recovery kernel. |
| 56 | Note that the device driver must be present in the crash |
| 57 | recovery kernel's initramfs to collect its underlying device |
| 58 | snapshot. |
| 59 | |
| 60 | If you say Y here, the collected device dumps will be added |
Kairui Song | c6c4053 | 2019-07-16 16:26:39 -0700 | [diff] [blame] | 61 | as ELF notes to /proc/vmcore. You can still disable device |
| 62 | dump using the kernel command line option 'novmcoredd'. |
Rahul Lakkireddy | 2724273 | 2018-05-02 15:17:17 +0530 | [diff] [blame] | 63 | |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 64 | config PROC_SYSCTL |
David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 65 | bool "Sysctl support (/proc/sys)" if EXPERT |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 66 | depends on PROC_FS |
| 67 | select SYSCTL |
| 68 | default y |
Masahiro Yamada | a7f7f62 | 2020-06-14 01:50:22 +0900 | [diff] [blame] | 69 | help |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 70 | The sysctl interface provides a means of dynamically changing |
| 71 | certain kernel parameters and variables on the fly without requiring |
| 72 | a recompile of the kernel or reboot of the system. The primary |
| 73 | interface is through /proc/sys. If you say Y here a tree of |
| 74 | modifiable sysctl entries will be generated beneath the |
Krzysztof Kozlowski | 3d82191 | 2019-12-04 16:50:11 -0800 | [diff] [blame] | 75 | /proc/sys directory. They are explained in the files |
Mauro Carvalho Chehab | 5704324 | 2019-04-22 16:48:00 -0300 | [diff] [blame] | 76 | in <file:Documentation/admin-guide/sysctl/>. Note that enabling this |
Alexey Dobriyan | 6eedf8d | 2008-07-25 01:48:30 -0700 | [diff] [blame] | 77 | option will enlarge the kernel by at least 8 KB. |
| 78 | |
| 79 | As it is generally a good thing, you should say Y here unless |
| 80 | building a kernel for install/rescue disks or your system is very |
| 81 | limited in memory. |
Alexey Dobriyan | 53167a3 | 2008-10-03 02:01:51 +0400 | [diff] [blame] | 82 | |
| 83 | config PROC_PAGE_MONITOR |
| 84 | default y |
| 85 | depends on PROC_FS && MMU |
David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 86 | bool "Enable /proc page monitoring" if EXPERT |
Alexey Dobriyan | 53167a3 | 2008-10-03 02:01:51 +0400 | [diff] [blame] | 87 | help |
| 88 | Various /proc files exist to monitor process memory utilization: |
| 89 | /proc/pid/smaps, /proc/pid/clear_refs, /proc/pid/pagemap, |
| 90 | /proc/kpagecount, and /proc/kpageflags. Disabling these |
Krzysztof Kozlowski | 3d82191 | 2019-12-04 16:50:11 -0800 | [diff] [blame] | 91 | interfaces will reduce the size of the kernel by approximately 4kb. |
Iago López Galeiras | 2e13ba5 | 2015-06-25 15:00:57 -0700 | [diff] [blame] | 92 | |
| 93 | config PROC_CHILDREN |
| 94 | bool "Include /proc/<pid>/task/<tid>/children file" |
| 95 | default n |
Iago López Galeiras | db5d5b3 | 2015-07-17 16:23:23 -0700 | [diff] [blame] | 96 | help |
| 97 | Provides a fast way to retrieve first level children pids of a task. See |
Mauro Carvalho Chehab | 0c1bc6b | 2020-04-14 18:48:37 +0200 | [diff] [blame] | 98 | <file:Documentation/filesystems/proc.rst> for more information. |
Iago López Galeiras | db5d5b3 | 2015-07-17 16:23:23 -0700 | [diff] [blame] | 99 | |
| 100 | Say Y if you are running any user-space software which takes benefit from |
| 101 | this interface. For example, rkt is such a piece of software. |
Aubrey Li | 68bc30b | 2019-06-06 09:22:34 +0800 | [diff] [blame] | 102 | |
| 103 | config PROC_PID_ARCH_STATUS |
| 104 | def_bool n |
| 105 | depends on PROC_FS |
Chen Yu | e79f15a | 2020-01-15 17:28:51 +0800 | [diff] [blame] | 106 | |
| 107 | config PROC_CPU_RESCTRL |
| 108 | def_bool n |
| 109 | depends on PROC_FS |