1 .\" Copyright (C) 1994, 1995 by Daniel Quinlan (quinlan@yggdrasil.com)
2 .\" and Copyright (C) 2002-2008 Michael Kerrisk <mtk.manpages@gmail.com>
3 .\" with networking additions from Alan Cox (A.Cox@swansea.ac.uk)
4 .\" and scsi additions from Michael Neuffer (neuffer@mail.uni-mainz.de)
5 .\" and sysctl additions from Andries Brouwer (aeb@cwi.nl)
6 .\" and System V IPC (as well as various other) additions from
7 .\" Michael Kerrisk <mtk.manpages@gmail.com>
9 .\" This is free documentation; you can redistribute it and/or
10 .\" modify it under the terms of the GNU General Public License as
11 .\" published by the Free Software Foundation; either version 2 of
12 .\" the License, or (at your option) any later version.
14 .\" The GNU General Public License's references to "object code"
15 .\" and "executables" are to be interpreted as the output of any
16 .\" document formatting or typesetting system, including
17 .\" intermediate and printed output.
19 .\" This manual is distributed in the hope that it will be useful,
20 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
21 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
22 .\" GNU General Public License for more details.
24 .\" You should have received a copy of the GNU General Public
25 .\" License along with this manual; if not, write to the Free
26 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
29 .\" Modified 1995-05-17 by faith@cs.unc.edu
30 .\" Minor changes by aeb and Marty Leisner (leisner@sdsp.mc.xerox.com).
31 .\" Modified 1996-04-13, 1996-07-22 by aeb@cwi.nl
32 .\" Modified 2001-12-16 by rwhron@earthlink.net
33 .\" Modified 2002-07-13 by jbelton@shaw.ca
34 .\" Modified 2002-07-22, 2003-05-27, 2004-04-06, 2004-05-25
35 .\" by Michael Kerrisk <mtk.manpages@gmail.com>
36 .\" 2004-11-17, mtk -- updated notes on /proc/loadavg
37 .\" 2004-12-01, mtk, rtsig-max and rtsig-nr went away in 2.6.8
38 .\" 2004-12-14, mtk, updated 'statm', and fixed error in order of list
39 .\" 2005-05-12, mtk, updated 'stat'
40 .\" 2005-07-13, mtk, added /proc/sys/fs/mqueue/*
41 .\" 2005-09-16, mtk, Added /proc/sys/fs/suid_dumpable
42 .\" 2005-09-19, mtk, added /proc/zoneinfo
43 .\" 2005-03-01, mtk, moved /proc/sys/fs/mqueue/* material to mq_overview.7.
44 .\" 2008-06-05, mtk, Added /proc/[pid]/oom_score, /proc/[pid]/oom_adj,
45 .\" /proc/[pid]/limits, /proc/[pid]/mountinfo, /proc/[pid]/mountstats,
46 .\" and /proc/[pid]/fdinfo/*.
47 .\" 2008-06-19, mtk, Documented /proc/[pid]/status.
48 .\" 2008-07-15, mtk, added /proc/config.gz
50 .\" FIXME 2.6.13 seems to have /proc/vmcore implemented
51 .\" in the source code, but there is no option available under
52 .\" 'make xconfig'; eventually this should be fixed, and then info
53 .\" from the patch-2.6.13 and change log could be used to write an
54 .\" entry in this man page.
55 .\" Needs CONFIG_VMCORE
57 .\" FIXME cross check against Documentation/filesystems/proc.txt
58 .\" to see what information could be imported from that file
61 .TH PROC 5 2010-06-19 "Linux" "Linux Programmer's Manual"
63 proc \- process information pseudo-file system
67 file system is a pseudo-file system which is used as an interface to
68 kernel data structures.
69 It is commonly mounted at
71 Most of it is read-only, but some files allow kernel variables to be
74 The following outline gives a quick tour through the
80 There is a numerical subdirectory for each running process; the
81 subdirectory is named by the process ID.
82 Each such subdirectory contains the following
83 pseudo-files and directories.
84 .\" FIXME Describe /proc/[pid]/attr and
85 .\" /proc/[pid]/task/[tid]/attr
86 .\" This is a directory
91 .IR /proc/[pid]/auxv " (since 2.6.0-test7)"
92 This contains the contents of the ELF interpreter information passed
93 to the process at exec time.
94 The format is one \fIunsigned long\fP ID
95 plus one \fIunsigned long\fP value for each entry.
96 The last entry contains two zeros.
97 .\" FIXME Describe /proc/[pid]/cgroup and
98 .\" /proc/[pid]/task/[tid]/cgroup
99 .\" Info in Documentation/cgroups.txt
103 .\" FIXME Describe /proc/[pid]/clear_refs
105 .\" "Clears page referenced bits shown in smaps output"
107 .\" CONFIG_PROC_PAGE_MONITOR
109 .I /proc/[pid]/cmdline
110 This holds the complete command line for the process,
111 unless the process is a zombie.
112 .\" In 2.3.26, this also used to be true if the process was swapped out.
113 In the latter case, there is nothing in this file:
114 that is, a read on this file will return 0 characters.
115 The command-line arguments appear in this file as a set of
116 null-separated strings,
117 with a further null byte (\(aq\\0\(aq) after the last string.
119 .IR /proc/[pid]/coredump_filter " (since kernel 2.6.23)"
123 .IR /proc/[pid]/cpuset " (since kernel 2.6.12)"
124 .\" and/proc/[pid]/task/[tid]/cpuset
129 This is a symbolic link to the current working directory of the process.
130 To find out the current working directory of process 20,
131 for instance, you can do this:
135 .RB "$" " cd /proc/20/cwd; /bin/pwd"
141 command is often a shell built-in, and might
148 .\" The following was still true as at kernel 2.6.13
149 In a multithreaded process, the contents of this symbolic link
150 are not available if the main thread has already terminated
151 (typically by calling
152 .BR pthread_exit (3)).
154 .I /proc/[pid]/environ
155 This file contains the environment for the process.
156 The entries are separated by null bytes (\(aq\\0\(aq),
157 and there may be a null byte at the end.
158 Thus, to print out the environment of process 1, you would do:
163 .RB "$" " (cat /proc/1/environ; echo) | tr \(aq\e000\(aq \(aq\en\(aq"
169 Under Linux 2.2 and later, this file is a symbolic link
170 containing the actual pathname of the executed command.
171 This symbolic link can be dereferenced normally; attempting to open
172 it will open the executable.
175 to run another copy of the same executable as is being run by
177 .\" The following was still true as at kernel 2.6.13
178 In a multithreaded process, the contents of this symbolic link
179 are not available if the main thread has already terminated
180 (typically by calling
181 .BR pthread_exit (3)).
183 Under Linux 2.0 and earlier
185 is a pointer to the binary which was executed,
186 and appears as a symbolic link.
189 call on this file under Linux 2.0 returns a string in the format:
193 For example, [0301]:1502 would be inode 1502 on device major 03 (IDE,
194 MFM, etc. drives) minor 01 (first partition on the first drive).
199 option can be used to locate the file.
202 This is a subdirectory containing one entry for each file which the
203 process has open, named by its file descriptor, and which is a
204 symbolic link to the actual file.
205 Thus, 0 is standard input, 1 standard output, 2 standard error, etc.
207 .\" The following was still true as at kernel 2.6.13
208 In a multithreaded process, the contents of this directory
209 are not available if the main thread has already terminated
210 (typically by calling
211 .BR pthread_exit (3)).
213 Programs that will take a filename as a command-line argument,
214 but will not take input from standard input if no argument is supplied,
215 or that write to a file named as a command-line argument,
216 but will not send their output to standard output
217 if no argument is supplied, can nevertheless be made to use
218 standard input or standard out using
220 For example, assuming that
222 is the flag designating an input file and
224 is the flag designating an output file:
228 .RB "$" " foobar \-i /proc/self/fd/0 \-o /proc/self/fd/1 ..."
232 and you have a working filter.
233 .\" The following is not true in my tests (MTK):
234 .\" Note that this will not work for
235 .\" programs that seek on their files, as the files in the fd directory
236 .\" are not seekable.
239 is approximately the same as
241 in some Unix and Unix-like systems.
242 Most Linux MAKEDEV scripts symbolically link
248 Most systems provide symbolic links
253 which respectively link to the files
260 Thus the example command above could be written as:
264 .RB "$" " foobar \-i /dev/stdin \-o /dev/stdout ..."
267 .\" FIXME Describe /proc/[pid]/loginuid
268 .\" Added in 2.6.11; updating requires CAP_AUDIT_CONTROL
269 .\" CONFIG_AUDITSYSCALL
271 .IR /proc/[pid]/fdinfo/ " (since kernel 2.6.22)"
272 This is a subdirectory containing one entry for each file which the
273 process has open, named by its file descriptor.
274 The contents of each file can be read to obtain information
275 about the corresponding file descriptor, for example:
279 .RB "$" " cat /proc/12015/fdinfo/4"
287 field is a decimal number showing the current file offset.
290 field is an octal number that displays the
291 file access mode and file status flags (see
294 The files in this directory are readable only by the owner of the process.
295 .\" FIXME document /proc/[pid]/io
297 .\" .IR /proc/[pid]/io " (since kernel 2.6.20)"
299 .IR /proc/[pid]/limits " (since kernel 2.6.24)"
300 This file displays the soft limit, hard limit, and units of measurement
301 for each of the process's resource limits (see
303 The file is protected to only allow reading by the real UID of the process.
306 A file containing the currently mapped memory regions and their access
313 address perms offset dev inode pathname
314 08048000-08056000 r-xp 00000000 03:0c 64593 /usr/sbin/gpm
315 08056000-08058000 rw-p 0000d000 03:0c 64593 /usr/sbin/gpm
316 08058000-0805b000 rwxp 00000000 00:00 0
317 40000000-40013000 r-xp 00000000 03:0c 4165 /lib/ld-2.2.4.so
318 40013000-40015000 rw-p 00012000 03:0c 4165 /lib/ld-2.2.4.so
319 4001f000-40135000 r-xp 00000000 03:0c 45494 /lib/libc-2.2.4.so
320 40135000-4013e000 rw-p 00115000 03:0c 45494 /lib/libc-2.2.4.so
321 4013e000-40142000 rw-p 00000000 00:00 0
322 bffff000-c0000000 rwxp 00000000 00:00 0
326 where "address" is the address space in the process that it occupies,
327 "perms" is a set of permissions:
335 p = private (copy on write)
339 "offset" is the offset into the file/whatever, "dev" is the device
340 (major:minor), and "inode" is the inode on that device.
341 0 indicates that no inode is associated with the memory region,
342 as the case would be with BSS (uninitialized data).
344 Under Linux 2.0 there is no field giving pathname.
347 This file can be used to access the pages of a process's memory through
353 .IR /proc/[pid]/mountinfo " (since Linux 2.6.26)"
354 .\" This info adapted from Documentation/filesystems/proc.txt
355 This file contains information about mount points.
356 It contains lines of the form:
360 36 35 98:0 /mnt1 /mnt2 rw,noatime master:1 - ext3 /dev/root rw,errors=continue
361 (1)(2)(3) (4) (5) (6) (7) (8) (9) (10) (11)
365 The numbers in parentheses are labels for the descriptions below:
369 mount ID: unique identifier of the mount (may be reused after
373 parent ID: ID of parent mount (or of self for the top of the mount tree).
376 major:minor: value of
378 for files on file system (see
382 root: root of the mount within the file system.
385 mount point: mount point relative to the process's root.
388 mount options: per-mount options.
391 optional fields: zero or more fields of the form "tag[:value]".
394 separator: marks the end of the optional fields.
397 file system type: name of file system in the form "type[.subtype]".
400 mount source: file system-specific information or "none".
403 super options: per-super block options.
406 Parsers should ignore all unrecognized optional fields.
407 Currently the possible optional fields are:
411 mount is shared in peer group X
414 mount is slave to peer group X
417 mount is slave and receives propagation from peer group X (*)
423 (*) X is the closest dominant peer group under the process's root.
424 If X is the immediate master of the mount,
425 or if there is no dominant peer group under the same root,
426 then only the "master:X" field is present
427 and not the "propagate_from:X" field.
429 For more information on mount propagation see:
430 .I Documentation/filesystems/sharedsubtree.txt
431 in the kernel source tree.
433 .IR /proc/[pid]/mounts " (since Linux 2.4.19)"
434 This is a list of all the file systems currently mounted in the
435 process's mount namespace.
436 The format of this file is documented in
438 Since kernel version 2.6.15, this file is pollable:
439 after opening the file for reading, a change in this file
440 (i.e., a file system mount or unmount) causes
442 to mark the file descriptor as readable, and
446 mark the file as having an error condition.
448 .IR /proc/[pid]/mountstats " (since Linux 2.6.17)"
449 This file exports information (statistics, configuration information)
450 about the mount points in the process's name space.
451 Lines in this file have the form:
454 device /dev/sda7 mounted on /home with fstype ext3 [statistics]
458 The fields in each line are:
462 The name of the mounted device
463 (or "nodevice" if there is no corresponding device).
466 The mount point within the file system tree.
469 The file system type.
472 Optional statistics and configuration information.
473 Currently (as at Linux 2.6.26), only NFS file systems export
474 information via this field.
477 This file is only readable by the owner of the process.
479 .IR /proc/[pid]/numa_maps " (since Linux 2.6.14)"
483 .IR /proc/[pid]/oom_adj " (since Linux 2.6.11)"
484 This file can be used to adjust the score used to select which process
485 should be killed in an out-of-memory (OOM) situation.
486 The kernel uses this value for a bit-shift operation of the process's
489 valid values are in the range \-16 to +15,
490 plus the special value \-17,
491 which disables OOM-killing altogether for this process.
492 A positive score increases the likelihood of this
493 process being killed by the OOM-killer;
494 a negative score decreases the likelihood.
495 The default value for this file is 0;
496 a new process inherits its parent's
499 A process must be privileged
500 .RB ( CAP_SYS_RESOURCE )
503 .IR /proc/[pid]/oom_score " (since Linux 2.6.11)"
504 .\" See mm/oom_kill.c::badness() in the 2.6.25 sources
505 This file displays the current score that the kernel gives to
506 this process for the purpose of selecting a process
508 A higher score means that the process is more likely to be
509 selected by the OOM-killer.
510 The basis for this score is the amount of memory used by the process,
511 with increases (+) or decreases (\-) for factors including:
512 .\" See mm/oom_kill.c::badness() in the 2.6.25 sources
515 whether the process creates a lot of children using
519 whether the process has been running a long time,
520 or has used a lot of CPU time (\-);
522 whether the process has a low nice value (i.e., > 0) (+);
524 whether the process is privileged (\-); and
525 .\" More precisely, if it has CAP_SYS_ADMIN or CAP_SYS_RESOURCE
527 whether the process is making direct hardware access (\-).
528 .\" More precisely, if it has CAP_SYS_RAWIO
533 also reflects the bit-shift adjustment specified by the
535 setting for the process.
536 .\" FIXME Describe /proc/[pid]/pagemap
538 .\" CONFIG_PROC_PAGE_MONITOR
541 Unix and Linux support the idea of a per-process root of the
542 file system, set by the
545 This file is a symbolic link that points to the process's
546 root directory, and behaves as exe, fd/*, etc. do.
548 .\" The following was still true as at kernel 2.6.13
549 In a multithreaded process, the contents of this symbolic link
550 are not available if the main thread has already terminated
551 (typically by calling
552 .BR pthread_exit (3)).
553 .\" FIXME Describe /proc/[pid]/seccomp
555 .\" FIXME Describe /proc/[pid]/sessionid
556 .\" Added in 2.6.25; read-only; only readable by real UID
557 .\" CONFIG_AUDITSYSCALL
558 .\" FIXME Describe /proc/[pid]/sched
560 .\" CONFIG_SCHED_DEBUG, and additional fields if CONFIG_SCHEDSTATS
561 .\" Displays various scheduling parameters
562 .\" This file can be written, to reset stats
563 .\" FIXME Describe /proc/[pid]/schedstats and
564 .\" /proc/[pid]/task/[tid]/schedstats
566 .\" CONFIG_SCHEDSTATS
568 .IR /proc/[pid]/smaps " (since Linux 2.6.14)"
569 .\" CONFIG_PROC_PAGE_MONITOR
570 This file shows memory consumption for each of the process's mappings.
571 For each of mappings there is a series of lines such as the following:
575 08048000-080bc000 r-xp 00000000 03:02 13130 /bin/bash
585 The first of these lines shows the same information as is displayed
587 .IR /proc/[pid]/maps .
588 The remaining lines show the size of the mapping,
589 the amount of the mapping that is currently resident in RAM,
590 the number of clean and dirty shared pages in the mapping,
591 and the number of clean and dirty private pages in the mapping.
593 This file is only present if the
599 Status information about the process.
603 .IR /usr/src/linux/fs/proc/array.c "."
605 The fields, in order, with their proper
607 format specifiers, are:
614 The filename of the executable, in parentheses.
615 This is visible whether or not the executable is swapped out.
618 One character from the string "RSDZTW" where R is running, S is
619 sleeping in an interruptible wait, D is waiting in uninterruptible
620 disk sleep, Z is zombie, T is traced or stopped (on a signal),
624 The PID of the parent.
627 The process group ID of the process.
630 The session ID of the process.
633 The controlling terminal of the process.
634 (The minor device number is contained in the combination of bits
636 the major device number is in bits 15 to 8.)
639 .\" This field and following, up to and including wchan added 0.99.1
640 The ID of the foreground process group of the controlling
641 terminal of the process.
643 \fIflags\fP %u (%lu before Linux 2.6.22)
644 The kernel flags word of the process.
646 see the PF_* defines in
647 .IR <linux/sched.h> .
648 Details depend on the kernel version.
651 The number of minor faults the process has made which have not
652 required loading a memory page from disk.
656 The number of minor faults that the process's
657 waited-for children have made.
660 The number of major faults the process has made which have
661 required loading a memory page from disk.
664 The number of major faults that the process's
665 waited-for children have made.
668 Amount of time that this process has been scheduled in user mode,
669 measured in clock ticks (divide by
670 .IR sysconf(_SC_CLK_TCK) .
671 This includes guest time, \fIguest_time\fP
672 (time spent running a virtual CPU, see below),
673 so that applications that are not aware of the guest time field
674 do not lose that time from their calculations.
677 Amount of time that this process has been scheduled in kernel mode,
678 measured in clock ticks (divide by
679 .IR sysconf(_SC_CLK_TCK) .
682 Amount of time that this process's
683 waited-for children have been scheduled in user mode,
684 measured in clock ticks (divide by
685 .IR sysconf(_SC_CLK_TCK) .
688 This includes guest time, \fIcguest_time\fP
689 (time spent running a virtual CPU, see below).
692 Amount of time that this process's
693 waited-for children have been scheduled in kernel mode,
694 measured in clock ticks (divide by
695 .IR sysconf(_SC_CLK_TCK) .
698 (Explanation for Linux 2.6)
699 For processes running a real-time scheduling policy
702 .BR sched_setscheduler (2)),
703 this is the negated scheduling priority, minus one;
704 that is, a number in the range \-2 to \-100,
705 corresponding to real-time priorities 1 to 99.
706 For processes running under a non-real-time scheduling policy,
707 this is the raw nice value
708 .RB ( setpriority (2))
709 as represented in the kernel.
710 The kernel stores nice values as numbers
711 in the range 0 (high) to 39 (low),
712 corresponding to the user-visible nice range of \-20 to 19.
714 Before Linux 2.6, this was a scaled value based on
715 the scheduler weighting given to this process.
716 .\" And back in kernel 1.2 days things were different again.
720 .BR setpriority (2)),
721 a value in the range 19 (low priority) to \-20 (high priority).
722 .\" Back in kernel 1.2 days things were different.
725 .\" \fIcounter\fP %ld
726 .\" The current maximum size in jiffies of the process's next timeslice,
727 .\" or what is currently left of its current timeslice, if it is the
728 .\" currently running process.
731 .\" The time in jiffies of the process's next timeout.
732 .\" timeout was removed sometime around 2.1/2.2
733 \fInum_threads\fP %ld
734 Number of threads in this process (since Linux 2.6).
735 Before kernel 2.6, this field was hard coded to 0 as a placeholder
736 for an earlier removed field.
739 \fIitrealvalue\fP %ld
740 The time in jiffies before the next
742 is sent to the process due to an interval timer.
743 Since kernel 2.6.17, this field is no longer maintained,
744 and is hard coded as 0.
746 \fIstarttime\fP %llu (was %lu before Linux 2.6)
747 The time in jiffies the process started after system boot.
750 Virtual memory size in bytes.
753 Resident Set Size: number of pages the process has in real memory.
754 This is just the pages which
755 count towards text, data, or stack space.
756 This does not include pages
757 which have not been demand-loaded in, or which are swapped out.
760 Current soft limit in bytes on the rss of the process;
761 see the description of
767 The address above which program text can run.
770 The address below which program text can run.
773 The address of the start (i.e., bottom) of the stack.
776 The current value of ESP (stack pointer), as found in the
777 kernel stack page for the process.
780 The current EIP (instruction pointer).
784 The bitmap of pending signals, displayed as a decimal number.
785 Obsolete, because it does not provide information on real-time signals; use
786 .I /proc/[pid]/status
790 The bitmap of blocked signals, displayed as a decimal number.
791 Obsolete, because it does not provide information on real-time signals; use
792 .I /proc/[pid]/status
796 The bitmap of ignored signals, displayed as a decimal number.
797 Obsolete, because it does not provide information on real-time signals; use
798 .I /proc/[pid]/status
802 The bitmap of caught signals, displayed as a decimal number.
803 Obsolete, because it does not provide information on real-time signals; use
804 .I /proc/[pid]/status
808 This is the "channel" in which the process is waiting.
810 address of a system call, and can be looked up in a namelist if you
812 (If you have an up-to-date
813 .IR /etc/psdatabase ,
815 try \fIps \-l\fP to see the WCHAN field in action.)
818 .\" nswap was added in 2.0
819 Number of pages swapped (not maintained).
822 .\" cnswap was added in 2.0
823 Cumulative \fInswap\fP for child processes (not maintained).
825 \fIexit_signal\fP %d (since Linux 2.1.22)
826 Signal to be sent to parent when we die.
828 \fIprocessor\fP %d (since Linux 2.2.8)
829 CPU number last executed on.
831 \fIrt_priority\fP %u (since Linux 2.5.19; was %lu before Linux 2.6.22)
832 Real-time scheduling priority, a number in the range 1 to 99 for
833 processes scheduled under a real-time policy,
834 or 0, for non-real-time processes (see
835 .BR sched_setscheduler (2)).
838 \fIpolicy\fP %u (since Linux 2.5.19; was %lu before Linux 2.6.22)
839 Scheduling policy (see
840 .BR sched_setscheduler (2)).
841 Decode using the SCHED_* constants in
844 \fIdelayacct_blkio_ticks\fP %llu (since Linux 2.6.18)
845 Aggregated block I/O delays, measured in clock ticks (centiseconds).
847 \fIguest_time\fP %lu (since Linux 2.6.24)
848 Guest time of the process (time spent running a virtual CPU
849 for a guest operating system), measured in clock ticks (divide by
850 .IR sysconf(_SC_CLK_TCK) .
852 \fIcguest_time\fP %ld (since Linux 2.6.24)
853 Guest time of the process's children, measured in clock ticks (divide by
854 .IR sysconf(_SC_CLK_TCK) .
858 Provides information about memory usage, measured in pages.
863 size total program size
864 (same as VmSize in \fI/proc/[pid]/status\fP)
865 resident resident set size
866 (same as VmRSS in \fI/proc/[pid]/status\fP)
867 share shared pages (from shared mappings)
869 .\" (not including libs; broken, includes data segment)
870 lib library (unused in Linux 2.6)
872 .\" (including libs; broken, includes library text)
873 dt dirty pages (unused in Linux 2.6)
877 .I /proc/[pid]/status
878 Provides much of the information in
882 in a format that's easier for humans to parse.
887 .RB "$" " cat /proc/$$/status"
894 Uid: 1000 1000 1000 1000
910 SigPnd: 0000000000000000
911 ShdPnd: 0000000000000000
912 SigBlk: 0000000000010000
913 SigIgn: 0000000000384004
914 SigCgt: 000000004b813efb
915 CapInh: 0000000000000000
916 CapPrm: 0000000000000000
917 CapEff: 0000000000000000
918 CapBnd: ffffffffffffffff
919 Cpus_allowed: 00000001
923 voluntary_ctxt_switches: 150
924 nonvoluntary_ctxt_switches: 545
928 The fields are as follows:
932 Command run by this process.
935 Current state of the process. One of
946 Thread group ID (i.e., Process ID).
953 PID of process tracing this process (0 if not being traced).
956 Real, effective, saved set, and file system UIDs (GIDs).
959 Number of file descriptor slots currently allocated.
962 Supplementary group list.
965 Peak virtual memory size.
974 Peak resident set size ("high water mark").
979 .IR VmData ", " VmStk ", " VmExe :
980 Size of data, stack, and text segments.
983 Shared library code size.
986 Page table entries size (since Linux 2.6.10).
989 Number of threads in process containing this thread.
991 .IR SigPnd ", " ShdPnd :
992 Number of signals pending for thread and for process as a whole (see
997 .IR SigBlk ", " SigIgn ", " SigCgt :
998 Masks indicating signals being blocked, ignored, and caught (see
1001 .IR CapInh ", " CapPrm ", " CapEff :
1002 Masks of capabilities enabled in inheritable, permitted, and effective sets
1004 .BR capabilities (7)).
1007 Capability Bounding set
1008 (since kernel 2.6.26, see
1009 .BR capabilities (7)).
1012 Mask of CPUs on which this process may run
1013 (since Linux 2.6.24, see
1016 .IR Cpus_allowed_list :
1017 Same as previous, but in "list format"
1018 (since Linux 2.6.26, see
1022 Mask of memory nodes allowed to this process
1023 (since Linux 2.6.24, see
1026 .IR Mems_allowed_list :
1027 Same as previous, but in "list format"
1028 (since Linux 2.6.26, see
1031 .IR voluntary_context_switches ", " nonvoluntary_context_switches :
1032 Number of voluntary and involuntary context switches (since Linux 2.6.23).
1035 .IR /proc/[pid]/task " (since Linux 2.6.0-test6)"
1036 This is a directory that contains one subdirectory
1037 for each thread in the process.
1038 The name of each subdirectory is the numerical thread ID
1042 Within each of these subdirectories, there is a set of
1043 files with the same names and contents as under the
1046 For attributes that are shared by all threads, the contents for
1047 each of the files under the
1049 subdirectories will be the same as in the corresponding
1053 (e.g., in a multithreaded process, all of the
1055 files will have the same value as the
1057 file in the parent directory, since all of the threads in a process
1058 share a working directory).
1059 For attributes that are distinct for each thread,
1060 the corresponding files under
1062 may have different values (e.g., various fields in each of the
1063 .I task/[tid]/status
1064 files may be different for each thread).
1066 .\" The following was still true as at kernel 2.6.13
1067 In a multithreaded process, the contents of the
1069 directory are not available if the main thread has already terminated
1070 (typically by calling
1071 .BR pthread_exit (3)).
1074 Advanced power management version and battery information when
1076 is defined at kernel compilation time.
1079 Contains subdirectories for installed busses.
1082 Subdirectory for PCMCIA devices when
1084 is set at kernel compilation time.
1086 .I /proc/bus/pccard/drivers
1089 Contains various bus subdirectories and pseudo-files containing
1090 information about PCI busses, installed devices, and device
1092 Some of these files are not ASCII.
1094 .I /proc/bus/pci/devices
1095 Information about PCI devices.
1096 They may be accessed through
1102 Arguments passed to the Linux kernel at boot time.
1103 Often done via a boot manager such as
1108 .IR /proc/config.gz " (since Linux 2.6)"
1109 This file exposes the configuration options that were used
1110 to build the currently running kernel,
1111 in the same format as they would be shown in the
1113 file that resulted when configuring the kernel (using
1114 .IR "make xconfig" ,
1117 The file contents are compressed; view or search them using
1121 As long as no changes have been made to the following file,
1124 are the same as those provided by :
1128 cat /lib/modules/$(uname -r)/build/.config
1133 is only provided if the kernel is configured with
1134 .BR CONFIG_IKCONFIG_PROC .
1137 This is a collection of CPU and system architecture dependent items,
1138 for each supported architecture a different list.
1139 Two common entries are \fIprocessor\fP which gives CPU number and
1140 \fIbogomips\fP; a system constant that is calculated
1141 during kernel initialization.
1142 SMP machines have information for
1146 Text listing of major numbers and device groups.
1147 This can be used by MAKEDEV scripts for consistency with the kernel.
1149 .IR /proc/diskstats " (since Linux 2.5.69)"
1150 This file contains disk I/O statistics for each disk device.
1151 See the kernel source file
1152 .I Documentation/iostats.txt
1153 for further information.
1156 This is a list of the registered \fIISA\fP DMA (direct memory access)
1162 .I /proc/execdomains
1163 List of the execution domains (ABI personalities).
1166 Frame buffer information when
1168 is defined during kernel compilation.
1170 .I /proc/filesystems
1171 A text listing of the file systems which are supported by the kernel,
1172 namely file systems which were compiled into the kernel or whose kernel
1173 modules are currently loaded.
1175 .BR filesystems (5).)
1176 If a file system is marked with "nodev",
1177 this means that it does not require a block device to be mounted
1178 (e.g., virtual file system, network file system).
1180 Incidentally, this file may be used by
1182 when no file system is specified and it didn't manage to determine the
1184 Then file systems contained in this file are tried
1185 (excepted those that are marked with "nodev").
1192 exists on systems with the IDE bus.
1193 There are directories for each IDE channel and attached device.
1198 cache buffer size in KB
1199 capacity number of sectors
1200 driver driver version
1201 geometry physical and logical geometry
1202 identify in hexadecimal
1204 model manufacturer's model number
1205 settings drive settings
1206 smart_thresholds in hexadecimal
1207 smart_values in hexadecimal
1213 utility provides access to this information in a friendly format.
1216 This is used to record the number of interrupts per CPU per IO device.
1218 for the i386 and x86_64 architectures, at least, this also includes
1219 interrupts internal to the system (that is, not associated with a device
1220 as such), such as NMI (nonmaskable interrupt), LOC (local timer interrupt),
1221 and for SMP systems, TLB (TLB flush interrupt), RES (rescheduling
1222 interrupt), CAL (remote function call interrupt), and possibly others.
1223 Very easy to read formatting, done in ASCII.
1226 I/O memory map in Linux 2.4.
1229 This is a list of currently registered Input-Output port regions that
1232 .IR /proc/kallsyms " (since Linux 2.5.71)"
1233 This holds the kernel exported symbol definitions used by the
1235 tools to dynamically link and bind loadable modules.
1236 In Linux 2.5.47 and earlier, a similar file with slightly different syntax
1241 This file represents the physical memory of the system and is stored
1242 in the ELF core file format.
1243 With this pseudo-file, and an unstripped
1245 .RI ( /usr/src/linux/vmlinux )
1246 binary, GDB can be used to
1247 examine the current state of any kernel data structures.
1249 The total length of the file is the size of physical memory (RAM) plus
1253 This file can be used instead of the
1255 system call to read kernel messages.
1256 A process must have superuser
1257 privileges to read this file, and only one process should read this
1259 This file should not be read if a syslog process is running
1262 system call facility to log kernel messages.
1264 Information in this file is retrieved with the
1268 .IR /proc/ksyms " (Linux 1.1.23-2.5.47)"
1270 .IR /proc/kallsyms .
1273 The first three fields in this file are load average figures
1274 giving the number of jobs in the run queue (state R)
1275 or waiting for disk I/O (state D) averaged over 1, 5, and 15 minutes.
1276 They are the same as the load average numbers given by
1279 The fourth field consists of two numbers separated by a slash (/).
1280 The first of these is the number of currently executing kernel
1281 scheduling entities (processes, threads);
1282 this will be less than or equal to the number of CPUs.
1283 The value after the slash is the number of kernel scheduling entities
1284 that currently exist on the system.
1285 The fifth field is the PID of the process that was most
1286 recently created on the system.
1289 This file shows current file locks
1290 .RB ( flock "(2) and " fcntl (2))
1294 .IR /proc/malloc " (only up to and including Linux 2.2)"
1295 .\" It looks like this only ever did something back in 1.0 days
1296 This file is only present if
1297 .B CONFIG_DEBUG_MALLOC
1298 was defined during compilation.
1301 This file reports statistics about memory usage on the system.
1304 to report the amount of free and used memory (both physical and swap)
1305 on the system as well as the shared memory and buffers used by the
1309 A text list of the modules that have been loaded by the system.
1314 Before kernel 2.4.19, this file was a list
1315 of all the file systems currently mounted on the system.
1316 With the introduction of per-process mount namespaces in
1317 Linux 2.4.19, this file became a link to
1318 .IR /proc/self/mounts ,
1319 which lists the mount points of the process's own mount namespace.
1320 The format of this file is documented in
1324 Memory Type Range Registers.
1325 See the kernel source file
1326 .I Documentation/mtrr.txt
1330 various net pseudo-files, all of which give the status of some part of
1331 the networking layer.
1332 These files contain ASCII structures and are,
1333 therefore, readable with
1335 However, the standard
1337 suite provides much cleaner access to these files.
1340 This holds an ASCII readable dump of the kernel ARP table used for
1341 address resolutions.
1342 It will show both dynamically learned and preprogrammed ARP entries.
1348 IP address HW type Flags HW address Mask Device
1349 192.168.0.50 0x1 0x2 00:50:BF:25:68:F3 * eth0
1350 192.168.0.250 0x1 0xc 00:00:00:00:00:00 * eth0
1355 Here "IP address" is the IPv4 address of the machine and the "HW type"
1356 is the hardware type of the address from RFC\ 826.
1357 The flags are the internal
1358 flags of the ARP structure (as defined in
1359 .IR /usr/include/linux/if_arp.h )
1361 the "HW address" is the data link layer mapping for that IP address if
1365 The dev pseudo-file contains network device status information.
1367 the number of received and sent packets, the number of errors and
1369 and other basic statistics.
1370 These are used by the
1372 program to report device status.
1378 Inter-| Receive | Transmit
1379 face |bytes packets errs drop fifo frame compressed multicast|bytes packets errs drop fifo colls carrier compressed
1380 lo: 2776770 11307 0 0 0 0 0 0 2776770 11307 0 0 0 0 0 0
1381 eth0: 1215645 2751 0 0 0 0 0 0 1782404 4324 0 0 0 427 0 0
1382 ppp0: 1622270 5552 1 0 0 0 0 0 354130 5669 0 0 0 0 0 0
1383 tap0: 7714 81 0 0 0 0 0 0 7714 81 0 0 0 0 0 0
1388 .\" .I /proc/net/ipx
1391 .\" .I /proc/net/ipx_route
1394 .I /proc/net/dev_mcast
1396 .IR /usr/src/linux/net/core/dev_mcast.c :
1399 indx interface_name dmi_u dmi_g dmi_address
1400 2 eth0 1 0 01005e000001
1401 3 eth1 1 0 01005e000001
1402 4 eth2 1 0 01005e000001
1407 Internet Group Management Protocol.
1409 .IR /usr/src/linux/net/core/igmp.c .
1412 This file uses the same format as the
1414 file and contains the current reverse mapping database used to provide
1416 reverse address lookup services.
1417 If RARP is not configured into the
1419 this file will not be present.
1422 Holds a dump of the RAW socket table.
1423 Much of the information is not of
1425 apart from debugging.
1426 The "sl" value is the kernel hash slot for the
1428 the "local_address" is the local address and protocol number pair.
1430 the internal status of the socket.
1431 The "tx_queue" and "rx_queue" are the
1432 outgoing and incoming data queue in terms of kernel memory usage.
1433 The "tr", "tm\->when", and "rexmits" fields are not used by RAW.
1435 field holds the effective UID of the creator of the socket.
1437 .\" .I /proc/net/route
1438 .\" No information, but looks similar to
1442 This file holds the ASCII data needed for the IP, ICMP, TCP, and UDP
1444 information bases for an SNMP agent.
1447 Holds a dump of the TCP socket table.
1448 Much of the information is not
1449 of use apart from debugging.
1450 The "sl" value is the kernel hash slot
1451 for the socket, the "local_address" is the local address and port number pair.
1452 The "rem_address" is the remote address and port number pair
1454 \&"St" is the internal status of the socket.
1455 The "tx_queue" and "rx_queue" are the
1456 outgoing and incoming data queue in terms of kernel memory usage.
1457 The "tr", "tm\->when", and "rexmits" fields hold internal information of
1458 the kernel socket state and are only useful for debugging.
1460 field holds the effective UID of the creator of the socket.
1463 Holds a dump of the UDP socket table.
1464 Much of the information is not of
1465 use apart from debugging.
1466 The "sl" value is the kernel hash slot for the
1467 socket, the "local_address" is the local address and port number pair.
1468 The "rem_address" is the remote address and port number pair
1469 (if connected). "St" is the internal status of the socket.
1470 The "tx_queue" and "rx_queue" are the outgoing and incoming data queue
1471 in terms of kernel memory usage.
1472 The "tr", "tm\->when", and "rexmits" fields
1473 are not used by UDP.
1475 field holds the effective UID of the creator of the socket.
1481 sl local_address rem_address st tx_queue rx_queue tr rexmits tm\->when uid
1482 1: 01642C89:0201 0C642C89:03FF 01 00000000:00000001 01:000071BA 00000000 0
1483 1: 00000000:0801 00000000:0000 0A 00000000:00000000 00:00000000 6F000100 0
1484 1: 00000000:0201 00000000:0000 0A 00000000:00000000 00:00000000 00000000 0
1490 Lists the Unix domain sockets present within the system and their
1496 Num RefCount Protocol Flags Type St Path
1497 0: 00000002 00000000 00000000 0001 03
1498 1: 00000001 00000000 00010000 0001 01 /dev/printer
1503 Here "Num" is the kernel table slot number, "RefCount" is the number
1504 of users of the socket, "Protocol" is currently always 0, "Flags"
1505 represent the internal kernel flags holding the status of the
1507 Currently, type is always "1" (Unix domain datagram sockets are
1508 not yet supported in the kernel).
1509 \&"St" is the internal state of the
1510 socket and Path is the bound path (if any) of the socket.
1513 Contains major and minor numbers of each partition as well as number
1514 of blocks and partition name.
1517 This is a listing of all PCI devices found during kernel initialization
1518 and their configuration.
1520 This file has been deprecated in favor of a new
1523 .RI ( /proc/bus/pci ).
1524 It became optional in Linux 2.2 (available with
1525 .B CONFIG_PCI_OLD_PROC
1526 set at kernel compilation).
1527 It became once more nonoptionally enabled in Linux 2.4.
1528 Next, it was deprecated in Linux 2.6 (still available with
1529 .B CONFIG_PCI_LEGACY_PROC
1530 set), and finally removed altogether since Linux 2.6.17.
1531 .\" FIXME /proc/sched_debug
1533 .\" .IR /proc/sched_debug " (since Linux 2.6.23)"
1534 .\" See also /proc/[pid]/sched
1537 A directory with the
1539 mid-level pseudo-file and various SCSI low-level
1541 which contain a file for each SCSI host in this system, all of
1542 which give the status of some part of the SCSI IO subsystem.
1543 These files contain ASCII structures and are, therefore, readable with
1546 You can also write to some of the files to reconfigure the subsystem or
1547 switch certain features on or off.
1550 This is a listing of all SCSI devices known to the kernel.
1551 The listing is similar to the one seen during bootup.
1552 scsi currently supports only the \fIadd-single-device\fP command which
1553 allows root to add a hotplugged device to the list of known devices.
1559 echo \(aqscsi add-single-device 1 0 5 0\(aq > /proc/scsi/scsi
1564 host scsi1 to scan on SCSI channel 0 for a device on ID 5 LUN 0.
1566 is already a device known on this address or the address is invalid, an
1567 error will be returned.
1569 .I /proc/scsi/[drivername]
1570 \fI[drivername]\fP can currently be NCR53c7xx, aha152x, aha1542, aha1740,
1571 aic7xxx, buslogic, eata_dma, eata_pio, fdomain, in2000, pas16, qlogic,
1572 scsi_debug, seagate, t128, u15-24f, ultrastore, or wd7000.
1573 These directories show up for all drivers that registered at least one
1575 Every directory contains one file per registered host.
1576 Every host-file is named after the number the host was assigned during
1579 Reading these files will usually show driver and host configuration,
1582 Writing to these files allows different things on different hosts.
1583 For example, with the \fIlatency\fP and \fInolatency\fP commands,
1584 root can switch on and off command latency measurement code in the
1586 With the \fIlockup\fP and \fIunlock\fP commands,
1587 root can control bus lockups simulated by the scsi_debug driver.
1590 This directory refers to the process accessing the
1593 and is identical to the
1595 directory named by the process ID of the same process.
1598 Information about kernel caches.
1599 Since Linux 2.6.16 this file is only present if the
1601 kernel configuration option is enabled.
1623 kernel/system statistics.
1624 Varies with architecture.
1629 \fIcpu 3357 0 4313 1362393\fP
1630 The amount of time, measured in units of
1631 USER_HZ (1/100ths of a second on most architectures, use
1632 .IR sysconf(_SC_CLK_TCK)
1633 to obtain the right value),
1634 .\" 1024 on Alpha and ia64
1635 that the system spent in user mode,
1636 user mode with low priority (nice), system mode, and the
1637 idle task, respectively.
1638 .\" FIXME Actually, the following info about the /proc/stat 'cpu' field
1639 .\" does not seem to be quite right (at least in 2.6.12)
1640 The last value should be USER_HZ times the
1641 second entry in the uptime pseudo-file.
1643 In Linux 2.6 this line includes three additional columns:
1645 \- time waiting for I/O to complete (since 2.5.41);
1647 \- time servicing interrupts (since 2.6.0-test4);
1649 \- time servicing softirqs (since 2.6.0-test4).
1651 Since Linux 2.6.11, there is an eighth column,
1653 \- stolen time, which is the time spent in other operating systems when
1654 running in a virtualized environment
1656 Since Linux 2.6.24, there is a ninth column,
1658 which is the time spent running a virtual CPU for guest
1659 operating systems under the control of the Linux kernel.
1660 .\" See Changelog entry for 5e84cfde51cf303d368fcb48f22059f37b3872de
1662 \fIpage 5741 1808\fP
1663 The number of pages the system paged in and the number that were paged
1667 The number of swap pages that have been brought in and out.
1669 .\" FIXME The following is not the full picture for the 'intr' of
1670 .\" /proc/stat on 2.6:
1672 This line shows counts of interrupts serviced since boot time,
1673 for each of the possible system interrupts.
1674 The first column is the total of all interrupts serviced;
1675 each subsequent column is the total for a particular interrupt.
1677 \fIdisk_io: (2,0):(31,30,5764,1,2) (3,0):\fP...
1678 (major,disk_idx):(noinfo, read_io_ops, blks_read, write_io_ops, blks_written)
1683 The number of context switches that the system underwent.
1685 \fIbtime 769041601\fP
1686 boot time, in seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
1688 \fIprocesses 86031\fP
1689 Number of forks since boot.
1691 \fIprocs_running 6\fP
1692 Number of processes in runnable state.
1693 (Linux 2.5.45 onwards.)
1695 \fIprocs_blocked 2\fP
1696 Number of processes blocked waiting for I/O to complete.
1697 (Linux 2.5.45 onwards.)
1706 This directory (present since 1.3.57) contains a number of files
1707 and subdirectories corresponding to kernel variables.
1708 These variables can be read and sometimes modified using
1709 the \fI/proc\fP file system, and the (deprecated)
1713 .IR /proc/sys/abi " (since Linux 2.4.10)"
1714 This directory may contain files with application binary information.
1715 .\" On some systems, it is not present.
1716 See the kernel source file
1717 .I Documentation/sysctl/abi.txt
1718 for more information.
1721 This directory may be empty.
1724 This directory contains device-specific information (e.g.,
1725 .IR dev/cdrom/info ).
1727 some systems, it may be empty.
1730 This directory contains the files and subdirectories for kernel variables
1731 related to file systems.
1733 .I /proc/sys/fs/binfmt_misc
1734 Documentation for files in this directory can be found
1735 in the kernel sources in
1736 .IR Documentation/binfmt_misc.txt .
1738 .IR /proc/sys/fs/dentry-state " (since Linux 2.2)"
1739 This file contains information about the status of the
1740 directory cache (dcache).
1741 The file contains six numbers,
1742 .IR nr_dentry ", " nr_unused ", " age_limit " (age in seconds), "
1744 (pages requested by system) and two dummy values.
1748 is the number of allocated dentries (dcache entries).
1749 This field is unused in Linux 2.2.
1752 is the number of unused dentries.
1755 .\" looks like this is unused in kernels 2.2 to 2.6
1756 is the age in seconds after which dcache entries
1757 can be reclaimed when memory is short.
1760 .\" looks like this is unused in kernels 2.2 to 2.6
1761 is nonzero when the kernel has called shrink_dcache_pages() and the
1762 dcache isn't pruned yet.
1765 .I /proc/sys/fs/dir-notify-enable
1766 This file can be used to disable or enable the
1768 interface described in
1770 on a system-wide basis.
1771 A value of 0 in this file disables the interface,
1772 and a value of 1 enables it.
1774 .I /proc/sys/fs/dquot-max
1775 This file shows the maximum number of cached disk quota entries.
1776 On some (2.4) systems, it is not present.
1777 If the number of free cached disk quota entries is very low and
1778 you have some awesome number of simultaneous system users,
1779 you might want to raise the limit.
1781 .I /proc/sys/fs/dquot-nr
1782 This file shows the number of allocated disk quota
1783 entries and the number of free disk quota entries.
1785 .IR /proc/sys/fs/epoll " (since Linux 2.6.28)"
1786 This directory contains the file
1787 .IR max_user_watches ,
1788 which can be used to limit the amount of kernel memory consumed by the
1791 For further details, see
1794 .I /proc/sys/fs/file-max
1796 a system-wide limit on the number of open files for all processes.
1799 which can be used by a process to set the per-process limit,
1801 on the number of files it may open.)
1803 of error messages about running out of file handles,
1804 try increasing this value:
1810 echo 100000 > /proc/sys/fs/file-max
1816 imposes an upper limit on the value that may be placed in
1820 .IR /proc/sys/fs/file-max ","
1822 .I /proc/sys/fs/inode-max
1823 to 3-4 times the new
1825 .IR /proc/sys/fs/file-max ","
1826 or you will run out of inodes.
1828 .I /proc/sys/fs/file-nr
1829 This (read-only) file gives the number of files presently opened.
1830 It contains three numbers: the number of allocated file handles;
1831 the number of free file handles; and the maximum number of file handles.
1832 The kernel allocates file handles dynamically, but it
1833 doesn't free them again.
1834 If the number of allocated files is close to the
1835 maximum, you should consider increasing the maximum.
1836 When the number of free file handles is
1837 large, you've encountered a peak in your usage of file
1838 handles and you probably don't need to increase the maximum.
1840 .I /proc/sys/fs/inode-max
1841 This file contains the maximum number of in-memory inodes.
1842 On some (2.4) systems, it may not be present.
1843 This value should be 3-4 times larger
1846 since \fIstdin\fP, \fIstdout\fP
1847 and network sockets also need an inode to handle them.
1848 When you regularly run out of inodes, you need to increase this value.
1850 .I /proc/sys/fs/inode-nr
1851 This file contains the first two values from
1854 .I /proc/sys/fs/inode-state
1856 contains seven numbers:
1858 .IR nr_free_inodes ,
1860 and four dummy values.
1862 is the number of inodes the system has allocated.
1863 This can be slightly more than
1865 because Linux allocates them one page full at a time.
1867 represents the number of free inodes.
1873 and the system needs to prune the inode list instead of allocating more.
1875 .IR /proc/sys/fs/inotify " (since Linux 2.6.13)"
1876 This directory contains files
1877 .IR max_queued_events ", " max_user_instances ", and " max_user_watches ,
1878 that can be used to limit the amount of kernel memory consumed by the
1881 For further details, see
1884 .I /proc/sys/fs/lease-break-time
1885 This file specifies the grace period that the kernel grants to a process
1886 holding a file lease
1888 after it has sent a signal to that process notifying it
1889 that another process is waiting to open the file.
1890 If the lease holder does not remove or downgrade the lease within
1891 this grace period, the kernel forcibly breaks the lease.
1893 .I /proc/sys/fs/leases-enable
1894 This file can be used to enable or disable file leases
1896 on a system-wide basis.
1897 If this file contains the value 0, leases are disabled.
1898 A nonzero value enables leases.
1900 .IR /proc/sys/fs/mqueue " (since Linux 2.6.6)"
1901 This directory contains files
1902 .IR msg_max ", " msgsize_max ", and " queues_max ,
1903 controlling the resources used by POSIX message queues.
1908 .IR /proc/sys/fs/overflowgid " and " /proc/sys/fs/overflowuid
1910 allow you to change the value of the fixed UID and GID.
1911 The default is 65534.
1912 Some file systems only support 16-bit UIDs and GIDs, although in Linux
1913 UIDs and GIDs are 32 bits.
1914 When one of these file systems is mounted
1915 with writes enabled, any UID or GID that would exceed 65535 is translated
1916 to the overflow value before being written to disk.
1918 .IR /proc/sys/fs/pipe-max-size " (since Linux 2.6.35)"
1919 The value in this file defines an upper limit for raising the capacity
1924 This limit applies only to unprivileged processes.
1925 The default value for this file is 1,048,576.
1926 The value assigned to this file may be rounded upward,
1927 to reflect the value actually employed for a convenient implementation.
1928 To determine the rounded-up value,
1929 display the contents of this file after assigning a value to it.
1930 The minimum value that can be assigned to this file is the system page size.
1932 .IR /proc/sys/fs/suid_dumpable " (since Linux 2.6.13)"
1933 .\" The following is based on text from Documentation/sysctl/kernel.txt
1934 The value in this file determines whether core dump files are
1935 produced for set-user-ID or otherwise protected/tainted binaries.
1936 Three different integer values can be specified:
1939 This provides the traditional (pre-Linux 2.6.13) behavior.
1940 A core dump will not be produced for a process which has
1941 changed credentials (by calling
1944 or similar, or by executing a set-user-ID or set-group-ID program)
1945 or whose binary does not have read permission enabled.
1948 All processes dump core when possible.
1949 The core dump is owned by the file system user ID of the dumping process
1950 and no security is applied.
1951 This is intended for system debugging situations only.
1952 Ptrace is unchecked.
1954 \fI2\ ("suidsafe")\fP
1955 Any binary which normally would not be dumped (see "0" above)
1956 is dumped readable by root only.
1957 This allows the user to remove the core dump file but not to read it.
1958 For security reasons core dumps in this mode will not overwrite one
1959 another or other files.
1960 This mode is appropriate when administrators are
1961 attempting to debug problems in a normal environment.
1963 .I /proc/sys/fs/super-max
1965 controls the maximum number of superblocks, and
1966 thus the maximum number of mounted file systems the kernel
1968 You only need to increase
1970 if you need to mount more file systems than the current value in
1974 .I /proc/sys/fs/super-nr
1976 contains the number of file systems currently mounted.
1979 This directory contains files controlling a range of kernel parameters,
1982 .I /proc/sys/kernel/acct
1984 contains three numbers:
1989 If BSD-style process accounting is enabled these values control
1991 If free space on file system where the log lives goes below
1993 percent accounting suspends.
1994 If free space gets above
1996 percent accounting resumes.
1999 how often the kernel checks the amount of free space (value is in
2001 Default values are 4, 2 and 30.
2002 That is, suspend accounting if 2% or less space is free; resume it
2003 if 4% or more space is free; consider information about amount of free space
2004 valid for 30 seconds.
2006 .IR /proc/sys/kernel/cap-bound " (from Linux 2.2 to 2.6.24)"
2007 This file holds the value of the kernel
2008 .I "capability bounding set"
2009 (expressed as a signed decimal number).
2010 This set is ANDed against the capabilities permitted to a process
2013 Starting with Linux 2.6.25,
2014 the system-wide capability bounding set disappeared,
2015 and was replaced by a per-thread bounding set; see
2016 .BR capabilities (7).
2018 .I /proc/sys/kernel/core_pattern
2022 .I /proc/sys/kernel/core_uses_pid
2026 .I /proc/sys/kernel/ctrl-alt-del
2028 controls the handling of Ctrl-Alt-Del from the keyboard.
2029 When the value in this file is 0, Ctrl-Alt-Del is trapped and
2032 program to handle a graceful restart.
2033 When the value is greater than zero, Linux's reaction to a Vulcan
2034 Nerve Pinch (tm) will be an immediate reboot, without even
2035 syncing its dirty buffers.
2036 Note: when a program (like dosemu) has the keyboard in "raw"
2037 mode, the ctrl-alt-del is intercepted by the program before it
2038 ever reaches the kernel tty layer, and it's up to the program
2039 to decide what to do with it.
2041 .I /proc/sys/kernel/hotplug
2043 contains the path for the hotplug policy agent.
2044 The default value in this file is
2047 .IR /proc/sys/kernel/domainname " and " /proc/sys/kernel/hostname
2048 can be used to set the NIS/YP domainname and the
2049 hostname of your box in exactly the same way as the commands
2057 .RB "#" " echo \(aqdarkstar\(aq > /proc/sys/kernel/hostname"
2058 .RB "#" " echo \(aqmydomain\(aq > /proc/sys/kernel/domainname"
2062 has the same effect as
2066 .RB "#" " hostname \(aqdarkstar\(aq"
2067 .RB "#" " domainname \(aqmydomain\(aq"
2071 Note, however, that the classic darkstar.frop.org has the
2072 hostname "darkstar" and DNS (Internet Domain Name Server)
2073 domainname "frop.org", not to be confused with the NIS (Network
2074 Information Service) or YP (Yellow Pages) domainname.
2076 domain names are in general different.
2077 For a detailed discussion
2082 .I /proc/sys/kernel/htab-reclaim
2083 (PowerPC only) If this file is set to a nonzero value,
2086 .IR Documentation/powerpc/ppc_htab.txt )
2088 each time the system hits the idle loop.
2090 .I /proc/sys/kernel/l2cr
2091 (PowerPC only) This file
2092 contains a flag that controls the L2 cache of G3 processor
2094 If 0, the cache is disabled.
2097 .I /proc/sys/kernel/modprobe
2098 This file contains the path for the kernel module loader.
2099 The default value is
2100 .IR /sbin/modprobe .
2101 The file is only present if the kernel is built with the
2104 It is described by the kernel source file
2105 .I Documentation/kmod.txt
2106 (only present in kernel 2.4 and earlier).
2108 .I /proc/sys/kernel/msgmax
2110 a system-wide limit specifying the maximum number of bytes in
2111 a single message written on a System V message queue.
2113 .I /proc/sys/kernel/msgmni
2114 This file defines the system-wide limit on the number of
2115 message queue identifiers.
2116 (This file is only present in Linux 2.4 onwards.)
2118 .I /proc/sys/kernel/msgmnb
2119 This file defines a system-wide parameter used to initialize the
2121 setting for subsequently created message queues.
2124 setting specifies the maximum number of bytes that may be written to the
2127 .IR /proc/sys/kernel/ostype " and " /proc/sys/kernel/osrelease
2132 .IR /proc/sys/kernel/overflowgid " and " /proc/sys/kernel/overflowuid
2133 These files duplicate the files
2134 .I /proc/sys/fs/overflowgid
2136 .IR /proc/sys/fs/overflowuid .
2138 .I /proc/sys/kernel/panic
2139 This file gives read/write access to the kernel variable
2141 If this is zero, the kernel will loop on a panic; if nonzero
2142 it indicates that the kernel should autoreboot after this number
2145 software watchdog device driver, the recommended setting is 60.
2147 .IR /proc/sys/kernel/panic_on_oops " (since Linux 2.5.68)"
2148 This file controls the kernel's behavior when an oops
2149 or BUG is encountered.
2150 If this file contains 0, then the system
2151 tries to continue operation.
2152 If it contains 1, then the system
2153 delays a few seconds (to give klogd time to record the oops output)
2156 .I /proc/sys/kernel/panic
2157 file is also nonzero then the machine will be rebooted.
2159 .IR /proc/sys/kernel/pid_max " (since Linux 2.5.34)"
2160 This file specifies the value at which PIDs wrap around
2161 (i.e., the value in this file is one greater than the maximum PID).
2162 The default value for this file, 32768,
2163 results in the same range of PIDs as on earlier kernels.
2164 On 32-bit platforms, 32768 is the maximum value for
2168 can be set to any value up to 2^22
2169 .RB ( PID_MAX_LIMIT ,
2170 approximately 4 million).
2171 .\" Prior to 2.6.10, pid_max could also be raised above 32768 on 32-bit
2172 .\" platforms, but this broke /proc/[pid]
2173 .\" See http://marc.theaimsgroup.com/?l=linux-kernel&m=109513010926152&w=2
2175 .IR /proc/sys/kernel/powersave-nap " (PowerPC only)"
2176 This file contains a flag.
2177 If set, Linux-PPC will use the "nap" mode of
2179 otherwise the "doze" mode will be used.
2181 .I /proc/sys/kernel/printk
2182 The four values in this file are
2183 .IR console_loglevel ,
2184 .IR default_message_loglevel ,
2185 .IR minimum_console_level ,
2187 .IR default_console_loglevel .
2188 These values influence
2190 behavior when printing or logging error messages.
2193 for more info on the different loglevels.
2194 Messages with a higher priority than
2196 will be printed to the console.
2197 Messages without an explicit priority will be printed with priority
2198 .IR default_message_level .
2199 .I minimum_console_loglevel
2200 is the minimum (highest) value to which
2203 .I default_console_loglevel
2204 is the default value for
2205 .IR console_loglevel .
2207 .IR /proc/sys/kernel/pty " (since Linux 2.6.4)"
2208 This directory contains two files relating to the number of Unix 98
2209 pseudo-terminals (see
2213 .I /proc/sys/kernel/pty/max
2214 This file defines the maximum number of pseudo-terminals.
2216 .I /proc/sys/kernel/pty/nr
2218 indicates how many pseudo-terminals are currently in use.
2220 .I /proc/sys/kernel/random
2222 contains various parameters controlling the operation of the file
2226 for further information.
2228 .I /proc/sys/kernel/real-root-dev
2229 This file is documented in the kernel source file
2230 .IR Documentation/initrd.txt .
2232 .IR /proc/sys/kernel/reboot-cmd " (Sparc only) "
2233 This file seems to be a way to give an argument to the SPARC
2234 ROM/Flash boot loader.
2235 Maybe to tell it what to do after
2238 .I /proc/sys/kernel/rtsig-max
2239 (Only in kernels up to and including 2.6.7; see
2241 This file can be used to tune the maximum number
2242 of POSIX real-time (queued) signals that can be outstanding
2245 .I /proc/sys/kernel/rtsig-nr
2246 (Only in kernels up to and including 2.6.7.)
2247 This file shows the number POSIX real-time signals currently queued.
2249 .IR /proc/sys/kernel/sem " (since Linux 2.4)"
2250 This file contains 4 numbers defining limits for System V IPC semaphores.
2251 These fields are, in order:
2254 The maximum semaphores per semaphore set.
2256 A system-wide limit on the number of semaphores in all semaphore sets.
2258 The maximum number of operations that may be specified in a
2262 A system-wide limit on the maximum number of semaphore identifiers.
2265 .I /proc/sys/kernel/sg-big-buff
2267 shows the size of the generic SCSI device (sg) buffer.
2268 You can't tune it just yet, but you could change it at
2269 compile time by editing
2270 .I include/scsi/sg.h
2274 However, there shouldn't be any reason to change this value.
2276 .I /proc/sys/kernel/shmall
2278 contains the system-wide limit on the total number of pages of
2279 System V shared memory.
2281 .I /proc/sys/kernel/shmmax
2283 can be used to query and set the run-time limit
2284 on the maximum (System V IPC) shared memory segment size that can be
2286 Shared memory segments up to 1GB are now supported in the
2288 This value defaults to
2291 .I /proc/sys/kernel/shmmni
2292 (available in Linux 2.4 and onwards)
2294 specifies the system-wide maximum number of System V shared memory
2295 segments that can be created.
2297 .I /proc/sys/kernel/sysrq
2298 This file controls the functions allowed to be invoked by the SysRq key.
2300 the file contains 1 meaning that every possible SysRq request is allowed
2301 (in older kernel versions, SysRq was disabled by default,
2302 and you were required to specifically enable it at run-time,
2303 but this is not the case any more).
2304 Possible values in this file are:
2306 0 - disable sysrq completely
2307 1 - enable all functions of sysrq
2308 >1 - bitmask of allowed sysrq functions, as follows:
2309 2 - enable control of console logging level
2310 4 - enable control of keyboard (SAK, unraw)
2311 8 - enable debugging dumps of processes etc.
2312 16 - enable sync command
2313 32 - enable remount read-only
2314 64 - enable signalling of processes (term, kill, oom-kill)
2315 128 - allow reboot/poweroff
2316 256 - allow nicing of all real-time tasks
2318 This file is only present if the
2319 .B CONFIG_MAGIC_SYSRQ
2320 kernel configuration option is enabled.
2321 For further details see the kernel source file
2322 .IR Documentation/sysrq.txt .
2324 .I /proc/sys/kernel/version
2325 This file contains a string like:
2327 #5 Wed Feb 25 21:49:24 MET 1998
2330 this is the fifth kernel built from this source base and the
2331 date behind it indicates the time the kernel was built.
2333 .IR /proc/sys/kernel/threads-max " (since Linux 2.3.11)"
2334 This file specifies the system-wide limit on the number of
2335 threads (tasks) that can be created on the system.
2337 .IR /proc/sys/kernel/zero-paged " (PowerPC only) "
2340 When enabled (nonzero), Linux-PPC will pre-zero pages in
2341 the idle loop, possibly speeding up get_free_pages.
2344 This directory contains networking stuff.
2345 Explanations for some of the files under this directory can be found in
2350 .I /proc/sys/net/core/somaxconn
2351 This file defines a ceiling value for the
2357 manual page for details.
2360 This directory may be empty.
2363 This directory supports Sun remote procedure call for network file system
2365 On some systems, it is not present.
2368 This directory contains files for memory management tuning, buffer and
2371 .IR /proc/sys/vm/drop_caches " (since Linux 2.6.16)"
2372 Writing to this file causes the kernel to drop clean caches, dentries and
2373 inodes from memory, causing that memory to become free.
2375 To free pagecache, use
2376 .IR "echo 1 > /proc/sys/vm/drop_caches" ;
2377 to free dentries and inodes, use
2378 .IR "echo 2 > /proc/sys/vm/drop_caches" ;
2379 to free pagecache, dentries and inodes, use
2380 .IR "echo 3 > /proc/sys/vm/drop_caches" .
2382 Because this is a nondestructive operation and dirty objects
2383 are not freeable, the
2388 .IR /proc/sys/vm/legacy_va_layout " (since Linux 2.6.9)"
2389 .\" The following is from Documentation/filesystems/proc.txt
2390 If nonzero, this disables the new 32-bit memory-mapping layout;
2391 the kernel will use the legacy (2.4) layout for all processes.
2393 .IR /proc/sys/vm/memory_failure_early_kill " (since Linux 2.6.32)"
2394 .\" The following is based on the text in Documentation/sysctl/vm.txt
2395 Control how to kill processes when an uncorrected memory error
2396 (typically a 2-bit error in a memory module)
2397 that cannot be handled by the kernel
2398 is detected in the background by hardware.
2399 In some cases (like the page still having a valid copy on disk),
2400 the kernel will handle the failure
2401 transparently without affecting any applications.
2402 But if there is no other up-to-date copy of the data,
2403 it will kill processes to prevent any data corruptions from propagating.
2405 The file has one of the following values:
2408 Kill all processes that have the corrupted-and-not-reloadable page mapped
2409 as soon as the corruption is detected.
2410 Note this is not supported for a few types of pages, like kernel internally
2411 allocated data or the swap cache, but works for the majority of user pages.
2413 Only unmap the corrupted page from all processes and only kill a process
2414 who tries to access it.
2417 The kill is performed using a
2423 Processes can handle this if they want to; see
2427 This feature is only active on architectures/platforms with advanced machine
2428 check handling and depends on the hardware capabilities.
2430 Applications can override the
2431 .I memory_failure_early_kill
2432 setting individually with the
2437 Only present if the kernel was configured with
2438 .BR CONFIG_MEMORY_FAILURE .
2440 .IR /proc/sys/vm/memory_failure_recovery " (since Linux 2.6.32)"
2441 .\" The following is based on the text in Documentation/sysctl/vm.txt
2442 Enable memory failure recovery (when supported by the platform)
2447 Always panic on a memory failure.
2450 Only present if the kernel was configured with
2451 .BR CONFIG_MEMORY_FAILURE .
2453 .IR /proc/sys/vm/oom_dump_tasks " (since Linux 2.6.25)"
2454 .\" The following is from Documentation/sysctl/vm.txt
2455 Enables a system-wide task dump (excluding kernel threads) to be
2456 produced when the kernel performs an OOM-killing.
2457 The dump includes the following information
2458 for each task (thread, process):
2459 thread ID, real user ID, thread group ID (process ID),
2460 virtual memory size, resident set size,
2461 the CPU that the task is scheduled on,
2462 oom_adj score (see the description of
2463 .IR /proc/[pid]/oom_adj ),
2465 This is helpful to determine why the OOM-killer was invoked
2466 and to identify the rogue task that caused it.
2468 If this contains the value zero, this information is suppressed.
2469 On very large systems with thousands of tasks,
2470 it may not be feasible to dump the memory state information for each one.
2471 Such systems should not be forced to incur a performance penalty in
2472 OOM situations when the information may not be desired.
2474 If this is set to nonzero, this information is shown whenever the
2475 OOM-killer actually kills a memory-hogging task.
2477 The default value is 0.
2479 .IR /proc/sys/vm/oom_kill_allocating_task " (since Linux 2.6.24)"
2480 .\" The following is from Documentation/sysctl/vm.txt
2481 This enables or disables killing the OOM-triggering task in
2482 out-of-memory situations.
2484 If this is set to zero, the OOM-killer will scan through the entire
2485 tasklist and select a task based on heuristics to kill.
2486 This normally selects a rogue memory-hogging task that
2487 frees up a large amount of memory when killed.
2489 If this is set to nonzero, the OOM-killer simply kills the task that
2490 triggered the out-of-memory condition.
2491 This avoids a possibly expensive tasklist scan.
2494 .I /proc/sys/vm/panic_on_oom
2495 is nonzero, it takes precedence over whatever value is used in
2496 .IR /proc/sys/vm/oom_kill_allocating_task .
2498 The default value is 0.
2500 .I /proc/sys/vm/overcommit_memory
2501 This file contains the kernel virtual memory accounting mode.
2505 0: heuristic overcommit (this is the default)
2507 1: always overcommit, never check
2509 2: always check, never overcommit
2516 are not checked, and the default check is very weak,
2517 leading to the risk of getting a process "OOM-killed".
2518 Under Linux 2.4 any nonzero value implies mode 1.
2519 In mode 2 (available since Linux 2.6), the total virtual address space
2520 on the system is limited to (SS + RAM*(r/100)),
2521 where SS is the size of the swap space, and RAM
2522 is the size of the physical memory, and r is the contents of the file
2523 .IR /proc/sys/vm/overcommit_ratio .
2525 .I /proc/sys/vm/overcommit_ratio
2526 See the description of
2527 .IR /proc/sys/vm/overcommit_memory .
2529 .IR /proc/sys/vm/panic_on_oom " (since Linux 2.6.18)"
2530 .\" The following is adapted from Documentation/sysctl/vm.txt
2531 This enables or disables a kernel panic in
2532 an out-of-memory situation.
2534 If this file is set to the value 0,
2535 the kernel's OOM-killer will kill some rogue process.
2536 Usually, the OOM-killer is able to kill a rogue process and the
2537 system will survive.
2539 If this file is set to the value 1,
2540 then the kernel normally panics when out-of-memory happens.
2541 However, if a process limits allocations to certain nodes
2542 using memory policies
2547 and those nodes reach memory exhaustion status,
2548 one process may be killed by the OOM-killer.
2549 No panic occurs in this case:
2550 because other nodes' memory may be free,
2551 this means the system as a whole may not have reached
2552 an out-of-memory situation yet.
2554 If this file is set to the value 2,
2555 the kernel always panics when an out-of-memory condition occurs.
2557 The default value is 0.
2558 1 and 2 are for failover of clustering.
2559 Select either according to your policy of failover.
2561 .IR /proc/sys/vm/swappiness
2562 .\" The following is from Documentation/sysctl/vm.txt
2563 The value in this file controls how aggressively the kernel will swap
2565 Higher values increase agressiveness, lower values
2566 decrease aggressiveness.
2567 The default value is 60.
2569 .IR /proc/sysrq-trigger " (since Linux 2.4.21)"
2570 Writing a character to this file triggers the same SysRq function as
2571 typing ALT-SysRq-<character> (see the description of
2572 .IR /proc/sys/kernel/sysrq ).
2573 This file is normally only writable by
2575 For further details see the kernel source file
2576 .IR Documentation/sysrq.txt .
2579 Subdirectory containing the pseudo-files
2580 .IR msg ", " sem " and " shm "."
2581 These files list the System V Interprocess Communication (IPC) objects
2582 (respectively: message queues, semaphores, and shared memory)
2583 that currently exist on the system,
2584 providing similar information to that available via
2586 These files have headers and are formatted (one IPC object per line)
2587 for easy understanding.
2589 provides further background on the information shown by these files.
2592 Subdirectory containing the pseudo-files and subdirectories for
2593 tty drivers and line disciplines.
2596 This file contains two numbers: the uptime of the system (seconds),
2597 and the amount of time spent in idle process (seconds).
2600 This string identifies the kernel version that is currently running.
2601 It includes the contents of
2602 .IR /proc/sys/kernel/ostype ,
2603 .I /proc/sys/kernel/osrelease
2605 .IR /proc/sys/kernel/version .
2610 Linux version 1.0.9 (quinlan@phaze) #1 Sat May 14 01:51:54 EDT 1994
2614 .\" FIXME Document /proc/timer_list
2616 .\" .IR /proc/timer_list " (since Linux 2.6.21)"
2617 .\" See the 2.6.21 Change log
2618 .\" FIXME Document /proc/timer_stats
2620 .\" .IR /proc/timer_stats " (since Linux 2.6.21)"
2621 .\" See the 2.6.21 Change log
2623 .IR /proc/vmstat " (since Linux 2.6)"
2624 This file displays various virtual memory statistics.
2626 .IR /proc/zoneinfo " (since Linux 2.6.13)"
2627 This file display information about memory zones.
2628 This is useful for analyzing virtual memory behavior.
2629 .\" FIXME more should be said about /proc/zoneinfo
2631 Many strings (i.e., the environment and command line) are in
2632 the internal format, with subfields terminated by null bytes (\(aq\\0\(aq),
2634 may find that things are more readable if you use \fIod \-c\fP or \fItr
2635 "\\000" "\\n"\fP to read them.
2636 Alternatively, \fIecho \`cat <file>\`\fP works well.
2638 This manual page is incomplete, possibly inaccurate, and is the kind
2639 of thing that needs to be updated very often.
2640 .\" .SH ACKNOWLEDGEMENTS
2641 .\" The material on /proc/sys/fs and /proc/sys/kernel is closely based on
2642 .\" kernel source documentation files written by Rik van Riel.
2669 The kernel source files:
2670 .IR Documentation/filesystems/proc.txt ,
2671 .IR Documentation/sysctl/vm.txt