proc(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO

NAME

proc, pflags, pcred, pmap, pldd, psig, pstack, pfiles, pwdx, pstop, prun, pwait, ptree, ptime, pattr, pclear, plabel, ppriv- Proc tools

SYNOPSIS

/usr/proc/bin/pflags [-r] pid...
/usr/proc/bin/pcred pid...
/usr/proc/bin/pmap [-rxlF] pid...
/usr/proc/bin/pldd [-F] pid...
/usr/proc/bin/psig pid...
/usr/proc/bin/pstack [-F] pid...
/usr/proc/bin/pfiles [-F] pid...
/usr/proc/bin/pwdx [-F] pid...
/usr/proc/bin/pstop pid...
/usr/proc/bin/prun pid...
/usr/proc/bin/pwait [-v] pid...
/usr/proc/bin/ptree [-a] [[pid| user]...]
/usr/proc/bin/ptime command [arg...]
/usr/proc/bin/pattr [-x ] [pid...]
/usr/proc/bin/pclear [pid...]
/usr/proc/bin/plabel [pid...]
/usr/proc/bin/ppriv [-a] [pid...]

DESCRIPTION

The proc tools are utilities that 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, 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 user s, 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 the command , like time(1) , but using microstate accounting for reproducible precision. Unlike time(1) , children of the command are not timed.

OPTIONS

The following options are supported:

-r

( pflags only) If the process is stopped, display its machine registers.

-r

( pmap only) Print the process' reserved addresses.

-x

( pmap and pattr only) Print resident/shared/private mapping details.

-l

( pmap only) Print unresolved dynamic linker map names.

-a

( ptree and ppriv only) All; include children of process 0.

-v

( pwait only) Verbose; report terminations to standard output.

-F

Force; grab the target process even if another process has control.

USAGE

These proc tools stop their target processes while inspecting them and reporting the results: pfiles , pldd , pmap , pstack , pwdx . A process can do nothing while it is stopped. Thus, for example, if the X server is inspected by one of these proc tools running in a window under the X server's control, the whole window system can become deadlocked because the proc tool would be attempting to print its results to a window that cannot be refreshed. Logging in from from another system using rlogin(1) and killing the offending proc tool would clear up the deadlock in this case.

Caution should be exercised when using the -F flag. Imposing two controlling processes on one victim process can lead to chaos. Safety is assured only if the primary controlling process, typically a debugger, has stopped the victim process and the primary controlling process is doing nothing at the moment of application of the proc tool in question.

EXIT STATUS

The following exit values are returned:

0

Successful operation.

non-zero

An error has occurred.

FILES

/proc/*

Process files

/usr/proc/lib/*

proc tools supporting files

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu (32-bit)
	SUNWtsxu (64-bit)

SUMMARY OF TRUSTED SOLARIS CHANGES

Trusted Solaris 7 provides additional utilities for obtaining a process' security attributes.

pattr

Get the viewable process attribute flags.

pclear

Get the process clearance.

plabel

Get the CMW label of a process.

ppriv

Get the effective privileges of a process.

SEE ALSO

Trusted Solaris 7 Reference Manual

pattr(1) , pclear(1) , plabel(1) , ppriv(1) , fcntl(2) , fstat(2) , proc(4)

SunOS 5.7 Reference Manual

ldd(1) , ps(1) , pwd(1) , rlogin(1) , time(1) , truss(1) , wait(1) , dlopen(3X) , attributes(5) , signal(5)

Trusted Solaris 7  Last Revised 30 Sep 1999

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | EXIT STATUS | FILES | ATTRIBUTES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO