procflags Command

Purpose

Prints the /proc tracing flags, the pending and held signals, and other /proc status information for each thread in the specified processes.

Syntax

procflags [ -r ] ProcessID ...

Description

The /proc filesystem provides a mechanism to control processes. It also gives access to information about the current state of processes and threads, but in binary form. The proctools commands provide ascii reports based on some of the available information.

Most of the commands take a list of process IDs or /proc/ProcessID strings as input. The shell expansion /proc/* can therefore be used to specify all processes in the system.

Each of the proctools commands gathers information from /proc for the specified processes and displays it to the user. The proctools commands like procrun and procstop start and stop a process using the /proc interface.

The information gathered by the commands from /proc is a snapshot of the current state of processes, and therefore can vary at any instant except for stopped processes.

The procflags command prints the /proc tracing flags, the pending and held signals, and other /proc status information for each thread in the specified processes. The machine register contents are printed when option -r is used and the process is stopped on an event of interest. The events of interest are PR_REQUESTED, PR_FAULTED, PR_SYSENTRY, and PR_SYSEXIT as defined in <sys/procfs.h>.

Flags

Item	Description
-r	Displays the current machine registers state if a process is stopped in an event of interest.
ProcessID	Specifies the process id.

Examples

To display the tracing flags of process 5046, enter:
```
procflags  5046
```
The output of this command might look like this:
```
5046 : -sh
data model = _ILP32 flags = PR_FORK
/4289: flags = PR_ASLEEP | PR_NOREGS
```

To display the tracing flags and registers values of process 5040 which was stopped on an event of interest, enter:

procflags -r 5040

The output of this command might look like this:

5040 : ls                                                              
data model = _ILP32 flags = PR_FORK                                    
/6999: flags = PR_STOPPED | PR_ISTOP                                   
why = PR_FAULTED  what = FLTBPT what = kfork                           
gpr0  = 0x0               gpr1  = 0x2ff227b0        gpr2  = 0xf0083bec 
gpr3  = 0x2ff22cb3        gpr4  = 0x11              gpr5  = 0x65       
gpr6  = 0x50              gpr7  = 0x0               gpr8  = 0x41707a7c 
gpr9  = 0x4c4f47          gpr10 = 0x80000000        gpr11 = 0x34e0     
gpr12 = 0x0               gpr13 = 0xdeadbeef        gpr14 = 0x1        
gpr15 = 0x2ff22c0c        gpr16 = 0x2ff22c14        gpr17 = 0x0        
gpr18 = 0xdeadbeef        gpr19 = 0xdeadbeef        gpr20 = 0xdeadbeef 
gpr21 = 0xdeadbeef        gpr22 = 0x10              gpr23 = 0xfd       
gpr24 = 0x2f              gpr25 = 0x2ff227f0        gpr26 = 0x0        
gpr27 = 0x2ff22d87        gpr28 = 0x2ff22cb3        gpr29 = 0x0        
gpr30 = 0x0               gpr31 = 0xf0048260        iar = 0xd01be900   
msr = 0x2d032             cr = 0x28222442           lr = 0xd01d9de0    
ctr = 0xec                xer = 0x0                 fpscr = 0x0        
fpscrx = 0x0

Files

Item	Description
/proc	Contains the /proc filesystem.