[thirdparty/man-pages.git] / man5 / proc_stat.5

.\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
.\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
.\"
.\" SPDX-License-Identifier: GPL-3.0-or-later
.\"
.TH proc_stat 5 (date) "Linux man-pages (unreleased)"
.SH NAME
/proc/stat \- kernel system statistics
.SH DESCRIPTION
.TP
.I /proc/stat
kernel/system statistics.
Varies with architecture.
Common
entries include:
.RS
.TP
.I cpu  10132153 290696 3084719 46828483 16683 0 25195 0 175628 0
.TQ
.I cpu0 1393280 32966 572056 13343292 6130 0 17875 0 23933 0
The amount of time, measured in units of
USER_HZ (1/100ths of a second on most architectures, use
.I sysconf(_SC_CLK_TCK)
to obtain the right value),
.\" 1024 on Alpha and ia64
that the system ("cpu" line) or the specific CPU ("cpu\fIN\fR" line)
spent in various states:
.RS
.TP
.I user
(1) Time spent in user mode.
.TP
.I nice
(2) Time spent in user mode with low priority (nice).
.TP
.I system
(3) Time spent in system mode.
.TP
.I idle
(4) Time spent in the idle task.
.\" FIXME . Actually, the following info about the /proc/stat 'cpu' field
.\"       does not seem to be quite right (at least in Linux 2.6.12 or Linux 3.6):
.\"       the idle time in /proc/uptime does not quite match this value
This value should be USER_HZ times the
second entry in the
.I /proc/uptime
pseudo-file.
.TP
.IR iowait " (since Linux 2.5.41)"
(5) Time waiting for I/O to complete.
This value is not reliable, for the following reasons:
.\" See kernel commit 9c240d757658a3ae9968dd309e674c61f07c7f48
.RS
.IP \[bu] 3
The CPU will not wait for I/O to complete;
iowait is the time that a task is waiting for I/O to complete.
When a CPU goes into idle state for outstanding task I/O,
another task will be scheduled on this CPU.
.IP \[bu]
On a multi-core CPU,
the task waiting for I/O to complete is not running on any CPU,
so the iowait of each CPU is difficult to calculate.
.IP \[bu]
The value in this field may
.I decrease
in certain conditions.
.RE
.TP
.IR irq " (since Linux 2.6.0)"
.\" Precisely: Linux 2.6.0-test4
(6) Time servicing interrupts.
.TP
.IR softirq " (since Linux 2.6.0)"
.\" Precisely: Linux 2.6.0-test4
(7) Time servicing softirqs.
.TP
.IR steal " (since Linux 2.6.11)"
(8) Stolen time, which is the time spent in other operating systems when
running in a virtualized environment
.TP
.IR guest " (since Linux 2.6.24)"
(9) Time spent running a virtual CPU for guest
operating systems under the control of the Linux kernel.
.\" See Changelog entry for 5e84cfde51cf303d368fcb48f22059f37b3872de
.TP
.IR guest_nice " (since Linux 2.6.33)"
.\" commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
(10) Time spent running a niced guest (virtual CPU for guest
operating systems under the control of the Linux kernel).
.RE
.TP
\fIpage 5741 1808\fP
The number of pages the system paged in and the number that were paged
out (from disk).
.TP
\fIswap 1 0\fP
The number of swap pages that have been brought in and out.
.TP
.\" FIXME . The following is not the full picture for the 'intr' of
.\"       /proc/stat on 2.6:
\fIintr 1462898\fP
This line shows counts of interrupts serviced since boot time,
for each of the possible system interrupts.
The first column is the total of all interrupts serviced
including unnumbered architecture specific interrupts;
each subsequent column is the total for that particular numbered interrupt.
Unnumbered interrupts are not shown, only summed into the total.
.TP
\fIdisk_io: (2,0):(31,30,5764,1,2) (3,0):\fP...
(major,disk_idx):(noinfo, read_io_ops, blks_read, write_io_ops, blks_written)
.br
(Linux 2.4 only)
.TP
\fIctxt 115315\fP
The number of context switches that the system underwent.
.TP
\fIbtime 769041601\fP
boot time, in seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
.TP
\fIprocesses 86031\fP
Number of forks since boot.
.TP
\fIprocs_running 6\fP
Number of processes in runnable state.
(Linux 2.5.45 onward.)
.TP
\fIprocs_blocked 2\fP
Number of processes blocked waiting for I/O to complete.
(Linux 2.5.45 onward.)
.TP
.I softirq 229245889 94 60001584 13619 5175704 2471304 28 51212741 59130143 0 51240672
.\" commit d3d64df21d3d0de675a0d3ffa7c10514f3644b30
This line shows the number of softirq for all CPUs.
The first column is the total of all softirqs and
each subsequent column is the total for particular softirq.
(Linux 2.6.31 onward.)
.RE
.SH SEE ALSO
.BR proc (5)
Commit	Line	Data
c911e82d AC	1	.\" Copyright (C) 1994, 1995, Daniel Quinlan <quinlan@yggdrasil.com>
	2	.\" Copyright (C) 2002-2008, 2017, Michael Kerrisk <mtk.manpages@gmail.com>
	3	.\" Copyright (C) 2023, Alejandro Colomar <alx@kernel.org>
	4	.\"
	5	.\" SPDX-License-Identifier: GPL-3.0-or-later
	6	.\"
	7	.TH proc_stat 5 (date) "Linux man-pages (unreleased)"
	8	.SH NAME
	9	/proc/stat \- kernel system statistics
	10	.SH DESCRIPTION
	11	.TP
	12	.I /proc/stat
	13	kernel/system statistics.
	14	Varies with architecture.
	15	Common
	16	entries include:
	17	.RS
	18	.TP
	19	.I cpu 10132153 290696 3084719 46828483 16683 0 25195 0 175628 0
	20	.TQ
	21	.I cpu0 1393280 32966 572056 13343292 6130 0 17875 0 23933 0
	22	The amount of time, measured in units of
	23	USER_HZ (1/100ths of a second on most architectures, use
	24	.I sysconf(_SC_CLK_TCK)
	25	to obtain the right value),
	26	.\" 1024 on Alpha and ia64
	27	that the system ("cpu" line) or the specific CPU ("cpu\fIN\fR" line)
	28	spent in various states:
	29	.RS
	30	.TP
	31	.I user
	32	(1) Time spent in user mode.
	33	.TP
	34	.I nice
	35	(2) Time spent in user mode with low priority (nice).
	36	.TP
	37	.I system
	38	(3) Time spent in system mode.
	39	.TP
	40	.I idle
	41	(4) Time spent in the idle task.
	42	.\" FIXME . Actually, the following info about the /proc/stat 'cpu' field
	43	.\" does not seem to be quite right (at least in Linux 2.6.12 or Linux 3.6):
	44	.\" the idle time in /proc/uptime does not quite match this value
	45	This value should be USER_HZ times the
	46	second entry in the
	47	.I /proc/uptime
	48	pseudo-file.
	49	.TP
	50	.IR iowait " (since Linux 2.5.41)"
	51	(5) Time waiting for I/O to complete.
	52	This value is not reliable, for the following reasons:
	53	.\" See kernel commit 9c240d757658a3ae9968dd309e674c61f07c7f48
	54	.RS
	55	.IP \[bu] 3
	56	The CPU will not wait for I/O to complete;
	57	iowait is the time that a task is waiting for I/O to complete.
	58	When a CPU goes into idle state for outstanding task I/O,
	59	another task will be scheduled on this CPU.
	60	.IP \[bu]
	61	On a multi-core CPU,
	62	the task waiting for I/O to complete is not running on any CPU,
	63	so the iowait of each CPU is difficult to calculate.
	64	.IP \[bu]
