Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
pstat(8)		    System Manager's Manual		      pstat(8)

       pstat - print system facts

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

       The  command interprets the contents of certain system tables. The con-
       tents 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.

       -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	 sema-

	       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  off-

       -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 cor-
			       rected. See the reference page for more	infor-

			   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 de-
			 scriptor 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  mi-
			 nor 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
	    system or corefile argument.

       -p   Displays  the  process table for active processes with these head-

	       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	 Bool-
			 ean 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

			   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	physi-
				    cal	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

			   00020000 Process has	advised	of random  memory  ac-

			   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 at-
				    tempted (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

	       PRI	 Scheduling  priority. (See for	information on priori-

	       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

	       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

	       o    The	 number	 of  pages reserved, but not necessarily allo-
		    cated, 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

	       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  ter-

	       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.

	    Displays information about the specified user process. The pid ar-
	    gument  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 op-
	    tion  is  valid only for processors	that have the VAX vector hard-
	    ware. 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

	       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 processor.

	       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  de-

			   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  fur-
			       ther 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.

       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)


Name | Syntax | Description | Options | Files | See Also

Want to link to this manual page? Use this URL:

home | help