Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ldd(1)

ps(1)

pwd(1)

time(1)

truss(1)

wait(1)

fcntl(2)

fstat(2)

dlopen(3X)

proc(4)

signal(5)

proc(1)

NAME

proc, pflags, pcred, pmap, pldd, psig, pstack, pfiles, pwdx, pstop, prun, pwait, ptree, ptime − proc tools

SYNOPSIS

/usr/proc/bin/pflags pid ...

/usr/proc/bin/pcred pid ...

/usr/proc/bin/pmap pid ...

/usr/proc/bin/pldd pid ...

/usr/proc/bin/psig pid ...

/usr/proc/bin/pstack pid ...

/usr/proc/bin/pfiles pid ...

/usr/proc/bin/pwdx pid ...

/usr/proc/bin/pstop pid ...

/usr/proc/bin/prun pid ...

/usr/proc/bin/pwait [ −v ] pid ...

/usr/proc/bin/ptree [ [pid|user] ... ]

/usr/proc/bin/ptime command [ arg ... ]

AVAILABILITY

SUNWesu

DESCRIPTION

The proc tools are utilities which exercise features of /proc (see proc(4)).  Most of them take a list of process-ids (pid); those that do also accept /proc/nnn as a process-id, so the shell expansion /proc/∗ can be used to specify all processes in the system. 

pflags print the /proc tracing flags, the pending and held signals, and other /proc status information for each lwp in each process. 

pcred print the credentials (effective, real and saved UID’s and GID’s) of each process. 

pmap print the address space map of each process. 

pldd list the dynamic libraries linked into each process, including shared objects explicitly attached using dlopen(3X).  (See also ldd(1).) 

psig list the signal actions of each process (See signal(5).) 

pstack print a hex+symbolic stack trace for each lwp in each process. 

pfiles report fstat(2) and fcntl(2) information for all open files in each process. 

pwdx print the current working directory of each process. 

pstop stop each process (PR_REQUESTED stop). 

prun set each process running (inverse of pstop). 

pwait wait for all of the specified processes to terminate. 

ptree print the process trees containing the specified pid’s or users, with child processes indented from their respective parent processes. An argument of all digits is taken to be a process-id, otherwise it is assumed to be a user login name.  Default is all processes.

ptime time a command, such as the time(1) command, but using microstate accounting for reproducible precision. 

OPTIONS

The following options are supported:

−v (pwait only) verbose; report each termination to standard output. 

EXIT STATUS

The following exit values are returned:

0 success

non-zero an error has occurred. 

FILES

/proc/∗ process files

/usr/proc/lib/∗ proc tools supporting files

SEE ALSO

ldd(1), ps(1), pwd(1), time(1), truss(1), wait(1), fcntl(2), fstat(2), dlopen(3X), proc(4), signal(5)

SunOS 5.5/SPARC  —  Last change: 9 Nov 1994

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026