65	The value in this field may
66	.I decrease
67	in certain conditions.
68	.RE
69	.TP
70	.IR irq " (since Linux 2.6.0)"
71	.\" Precisely: Linux 2.6.0-test4
72	(6) Time servicing interrupts.
73	.TP
74	.IR softirq " (since Linux 2.6.0)"
75	.\" Precisely: Linux 2.6.0-test4
76	(7) Time servicing softirqs.
77	.TP
78	.IR steal " (since Linux 2.6.11)"
79	(8) Stolen time, which is the time spent in other operating systems when
80	running in a virtualized environment
81	.TP
82	.IR guest " (since Linux 2.6.24)"
83	(9) Time spent running a virtual CPU for guest
84	operating systems under the control of the Linux kernel.
85	.\" See Changelog entry for 5e84cfde51cf303d368fcb48f22059f37b3872de
86	.TP
87	.IR guest_nice " (since Linux 2.6.33)"
88	.\" commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
89	(10) Time spent running a niced guest (virtual CPU for guest
90	operating systems under the control of the Linux kernel).
91	.RE
92	.TP
93	\fIpage 5741 1808\fP
94	The number of pages the system paged in and the number that were paged
95	out (from disk).
96	.TP
97	\fIswap 1 0\fP
98	The number of swap pages that have been brought in and out.
99	.TP
100	.\" FIXME . The following is not the full picture for the 'intr' of
101	.\" /proc/stat on 2.6:
102	\fIintr 1462898\fP
103	This line shows counts of interrupts serviced since boot time,
104	for each of the possible system interrupts.
105	The first column is the total of all interrupts serviced
106	including unnumbered architecture specific interrupts;
107	each subsequent column is the total for that particular numbered interrupt.
108	Unnumbered interrupts are not shown, only summed into the total.
109	.TP
110	\fIdisk_io: (2,0):(31,30,5764,1,2) (3,0):\fP...
111	(major,disk_idx):(noinfo, read_io_ops, blks_read, write_io_ops, blks_written)
112	.br
113	(Linux 2.4 only)
114	.TP
115	\fIctxt 115315\fP
116	The number of context switches that the system underwent.
117	.TP
118	\fIbtime 769041601\fP
119	boot time, in seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC).
120	.TP
121	\fIprocesses 86031\fP
122	Number of forks since boot.
123	.TP
124	\fIprocs_running 6\fP
125	Number of processes in runnable state.
126	(Linux 2.5.45 onward.)
127	.TP
128	\fIprocs_blocked 2\fP
129	Number of processes blocked waiting for I/O to complete.
130	(Linux 2.5.45 onward.)
131	.TP
132	.I softirq 229245889 94 60001584 13619 5175704 2471304 28 51212741 59130143 0 51240672
133	.\" commit d3d64df21d3d0de675a0d3ffa7c10514f3644b30
134	This line shows the number of softirq for all CPUs.
135	The first column is the total of all softirqs and
136	each subsequent column is the total for particular softirq.
137	(Linux 2.6.31 onward.)
138	.RE
139	.SH SEE ALSO
140	.BR proc (5)