| procstat.1 (204879) | procstat.1 (224859) |
|---|---|
| 1.\"- | 1.\"- |
| 2.\" Copyright (c) 2007-2008 Robert N. M. Watson | 2.\" Copyright (c) 2007-2009 Robert N. M. Watson |
| 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright --- 7 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" | 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright --- 7 unchanged lines hidden (view full) --- 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" |
| 26.\" $FreeBSD: head/usr.bin/procstat/procstat.1 204879 2010-03-08 20:44:22Z kib $ | 26.\" $FreeBSD: head/usr.bin/procstat/procstat.1 224859 2011-08-14 00:42:09Z rwatson $ |
| 27.\" | 27.\" |
| 28.Dd March 7, 2010 | 28.Dd August 14, 2011 |
| 29.Dt PROCSTAT 1 30.Os 31.Sh NAME 32.Nm procstat 33.Nd get detailed process information 34.Sh SYNOPSIS 35.Nm 36.Op Fl h 37.Op Fl n | 29.Dt PROCSTAT 1 30.Os 31.Sh NAME 32.Nm procstat 33.Nd get detailed process information 34.Sh SYNOPSIS 35.Nm 36.Op Fl h 37.Op Fl n |
| 38.Op Fl C |
|
| 38.Op Fl w Ar interval 39.Op Fl b | c | f | i | j | k | s | t | v 40.Op Fl a | Ar pid ... 41.Sh DESCRIPTION 42The 43.Nm 44utility displays detailed information about the processes identified by the 45.Ar pid --- 37 unchanged lines hidden (view full) --- 83The 84.Fl w 85flag may be used to specify a wait interval at which to repeat the printing 86of the requested process information. 87If the 88.Fl w 89flag is not specified, the output will not repeat. 90.Pp | 39.Op Fl w Ar interval 40.Op Fl b | c | f | i | j | k | s | t | v 41.Op Fl a | Ar pid ... 42.Sh DESCRIPTION 43The 44.Nm 45utility displays detailed information about the processes identified by the 46.Ar pid --- 37 unchanged lines hidden (view full) --- 84The 85.Fl w 86flag may be used to specify a wait interval at which to repeat the printing 87of the requested process information. 88If the 89.Fl w 90flag is not specified, the output will not repeat. 91.Pp |
| 92The 93.Fl C 94flag requests the printing of additional capability information in the file 95descriptor view. 96.Pp |
|
| 91Some information, such as VM and file descriptor information, is available 92only to the owner of a process or the superuser. 93.Ss Binary Information 94Display the process ID, command, and path to the process binary: 95.Pp 96.Bl -tag -width indent -compact 97.It PID 98process ID --- 12 unchanged lines hidden (view full) --- 111command 112.It ARGS 113command line arguments (if available) 114.El 115.Ss File Descriptors 116Display detailed information about each file descriptor referenced by a 117process, including the process ID, command, file descriptor number, and 118per-file descriptor object information, such as object type and file system | 97Some information, such as VM and file descriptor information, is available 98only to the owner of a process or the superuser. 99.Ss Binary Information 100Display the process ID, command, and path to the process binary: 101.Pp 102.Bl -tag -width indent -compact 103.It PID 104process ID --- 12 unchanged lines hidden (view full) --- 117command 118.It ARGS 119command line arguments (if available) 120.El 121.Ss File Descriptors 122Display detailed information about each file descriptor referenced by a 123process, including the process ID, command, file descriptor number, and 124per-file descriptor object information, such as object type and file system |
| 119path: | 125path. 126By default, the following information will be printed: |
| 120.Pp 121.Bl -tag -width indent -compact 122.It PID 123process ID 124.It COMM 125command 126.It FD 127file descriptor number or cwd/root/jail --- 75 unchanged lines hidden (view full) --- 203.It f 204fsync 205.It n 206non-blocking 207.It d 208direct I/O 209.It l 210lock held | 127.Pp 128.Bl -tag -width indent -compact 129.It PID 130process ID 131.It COMM 132command 133.It FD 134file descriptor number or cwd/root/jail --- 75 unchanged lines hidden (view full) --- 210.It f 211fsync 212.It n 213non-blocking 214.It d 215direct I/O 216.It l 217lock held |
| 218.It c 219descriptor is a capability |
|
| 211.El | 220.El |
| 221.Pp 222If the 223.Fl C 224flag is specified, the vnode type, reference count, and offset fields will be 225omitted, and a new capabilities field will be included listing capabilities, 226as described in 227.Xr cap_new 2 , 228present for each capability descriptor. |
|
| 212.Ss Signal Disposition Information 213Display signal pending and disposition for a process: 214.Pp 215.Bl -tag -width ident -compact 216.It PID 217process ID 218.It COMM 219command --- 81 unchanged lines hidden (view full) --- 301.It SVUID 302saved user ID 303.It EGID 304effective group ID 305.It RGID 306real group ID 307.It SVGID 308saved group ID | 229.Ss Signal Disposition Information 230Display signal pending and disposition for a process: 231.Pp 232.Bl -tag -width ident -compact 233.It PID 234process ID 235.It COMM 236command --- 81 unchanged lines hidden (view full) --- 318.It SVUID 319saved user ID 320.It EGID 321effective group ID 322.It RGID 323real group ID 324.It SVGID 325saved group ID |
| 326.It FLAGS 327credential flags |
|
| 309.It GROUPS 310group set 311.El | 328.It GROUPS 329group set 330.El |
| 331.Pp 332The following credential flags may be displayed: 333.Pp 334.Bl -tag -width X -compact 335.It C 336capability mode 337.El |
|
| 312.Ss Thread Information 313Display per-thread information, including process ID, per-thread ID, name, 314CPU, and execution state: 315.Pp 316.Bl -tag -width indent -compact 317.It PID 318process ID 319.It TID --- 77 unchanged lines hidden (view full) --- 397needs copy 398.El 399.Sh EXIT STATUS 400.Ex -std 401.Sh SEE ALSO 402.Xr fstat 1 , 403.Xr ps 1 , 404.Xr sockstat 1 , | 338.Ss Thread Information 339Display per-thread information, including process ID, per-thread ID, name, 340CPU, and execution state: 341.Pp 342.Bl -tag -width indent -compact 343.It PID 344process ID 345.It TID --- 77 unchanged lines hidden (view full) --- 423needs copy 424.El 425.Sh EXIT STATUS 426.Ex -std 427.Sh SEE ALSO 428.Xr fstat 1 , 429.Xr ps 1 , 430.Xr sockstat 1 , |
| 431.Xr cap_enter 2 , 432.Xr cap_new 2 , |
|
| 405.Xr ddb 4 , 406.Xr stack 9 407.Sh AUTHORS 408.An Robert N M Watson 409.Sh BUGS 410Some field values may include spaces, which limits the extent to which the 411output of 412.Nm 413may be mechanically parsed. 414.Pp 415The display of open file or memory mapping pathnames is implemented using the 416kernel's name cache. 417If a file system does not use the name cache, or the path to a file is not in 418the cache, a path will not be displayed. 419.Pp 420.Nm 421currently supports extracting data only from a live kernel, and not from 422kernel crash dumps. | 433.Xr ddb 4 , 434.Xr stack 9 435.Sh AUTHORS 436.An Robert N M Watson 437.Sh BUGS 438Some field values may include spaces, which limits the extent to which the 439output of 440.Nm 441may be mechanically parsed. 442.Pp 443The display of open file or memory mapping pathnames is implemented using the 444kernel's name cache. 445If a file system does not use the name cache, or the path to a file is not in 446the cache, a path will not be displayed. 447.Pp 448.Nm 449currently supports extracting data only from a live kernel, and not from 450kernel crash dumps. |