Интерактивная система просмотра системных руководств (man-ов)
procstat (1)
>> procstat (1) ( FreeBSD man: Команды и прикладные программы пользовательского уровня )
BSD mandoc
NAME
procstat
- get detailed process information
SYNOPSIS
[-h
]
[-w interval
]
[-b | c | f | k | s | t | v
]
[-a | pid ...
]
DESCRIPTION
The
utility displays detailed information about the processes identified by the
pid
arguments, or if the
-a
flag is used, all processes.
By default, basic process statistics are printed; one of the following
options may be specified in order to select more detailed process information
for printing:
-b
Display binary information for the process.
-c
Display command line arguments for the process.
-f
Display file descriptor information for the process.
-k
Display the stacks of kernel threads in the process, excluding stacks of
threads currently running on a CPU and threads with stacks swapped to disk.
If the flag is repeated, function offsets as well as function names are
printed.
-s
Display security credential information for the process.
-t
Display thread information for the process.
-v
Display virtual memory mappings for the process.
All options generate output in the format of a table, the first field of
which is the process ID to which the row of information corresponds.
The
-h
flag may be used to suppress table headers.
The
-w
flag may be used to specify a wait interval at which to repeat the printing
of the requested process information.
If the
-w
flag is not specified, the output will not repeat.
Some information, such as VM and file descriptor information, is available
only to the owner of a process or the superuser.
Binary Information
Display the process ID, command, and path to the process binary:
PID
process ID
COMM
command
PATH
path to process binary (if available)
Command Line Arguments
Display the process ID, command, and command line arguments:
PID
process ID
COMM
command
ARGS
command line arguments (if available)
File Descriptors
Display detailed information about each file descriptor referenced by a
process, including the process ID, command, file descriptor number, and
per-file descriptor object information, such as object type and file system
path:
PID
process ID
COMM
command
FD
file descriptor number or cwd/root/jail
T
file descriptor type
V
vnode type
FLAGS
file descriptor flags
REF
file descriptor reference count
OFFSET
file descriptor offset
PRO
network protocol
NAME
file path or socket addresses (if available)
The following file descriptor types may be displayed:
c
crypto
f
fifo
k
kqueue
m
message queue
p
pipe
s
socket
v
vnode
The following vnode types may be displayed:
-
not a vnode
b
block device
c
character device
f
fifo
l
symbolic link
s
socket
x
revoked device
The following file descriptor flags may be displayed:
r
read
w
write
a
append
s
async
f
fsync
n
non-blocking
d
direct I/O
l
lock held
Kernel Thread Stacks
Display kernel thread stacks for a process, allowing further interpretation
of thread wait channels.
If the
-k
flag is reeated, function offsets, not just function names, are printed.
This feature requires
options STACK
or
options DDB
to be compiled into the kernel.
PID
process ID
TID
thread ID
COMM
command
TDNAME
thread name
KSTACK
kernel thread call stack
Security Credentials
Display process credential information:
PID
process ID
COMM
command
EUID
effective user ID
RUID
real user ID
SVUID
saved user ID
EGID
effective group ID
RGID
real group ID
SVGID
saved group ID
GROUPS
group set
Thread Information
Display per-thread information, including process ID, per-thread ID, name,
CPU, and execution state:
PID
process ID
TID
thread ID
COMM
command
TDNAME
thread name
CPU
current or most recent CPU run on
PRI
thread priority
STATE
thread state
WCHAN
thread wait channel
Virtual Memory Mappings
Display process virtual memory mappings, including addresses, mapping
meta-data, and mapped object information:
Some field values may include spaces, which limits the extent to which the
output of
may be mechanically parsed.
The display of open file or memory mapping pathnames is implemented using the
kernel's name cache.
It therefore does not work for file systems
that do not use the name cache, such as
devfs(4),
or if the name is not present in the cache due to removal.
currently supports extracting data only from a live kernel, and not from
kernel crash dumps.
