pstat(8)						      System Manager's Manual							  pstat(8)

Name
       pstat - print system facts

Syntax
       /etc/pstat -aixvptufTk [ system ] [ corefile ]

Description
       The command interprets the contents of certain system tables. The contents of system tables can change while is running, so the information
       it gives is a snapshot taken at a given time.  If you specify system, gets the namelist from the named system's kernel. If you omit system,
       uses  the  namelist  in If you specify corefile, uses the tables in the core file. Otherwise, uses the tables in Use the -k option when you
       specify the system or corefile argument.

Options
       -a   When used with the -p option, displays all process slots, rather than just active ones.

       -f   Displays the open file table with the following headings:

	       LOC	 The core location of this table entry.

	       TYPE	 The type of object the file table entry points to.

	       FLG	 Miscellaneous state variables, encoded as follows:

			   R   Open for reading

			   W   Open for writing

			   A   Open for appending

			   S   Shared lock

			   X   Exclusive use

			   I   Asynchronous input and output notification

			   B   Block-if-in-use flag is set (shared line semaphore)

	       CNT	 Number of processes that know this open file.

	       GNO	 The location of the gnode table entry for this file.

	       OFFS/SOCK The file offset or the core address of the associated socket structure.  (See for information on file offsets.)

       -i   Displays the gnode table with the following headings:

	       LOC	 The core location of this table entry.

	       FLAGS	 Miscellaneous state variables, encoded as follows:

			   L   Locked.

			   U   Update time for the file system must be corrected. See the reference page for more information.

			   A   Access time must be corrected.

			   M   File system is mounted here.

			   W   Wanted by another process (L flag is on).

			   T   Contains a text file.

			   C   Changed time must be corrected.

			   S   Shared lock applied.

			   E   Exclusive lock applied.

			   Z   Someone waiting for an exclusive lock.

			   I   In-use flag is set (shared line semaphore).

	       CNT	 Number of open file table entries for this gnode.

	       DEV	 Major and minor device number of the file system in which this gnode resides.

	       RDC	 Reference count of shared locks on the gnode.

	       WRC	 Reference count of exclusive locks on the gnode. (This count can be >1 if, for example, a file  descriptor  is  inherited
			 across a fork.)

	       GNO	 I-number within the device.

	       MODE	 Mode bits. (See for information about mode bits.)

	       NLK	 Number of links to this gnode.

	       UID	 User identification (ID) of owner.

	       SIZ/DEV	 Number of bytes in an ordinary file or major and minor device of a special file.

       -k   Prevents  the process that is created from becoming too large, which can cause performance problems.  Use -k when you specify the sys-
	    tem or corefile argument.

       -p   Displays the process table for active processes with these headings:

	       LOC	 The core location of this table entry.

	       S	 Run state, encoded as follows:

			   0   No process

			   1   Waiting for some event

			   3   Able to be run

			   4   Being created

			   5   Being terminated

			   6   Stopped under trace

	       F	 Miscellaneous state variables, combined with a Boolean OR operation (hexadecimal):

			   00000001 Process is resident in memory.

			   00000002 System process:  swapper, pager, idle (RISC only), trusted path daemon.

			   00000004 Process is being swapped out.

			   00000008 Process requested swapout for page table growth.

			   00000010 Traced.

			   00000020 Used in tracing.

			   00000040 Locked in by a call.

			   00000080 Waiting for page-in to complete.

			   00000100 Protected from swapout while transferring resources to another process.

			   00000200 Used by a call.

			   00000400 Exiting.

			   00000800 Protected from swapout while doing physical input and output.

			   00001000 Process resulted from a call, which is not yet complete.

			   00002000 Parent has received resources returned by a child created with the call.

			   00004000 Process has no virtual memory because it is a parent in the context of the call.

			   00008000 Process is demand-paging data pages from its text gnode.

			   00010000 Process has advised of sequential memory access.

			   00020000 Process has advised of random memory access.

			   00080000 Process has indicated intent to execute data or stack (RISC only).

			   00100000 POSIX environment: no SIGCLD generated when children stop.

			   00200000 Process is owed a profiling tick.

			   00400000 Used by a call

			   00800000 A login process.

			   04000000 System V file lock applied.

			   08000000 Repair of unaligned accesses has been attempted (RISC only).

			   10000000 Process has called the system routine.

			   20000000 The idle process (RISC only).

	       POIP	 Number of pages currently being pushed out from this process.

	       PRI	 Scheduling priority. (See for information on priorities.)

	       SIGNAL	 Signals received (signals 1-32 coded in bits 0-31).

	       UID	 Real user ID.

	       SLP	 Amount of time the process has been blocked.

	       TIM	 Time resident in seconds; values greater than 127 are coded as 127.

	       CPU	 Weighted integral of CPU time, for scheduler.

	       NI	 Nice level. (See for information about nice levels.)

	       PGRP	 Process number of the root of the process group (the opener of the controlling terminal).

	       PID	 The process ID number.

	       PPID	 The process ID of the parent process.

	       ADDR	 If the process is in memory, identifies the user area page frame number of the page table entries.   If  the  process	is
			 swapped out, identifies the position in the swap area measured in multiples of 512 bytes.

	       RSS	 Resident set size minus the number of physical page frames allocated to this process.

	       SRSS	 RSS at last swap (0 if never swapped).

	       SIZE	 Virtual size of process image (data plus stack) in multiples of 512 bytes.

	       WCHAN	 Wait channel number of a waiting process.

	       LINK	 Link pointer in list of processes that can be run.

	       TEXTP	 If text is pure, pointer to location of text table entry.

	       CLKT	 Countdown  for  real  interval  timer,  measured in clock ticks (10 milliseconds). See the reference page for information
			 about the real interval timer.)

	       TTYP	 Address of controlling the terminal.

	       DMAP	 Address of data segment dmap structure.

	       SMAP	 Address of stack segment dmap structure.

       -s   Displays the following information about the pages used for swap space:

	       o    The number of pages reserved, but not necessarily allocated, by the system for currently executing processes.

	       o    The number of pages used (physically allocated), including the number used for text images.

	       o    The number of pages free, wasted, or missing. Free pages are pages that have not been allocated.  Missing  pages  are  usually
		    allocated to argdev.  Wasted pages indicate the amount of space lost because the swap space is fragmented.

	       o    The number of pages available, which indicates the amount of space available for swapping.

       -t   Displays the table for terminals with the following headings:

	       RAW	 Number of characters in the raw input queue.

	       CAN	 Number of characters in the canonic input queue.

	       OUT	 Number of characters in the output queue.

	       MODE	 Terminal mode, as described in

	       ADDR	 Physical device address.

	       DEL	 Number of delimiters (newlines) in the canonic input queue.

	       COL	 Calculated column position of the terminal.

	       STATE	 Miscellaneous state variables, encoded as follows:

			   T   Line is timed out.

			   W   Waiting for open to complete.

			   O   Open.

			   C   Carrier is on.

			   B   Busy doing output.

			   A   Process is awaiting output.

			   X   Open for exclusive use.

			   H   Hangup on close.

			   S   Output is stopped (ttstop).

			   I   In-use flag is set (shared line semaphore).

			   D   Open nodelay.

			   G   Ignore carrier.

			   N   Nonblocking input and output.

			   Z   Asychronous input and output notification.

			   L   Terminal line is in the process of closing.

			   Q   Output suspended for flow control.

	       PGRP	 Process group for which this is the controlling terminal.

	       DISC	 Line discipline; blank is old tty OTTYDISC, ntty for NTTYDISC, or termio for TERMIODISC.

       -T   Displays  the  number  of  used and free slots in the system tables.  This option is useful for determining how full the system tables
	    have become if the system is under a heavy load.

       -upid
	    Displays information about the specified user process. The pid argument is the process ID number as displayed  by  the  command.   The
	    process  must be in main memory, unless you specify the corefile argument on the command line. If you specify a core file, pid must be
	    0.

       -v   Displays a listing of all vector processes on the system. This option is valid only for processors that have the VAX vector  hardware.
	    The following list describes the headings in the display:

	       LOC	 The core location of this table entry

	       PPGRP	 The process number of the root of the process group (the opener of the controlling terminal)

	       PID	 The process ID number

	       PPID	 The process ID of the parent process

	       VSTAT	 One of the following vector process statuses:

			   WAIT   New vector process, which is waiting for a vector processor to be allocated to it.

			   LOAD   Process context is present in both vector and scalar processors.

			   SAVED  Process vector context is saved in memory.

			   LIMBO  A  vector  processor	has  been allocated to the process, but the vector context of the process has not yet been
				  loaded.

	       VERRS  Number of vector processor errors incurred by this process.

	       REFS   Number of times this process was refused scheduling into a vector processor.

	       CHPCXT Number of times the scaler context has been saved and restored, while the vector context remains resident in the vector pro-
		      cessor.

	       EPXCXT Number of times both the scalar and vector contexts have been saved and restored.

       -x   Displays the text table with the following headings:

	       LOC	 The core location of this table entry.

	       FLAGS	 Miscellaneous state variables encoded as follows:

			   T   A process called the system call.

			   W   Text has not yet been written on the swap device.

			   L   Loading is in progress.

			   K   Locked.

			   w   Wanted. (L flag is on.)

			   F   Text structure is on the freelist.

			   P   Resulted from demand-page-from-gnode execution format.  For further information, see

			   l   Locked from being paged or swapped.  For further information, see

			   B   All attached processes are being killed due to server write of an file.

	       DADDR	 Address of the text dmap structure in core.

	       CADDR	 Head of a linked list of loaded processes using this text segment.

	       SIZE	 Size of the text segment, measured in multiples of 512 bytes.

	       IPTR	 Core location of the corresponding gnode.

	       CNT	 Number of processes using this text segment.

	       CCNT	 Number of processes in core using this text segment.

	       LCNT	 Number of process locking this text segment.

	       POIP	 Number of pages currently being pushed out in this text segment.

	       CMAP	 The address of the last CMAP entry freed.

Files
       User process information

       Kernel memory

       System namelist

See Also
       ps(1), chmod(2), execve(2), getitimer(2), getpriority(2), lseek(2), plock(2), ptrace(2), stat(2), fs(5)

																	  pstat(8)