Main index | Section 1 | Options |
The pargs, penv and pwdx utilities display the arguments, environment, and current working directory, respectively of the process specified by pid argument. They mimic the behavior of Solaris utilities of the same names.
If the
The following commands are available for procstat:
basic | Print basic process statistics (this is the default). |
binary | | |
Display binary information for the process.
Substring commands are accepted. | |
argument(s) | | |
Display command line arguments for the process.
Substring commands are accepted. | |
environment | | |
Display environment variables for the process.
Substring commands are accepted. | |
file(s) | fd(s) | | |
Display file descriptor information for the process.
If the
| |
signal(s) | | |
Display signal pending and disposition information for the process.
If the
Substring commands are accepted. | |
tsignal(s) | | |
Display signal pending and blocked information for the process's threads.
If the
Substring commands are accepted. | |
kstack | | |
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
| |
rlimit | | |
Display resource limits for the process. | |
ptlwpinfo | | |
Display LWP info for the process pertaining to its signal driven exit. | |
rusage | | |
Display resource usage information for the process.
If the
| |
credential(s) | | |
Display security credential information for the process.
Substring commands are accepted. | |
cpuset | cs | | |
Display the cpuset information for the thread. | |
thread(s) | | |
Display thread information for the process. | |
vm | | |
Display virtual memory mappings for the process. | |
auxv | | |
Display ELF auxiliary vector for the process. | |
pargs | Display arguments for the process. |
penv | Display environment variables for the process. |
pwdx | Display current working directory 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
The
Information for VM, file descriptor, and cpuset options is available only to the owner of a process or the superuser. A cpuset value displayed as -1 means that the information is either invalid or not available.
PID | process ID |
COMM | command |
OSREL | osreldate for process binary |
PATH | path to process binary (if available) |
PID | process ID |
COMM | command |
ARGS | command line arguments (if available) |
PID | process ID |
COMM | command |
ENVIRONMENT | |
environment variables (if available) | |
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 |
e | POSIX semaphore |
f | fifo |
h | shared memory |
k | kqueue |
m | message queue |
P | process descriptor |
p | pipe |
s | socket |
t | pseudo-terminal master |
v | vnode |
The following vnode types may be displayed:
- | not a vnode |
b | block device |
c | character device |
d | directory |
f | fifo |
l | symbolic link |
r | regular file |
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 |
If the
The following network protocols may be displayed (grouped by address family):
AF_INET, AF_INET6
ICM | IPPROTO_ICMP; see icmp(4). |
IPD | IPPROTO_DIVERT; see divert(4). |
IP? | unknown protocol. |
RAW | IPPROTO_RAW; see ip(4). |
SCT | IPPROTO_SCTP; see sctp(4). |
TCP | IPPROTO_TCP; see tcp(4). |
UDP | IPPROTO_UDP; see udp(4). |
AF_LOCAL
UDD | IPPROTO_UDP; see udp(4). |
UDS | IPPROTO_TCP; see tcp(4). |
UD? | unknown protocol. |
? | unknown address family. |
PID | process ID |
COMM | command |
SIG | signal name |
FLAGS | process signal disposition details, three symbols |
P | if signal is pending in the global process queue; - otherwise. |
I | if signal delivery disposition is SIG_IGN; - otherwise. |
C | if the signal will be caught; - otherwise. |
If
PID | process ID |
TID | thread ID |
COMM | command |
SIG | signal name |
FLAGS | thread signal delivery status, two symbols |
P | if signal is pending for the thread, - otherwise |
B | if signal is blocked in the thread signal mask, - if not blocked |
The
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 | |
PID | process ID |
COMM | command |
RLIMIT | |
resource limit name | |
SOFT | soft limit |
HARD | hard limit |
PID | process ID |
TID |
thread ID
(
if
|
COMM | command |
RESOURCE | |
resource name | |
VALUE | current usage |
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 |
UMASK | file creation mode mask |
FLAGS | credential flags |
GROUPS | |
group set | |
The following credential flags may be displayed:
C | capability mode |
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 |
PID | process ID |
START | starting address of mapping |
END | ending address of mapping |
PRT | protection flags |
RES | resident pages |
PRES | private resident pages |
REF | reference count |
SHD | shadow page count |
FLAG | mapping flags |
TP | VM object type |
The following protection flags may be displayed:
r | read |
w | write |
x | execute |
The following VM object types may be displayed:
-- | none |
dd | dead |
df | default |
dv | device |
md | device with managed pages (GEM/TTM) |
ph | physical |
sg | scatter/gather |
sw | swap |
vn | vnode |
gd | guard (pseudo-type) |
The following mapping flags may be displayed:
C | copy-on-write |
N | needs copy |
S | one or more superpage mappings are used |
D | grows down (top-down stack) |
U | grows up (bottom-up stack) |
W | pages in this range are locked by mlock(2) or mlockall(2) |
PID | process ID |
COMM | command |
AUXV | auxiliary vector name |
VALUE | auxiliary vector value |
procstat currently supports extracting data only from a live kernel, and not from kernel crash dumps.
PROCSTAT (1) | February 13, 2021 |
Main index | Section 1 | Options |
Please direct any comments about this manual page service to Ben Bullock. Privacy policy.
“ | What will happen when the 32-bit Unix date goes negative in mid-January 2038 does not bear thinking about. | ” |
— Henry Spencer |