Lines Matching +full:ps +full:- +full:source +full:- +full:off +full:- +full:time +full:- +full:ms

1 .. SPDX-License-Identifier: GPL-2.0
24 1.1 Process-Specific Subdirectories
36 3 Per-Process Parameters
37 3.1 /proc/<pid>/oom_adj & /proc/<pid>/oom_score_adj - Adjust the oom-killer
39 3.2 /proc/<pid>/oom_score - Display current oom-killer score
40 3.3 /proc/<pid>/io - Display the IO accounting fields
41 3.4 /proc/<pid>/coredump_filter - Core dump filtering settings
42 3.5 /proc/<pid>/mountinfo - Information about mounts
44 3.7 /proc/<pid>/task/<tid>/children - Information about task children
45 3.8 /proc/<pid>/fdinfo/<fd> - Information about opened file
46 3.9 /proc/<pid>/map_files - Information about memory mapped files
47 3.10 /proc/<pid>/timerslack_ns - Task timerslack value
48 3.11 /proc/<pid>/patch_state - Livepatch patch operation state
49 3.12 /proc/<pid>/arch_status - Task architecture specific information
50 3.13 /proc/<pid>/fd - List of symlinks to open files
51 3.14 /proc/<pid/ksm_stat - Information about the process's ksm status.
62 ------------------------
70 we know, it is the first 'all-in-one' document about the /proc file system. It
73 It also only covers IPv4 networking, not IPv6 nor other protocols - sorry. But
81 Thanks to everybody else who contributed source or docs to the Linux kernel
92 mailing list at linux-[email protected] and/or try to reach me at
96 ---------------
106 ---------------
113 ------------------------------------------------------------------------------
119 First, we'll take a look at the read-only parts of /proc. In Chapter 2, we
122 1.1 Process-Specific Subdirectories
123 -----------------------------------
129 subdirectory has the entries listed in Table 1-1.
139 .. table:: Table 1-1: Process specific entries in /proc
158 symbol the task is blocked in - or "0" if not blocked.
221 the ps command. In fact, ps uses the proc file system to obtain its
223 file /proc/PID/status. It fields are described in table 1-2.
226 memory usage. Its seven fields are explained in Table 1-3. The stat file
228 explained in Table 1-4.
237 .. table:: Table 1-2: Contents of the status fields (as of 4.19)
311 .. table:: Table 1-3: Contents of the statm fields (as of 2.6.8-rc3)
329 .. table:: Table 1-4: Contents of the stat fields (as of 2.6.30-rc7)
356 start_time time the process started after system boot
377 blkio_ticks time spent waiting for block IO
378 gtime guest time of the task in jiffies
379 cgtime guest time of the task children in jiffies
398 08048000-08049000 r-xp 00000000 03:00 8312 /opt/test
399 08049000-0804a000 rw-p 00001000 03:00 8312 /opt/test
400 0804a000-0806b000 rw-p 00000000 00:00 0 [heap]
401 a7cb1000-a7cb2000 ---p 00000000 00:00 0
402 a7cb2000-a7eb2000 rw-p 00000000 00:00 0
403 a7eb2000-a7eb3000 ---p 00000000 00:00 0
404 a7eb3000-a7ed5000 rw-p 00000000 00:00 0
405 a7ed5000-a8008000 r-xp 00000000 03:00 4222 /lib/libc.so.6
406 a8008000-a800a000 r--p 00133000 03:00 4222 /lib/libc.so.6
407 a800a000-a800b000 rw-p 00135000 03:00 4222 /lib/libc.so.6
408 a800b000-a800e000 rw-p 00000000 00:00 0
409 a800e000-a8022000 r-xp 00000000 03:00 14462 /lib/libpthread.so.0
410 a8022000-a8023000 r--p 00013000 03:00 14462 /lib/libpthread.so.0
411 a8023000-a8024000 rw-p 00014000 03:00 14462 /lib/libpthread.so.0
412 a8024000-a8027000 rw-p 00000000 00:00 0
413 a8027000-a8043000 r-xp 00000000 03:00 8317 /lib/ld-linux.so.2
414 a8043000-a8044000 r--p 0001b000 03:00 8317 /lib/ld-linux.so.2
415 a8044000-a8045000 rw-p 0001c000 03:00 8317 /lib/ld-linux.so.2
416 aff35000-aff4a000 rw-p 00000000 00:00 0 [stack]
417 ffffe000-fffff000 r-xp 00000000 00:00 0 [vdso]
448 ioctl()-based API that gives ability to flexibly and efficiently query and
460 08048000-080bc000 r-xp 00000000 03:02 13130 /bin/bash
516 "KSM" reports how many of the pages are KSM pages. Note that KSM-placed zeropages
534 "Swap" shows how much would-be-anonymous memory is also used, but out on swap.
537 replaced by copy-on-write) part of the underlying shmem object out on swap.
558 ms may share
583 uw userfaultfd wr-protect tracking
590 be vanished or the reverse -- new added. Interpretation of their meaning
613 - Pss_Anon
614 - Pss_File
615 - Pss_Shmem
625 soft-dirty bit on pte (see Documentation/admin-guide/mm/soft-dirty.rst
639 To clear the soft-dirty bit::
653 Documentation/admin-guide/mm/pagemap.rst.
664 3206000000 default file=/lib64/ld-2.12.so mapped=26 mapmax=6 N0=24 N3=2 kernelpagesize_kB=4
665 320621f000 default file=/lib64/ld-2.12.so anon=1 dirty=1 N3=1 kernelpagesize_kB=4
666 3206220000 default file=/lib64/ld-2.12.so anon=1 dirty=1 N3=1 kernelpagesize_kB=4
668 …3206800000 default file=/lib64/libc-2.12.so mapped=59 mapmax=21 active=55 N0=41 N3=18 kernelpagesi…
669 320698b000 default file=/lib64/libc-2.12.so
670 3206b8a000 default file=/lib64/libc-2.12.so anon=2 dirty=2 N3=2 kernelpagesize_kB=4
671 3206b8e000 default file=/lib64/libc-2.12.so anon=1 dirty=1 N3=1 kernelpagesize_kB=4
683 "policy" reports the NUMA memory policy set for the mapping (see Documentation/admin-guide/mm/numa_…
690 ---------------
694 /proc and are listed in Table 1-5. Not all of these will be present in your
698 .. table:: Table 1-5: Kernel info in /proc
747 pci Deprecated info of PCI bus (new way -> /proc/bus/pci/,
749 rtc Real time clock
758 uptime Wall clock since boot, combined idle time of all cpus
769 0: 8728810 XT-PIC timer
770 1: 895 XT-PIC keyboard
771 2: 0 XT-PIC cascade
772 3: 531695 XT-PIC aha152x
773 4: 2014133 XT-PIC serial
774 5: 44401 XT-PIC pcnet_cs
775 8: 2 XT-PIC rtc
776 11: 8 XT-PIC i82365
777 12: 182918 XT-PIC PS/2 Mouse
778 13: 1 XT-PIC fpu
779 14: 1232265 XT-PIC ide0
780 15: 7 XT-PIC ide1
783 In 2.4.* a couple of lines where added to this file LOC & ERR (this time is the
789 0: 1243498 1214548 IO-APIC-edge timer
790 1: 8949 8958 IO-APIC-edge keyboard
791 2: 0 0 XT-PIC cascade
792 5: 11286 10161 IO-APIC-edge soundblaster
793 8: 1 0 IO-APIC-edge rtc
794 9: 27422 27407 IO-APIC-edge 3c503
795 12: 113645 113873 IO-APIC-edge PS/2 Mouse
796 13: 0 0 XT-PIC fpu
797 14: 22491 24012 IO-APIC-edge ide0
798 15: 2183 2415 IO-APIC-edge ide1
799 17: 30564 30414 IO-APIC-level eth0
800 18: 177 164 IO-APIC-level bttv
810 ERR is incremented in the case of errors in the IO-APIC bus (the bus that
812 the IO-APIC automatically retry the transmission, so it should not be a big
813 problem, but you should read the SMP-FAQ.
815 In 2.6.2* /proc/interrupts was expanded again. This time the goal was for
878 1024-1031
880 The default_smp_affinity mask applies to all non-active IRQs, which are the
882 /proc/irq/[0-9]* directory.
891 The way IRQs are routed is handled by the IO-APIC, and it's Round Robin
894 best choice for almost everyone. [Note this applies only to those IO-APIC's
952 X86-64. By keeping pages grouped based on their ability to move, the kernel
953 can reclaim pages within a page block to satisfy a high-order allocation.
957 by migrate-type and finishes with details on how many page blocks of each
963 at a given point in time. All the "Movable" blocks should be allocatable
973 base. Each allocation in the code is identified by its source file, line
983 > tail -n +3 /proc/allocinfo | sort -rn
988 13377536 234 block/blk-mq.c:3421 func:blk_mq_alloc_rqs
1091 In-memory cache for files read from the disk (the
1135 Non-file backed pages mapped into userspace page tables
1145 in-kernel data structures cache
1173 CommitLimit = ([total RAM pages] - [total huge TLB pages]) *
1181 in mm/overcommit-accounting.
1189 by the VM and can be used at any time by the allocating
1216 Non-file backed huge pages mapped into userspace page tables
1232 See Documentation/admin-guide/mm/hugetlbpage.rst.
1260 0xffffc20000000000-0xffffc20000201000 2101248 alloc_large_system_hash+0x204 ...
1262 0xffffc20000201000-0xffffc20000302000 1052672 alloc_large_system_hash+0x204 ...
1264 0xffffc20000302000-0xffffc20000304000 8192 acpi_tb_verify_table+0x21/0x4f...
1266 0xffffc20000304000-0xffffc20000307000 12288 acpi_tb_verify_table+0x21/0x4f...
1268 0xffffc2000031d000-0xffffc2000031f000 8192 init_vdso_vars+0x112/0x210
1269 0xffffc2000031f000-0xffffc2000032b000 49152 cramfs_uncompress_init+0x2e ...
1271 0xffffc2000033a000-0xffffc2000033d000 12288 sys_swapon+0x640/0xac0 ...
1273 0xffffc20000347000-0xffffc2000034c000 20480 xt_alloc_table_info+0xfe ...
1275 0xffffffffa0000000-0xffffffffa000f000 61440 sys_init_module+0xc27/0x1d00 ...
1277 0xffffffffa000f000-0xffffffffa0014000 20480 sys_init_module+0xc27/0x1d00 ...
1279 0xffffffffa0014000-0xffffffffa0017000 12288 sys_init_module+0xc27/0x1d00 ...
1281 0xffffffffa0017000-0xffffffffa0022000 45056 sys_init_module+0xc27/0x1d00 ...
1288 Provides counts of softirq handlers serviced since boot time, for each CPU.
1305 --------------------------------
1307 The subdirectory /proc/net follows the usual pattern. Table 1-8 shows the
1309 support this. Table 1-9 lists the files and their meaning.
1312 .. table:: Table 1-8: IPv6 info in /proc/net
1328 .. table:: Table 1-9: Network info in /proc/net
1350 softnet_stat Per-CPU incoming packets queues statistics of online CPUs
1366 Inter-|Receive |[...
1385 -------------
1395 Type: Direct-Access ANSI SCSI revision: 03
1397 Vendor: PIONEER Model: CD-ROM DR-U06S Rev: 1.04
1398 Type: CD-ROM ANSI SCSI revision: 02
1405 AHA-2940 SCSI adapter::
1415 SCSI Adapter: Adaptec AHA-294X Ultra SCSI host adapter
1448 ---------------------------------------
1454 These directories contain the four files shown in Table 1-10.
1457 .. table:: Table 1-10: Files in /proc/parport
1462 autoprobe Any IEEE-1284 device ID information that has been acquired.
1473 -------------------------
1477 this directory, as shown in Table 1-11.
1480 .. table:: Table 1-11: Files in /proc/tty
1494 pty_slave /dev/pts 136 0-255 pty:slave
1495 pty_master /dev/ptm 128 0-255 pty:master
1496 pty_slave /dev/ttyp 3 0-255 pty:slave
1497 pty_master /dev/pty 2 0-255 pty:master
1498 serial /dev/cua 5 64-67 serial:callout
1499 serial /dev/ttyS 4 64-67 serial
1504 unknown /dev/tty 4 1-63 console
1508 -------------------------------------------------
1529 lines. These numbers identify the amount of time the CPU has spent performing
1530 different kinds of work. Time units are in USER_HZ (typically hundredths of a
1533 - user: normal processes executing in user mode
1534 - nice: niced processes executing in user mode
1535 - system: processes executing in kernel mode
1536 - idle: twiddling thumbs
1537 - iowait: In a word, iowait stands for waiting for I/O to complete. But there
1540 1. CPU will not wait for I/O to complete, iowait is the time that a task is
1543 2. In a multi-core CPU, the task waiting for I/O to complete is not running
1549 - irq: servicing interrupts
1550 - softirq: servicing softirqs
1551 - steal: involuntary wait
1552 - guest: running a normal guest
1553 - guest_nice: running a niced guest
1555 The "intr" line gives counts of interrupts serviced since boot time, for each
1563 The "btime" line gives the time at which the system booted, in seconds since
1576 The "softirq" line gives counts of softirqs serviced since boot time, for each
1583 -------------------------------
1588 /proc/fs/ext4/sda9 or /proc/fs/ext4/dm-0). The files in each per-device
1589 directory are shown in Table 1-12, below.
1591 .. table:: Table 1-12: Files in /proc/fs/ext4/<devname>
1599 -------------------
1606 tty0 -WU (ECp) 4:7
1607 ttyS0 -W- (Ep) 4:64
1611 +--------------------+-------------------------------------------------------+
1617 +--------------------+-------------------------------------------------------+
1624 +--------------------+-------------------------------------------------------+
1627 +--------------------+-------------------------------------------------------+
1630 -------
1643 ---------------
1649 ------------------------------------------------------------------------------
1652 a source of information, it also allows you to change parameters within the
1661 to perform this every time your system boots.
1666 documentation and source before actually making adjustments. In any case, be
1673 Please see: Documentation/admin-guide/sysctl/ directory for descriptions of
1677 -------
1686 Chapter 3: Per-process Parameters
1689 3.1 /proc/<pid>/oom_adj & /proc/<pid>/oom_score_adj- Adjust the oom-killer score
1690 --------------------------------------------------------------------------------
1712 is used to determine which task to kill. Acceptable values range from -1000
1715 task or completely disabling it. The lowest possible value, -1000, is
1723 50% more memory. A value of -500, on the other hand, would be roughly
1728 be used to tune the badness score. Its acceptable values range from -16
1729 (OOM_ADJUST_MIN) to +15 (OOM_ADJUST_MAX) and a special value of -17
1738 3.2 /proc/<pid>/oom_score - Display current oom-killer score
1739 -------------------------------------------------------------
1741 This file can be used to check the current score used by the oom-killer for
1743 process should be killed in an out-of-memory situation.
1749 3.3 /proc/<pid>/io - Display the IO accounting fields
1750 -------------------------------------------------------
1816 accurate for block-backed filesystems. <please add status regarding NFS and
1817 CIFS at a later time>
1825 the storage layer. This is done at page-dirtying time.
1844 At its current implementation state, this is a bit racy on 32-bit machines:
1846 of those 64-bit counters, process A could see an intermediate result.
1852 3.4 /proc/<pid>/coredump_filter - Core dump filtering settings
1853 ---------------------------------------------------------------
1857 Conversely, sometimes we want to save file-backed memory segments into a core
1867 - (bit 0) anonymous private memory
1868 - (bit 1) anonymous shared memory
1869 - (bit 2) file-backed private memory
1870 - (bit 3) file-backed shared memory
1871 - (bit 4) ELF header pages in file-backed private memory areas (it is
1873 - (bit 5) hugetlb private memory
1874 - (bit 6) hugetlb shared memory
1875 - (bit 7) DAX private memory
1876 - (bit 8) DAX shared memory
1881 Note that bits 0-4 don't affect hugetlb or DAX memory. hugetlb memory is
1882 only affected by bit 5-6, and DAX is only affected by bits 7-8.
1899 3.5 /proc/<pid>/mountinfo - Information about mounts
1900 --------------------------------------------------------
1904 36 35 98:0 /mnt1 /mnt2 rw,noatime master:1 - ext3 /dev/root rw,errors=continue
1916 (m+3) mount source: filesystem specific information or "none"
1940 --------------------------------------------------------
1948 3.7 /proc/<pid>/task/<tid>/children - Information about task children
1949 -------------------------------------------------------------------------
1954 Note the "first level" here -- if a child has its own children they will
1955 not be listed here; one needs to read /proc/<children-pid>/task/<tid>/children
1965 3.8 /proc/<pid>/fdinfo/<fd> - Information about opened file
1966 ---------------------------------------------------------------
1968 files have at least four fields -- 'pos', 'flags', 'mnt_id' and 'ino'.
1999 eventfd-count: 5a
2001 where 'eventfd-count' is hex value of a counter.
2044 …inotify wd:3 ino:9e7e sdev:800013 mask:800afce ignored_mask:0 fhandle-bytes:8 fhandle-type:1 f_han…
2053 fields 'fhandle-bytes', 'fhandle-type' and 'f_handle', all in hex
2067 fanotify flags:10 event-flags:0
2069 …fanotify ino:4f969 sdev:800013 mflags:0 mask:3b ignored_mask:40000000 fhandle-bytes:8 fhandle-type…
2071 where fanotify 'flags' and 'event-flags' are values used in fanotify_init
2101 details]. 'it_value' is remaining time until the timer expiration.
2104 still exhibits timer's remaining time.
2117 exp_name: system-heap
2122 3.9 /proc/<pid>/map_files - Information about memory mapped files
2123 ---------------------------------------------------------------------
2127 | lr-------- 1 root root 64 Jan 27 11:24 333c600000-333c620000 -> /usr/lib64/ld-2.18.so
2128 | lr-------- 1 root root 64 Jan 27 11:24 333c81f000-333c820000 -> /usr/lib64/ld-2.18.so
2129 | lr-------- 1 root root 64 Jan 27 11:24 333c820000-333c821000 -> /usr/lib64/ld-2.18.so
2131 | lr-------- 1 root root 64 Jan 27 11:24 35d0421000-35d0422000 -> /usr/lib64/libselinux.so.1
2132 | lr-------- 1 root root 64 Jan 27 11:24 400000-41a000 -> /usr/bin/ls
2135 vm_area_struct::vm_start-vm_area_struct::vm_end.
2140 time one can open(2) mappings from the listings of two processes and
2144 3.10 /proc/<pid>/timerslack_ns - Task timerslack value
2145 ---------------------------------------------------------
2147 This value specifies an amount of time that normal timers may be deferred
2155 Valid values are from 0 - ULLONG_MAX
2160 3.11 /proc/<pid>/patch_state - Livepatch patch operation state
2161 -----------------------------------------------------------------
2165 A value of '-1' indicates that no patch is in transition.
2177 3.12 /proc/<pid>/arch_status - task architecture specific status
2178 -------------------------------------------------------------------
2200 elapsed since the last time AVX512 usage was recorded. The recording
2204 1) The time which the task spent on the CPU without being scheduled
2208 2) The time since the task was scheduled out last. Depending on the
2209 reason for being scheduled out (time slice exhausted, syscall ...)
2210 this can be arbitrary long time.
2218 A special value of '-1' indicates that no AVX512 usage was recorded, thus
2222 3.13 /proc/<pid>/fd - List of symlinks to open files
2223 -------------------------------------------------------
2227 lr-x------ 1 root root 64 Sep 20 17:53 0 -> /dev/null
2228 l-wx------ 1 root root 64 Sep 20 17:53 1 -> /dev/null
2229 lrwx------ 1 root root 64 Sep 20 17:53 10 -> 'socket:[12539]'
2230 lrwx------ 1 root root 64 Sep 20 17:53 11 -> 'socket:[12540]'
2231 lrwx------ 1 root root 64 Sep 20 17:53 12 -> 'socket:[12542]'
2235 -------------------------------------------------------
2237 3.14 /proc/<pid/ksm_stat - Information about the process's ksm status
2238 ---------------------------------------------------------------------
2263 addresses. KSM will generate a ksm_rmap_item for each ksm-scanned page of
2303 Documentation/admin-guide/mm/ksm.rst.
2310 ---------------------
2320 hidepid=off or hidepid=0 means classic mode - everybody may access all
2334 by "kill -0 $PID"), but it hides process's uid and gid, which may be learned by
2363 # strace -e mount mount -o hidepid=1 -t proc proc /tmp/proc
2374 # mount -o remount,hidepid=1 -t proc proc /tmp/proc
2387 # mount -o hidepid=invisible -t proc proc /proc
2388 # mount -o hidepid=noaccess -t proc proc /tmp/proc