BSD 4_1c_2 development

[unix-history] / usr / man / man8 / pstat.8

diff --git a/usr/man/man8/pstat.8 b/usr/man/man8/pstat.8
index cf11e70..870b6de 100644 (file)
--- a/usr/man/man8/pstat.8
+++ b/usr/man/man8/pstat.8
@@ -1,23 +1,30 @@
-.TH PSTAT 8 4/1/81
+.TH PSTAT 8 "1 April 1981"

 .UC 4
 .SH NAME
 pstat \- print system facts
 .SH SYNOPSIS
 .B /etc/pstat
 .UC 4
 .SH NAME
 pstat \- print system facts
 .SH SYNOPSIS
 .B /etc/pstat

-[

 .B \-aixptufT
 .B \-aixptufT

-] [ suboptions ]
-[ file ]
+[
+.B suboptions
+] [
+.B system
+] [
+.B corefile
+]

 .SH DESCRIPTION
 .I Pstat
 interprets the contents of certain system tables.
 If
 .SH DESCRIPTION
 .I Pstat
 interprets the contents of certain system tables.
 If

-.I file
+.I corefile

 is given, the tables are sought there, otherwise
 in
 .I /dev/kmem.
 The required namelist is taken from
 is given, the tables are sought there, otherwise
 in
 .I /dev/kmem.
 The required namelist is taken from

-.I /vmunix.
+.I /vmunix
+unless 
+.I system
+is specified.

 Options are
 .TP \w'WCHAN\ 'u
 .B \-a
 Options are
 .TP \w'WCHAN\ 'u
 .B \-a


@@ -37,7 +44,7 @@ Miscellaneous state variables encoded thus:
 locked
 .IP U
 update time
 locked
 .IP U
 update time

-.IR (filsys (5))
+.RI ( fs (5))

 must be corrected
 .IP A
 access time must be corrected
 must be corrected
 .IP A
 access time must be corrected


@@ -49,12 +56,23 @@ wanted by another process (L flag is on)
 contains a text file
 .IP C
 changed time must be corrected
 contains a text file
 .IP C
 changed time must be corrected

+.IP S
+shared lock applied
+.IP E
+exclusive lock applied
+.IP Z
+someone waiting for an exclusive lock

 .RE
 .IP CNT
 Number of open file table entries for this inode.
 .IP DEV
 Major and minor device number of file system in which
 this inode resides.
 .RE
 .IP CNT
 Number of open file table entries for this inode.
 .IP DEV
 Major and minor device number of file system in which
 this inode resides.

+.IP RDC
+Reference count of shared locks on the inode.
+.IP WRC
+Reference count of exclusive locks on the inode (this may
+be > 1 if, for example, a file descriptor is inherited across a fork).

 .IP INO
 I-number within the device.
 .IP MODE
 .IP INO
 I-number within the device.
 .IP MODE


@@ -90,7 +108,7 @@ locked
 wanted (L flag is on)
 .IP P
 resulted from demand-page-from-inode exec format (see
 wanted (L flag is on)
 .IP P
 resulted from demand-page-from-inode exec format (see

-.IR exec (2))
+.IR execve (2))

 .RE
 .PD
 .IP DADDR
 .RE
 .PD
 .IP DADDR


@@ -189,7 +207,7 @@ process is owed a profiling tick.
 number of pages currently being pushed out from this process.
 .IP PRI
 Scheduling priority, see
 number of pages currently being pushed out from this process.
 .IP PRI
 Scheduling priority, see

-.IR nice (2).
+.IR setpriority (2).

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


@@ -203,7 +221,7 @@ Weighted integral of CPU time, for scheduler.
 .IP NI
 Nice level,
 see
 .IP NI
 Nice level,
 see

-.IR nice (2).
+.IR setpriority (2).

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


@@ -294,6 +312,8 @@ be a core image and the address 0.
 Print the open file table with these headings:
 .IP LOC
 The core location of this table entry.
 Print the open file table with these headings:
 .IP LOC
 The core location of this table entry.

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

 .PD 0
 .IP FLG
 Miscellaneous state variables encoded thus:
 .PD 0
 .IP FLG
 Miscellaneous state variables encoded thus:


@@ -302,16 +322,17 @@ Miscellaneous state variables encoded thus:
 open for reading
 .IP W
 open for writing
 open for reading
 .IP W
 open for writing

-.IP P
-pipe
+.IP A
+open for appending

 .RE
 .IP CNT
 Number of processes that know this open file.
 .IP INO
 The location of the inode table entry for this file.
 .RE
 .IP CNT
 Number of processes that know this open file.
 .IP INO
 The location of the inode table entry for this file.

-.IP OFFS
-The file offset, see
-.IR lseek (2).
+.IP OFFS/SOCK
+The file offset (see
+.IR lseek (2)),
+or the core address of the associated socket structure.

 .PD
 .PP
 .B \-s
 .PD
 .PP
 .B \-s


@@ -323,19 +344,15 @@ to text images.
 prints the number of used and free slots in the several system tables
 and is useful for checking to see how full system tables have become if the
 system is under heavy load.
 prints the number of used and free slots in the several system tables
 and is useful for checking to see how full system tables have become if the
 system is under heavy load.

-.B \-m
-and
-.B \-g
-flags print the multiplexor tables.  These tables are rather difficult to
-explain.  The potential explorer should examine the multiplexor code in
-the system.

 .SH FILES
 .ta \w'/dev/kmem  'u
 /vmunix        namelist
 .br
 /dev/kmem      default source of tables
 .SH SEE ALSO
 .SH FILES
 .ta \w'/dev/kmem  'u
 /vmunix        namelist
 .br
 /dev/kmem      default source of tables
 .SH SEE ALSO

-ps(1), stat(2), filsys(5)
+ps(1),
+stat(2),
+fs(5)

 .br
 K. Thompson,
 .I UNIX Implementation
 .br
 K. Thompson,
 .I UNIX Implementation