docs: Added UNIX V10 Manuals

1 files changed, 418 insertions, 0 deletions

diff --git a/static/v10/man8/pstat.8 b/static/v10/man8/pstat.8
new file mode 100644
index 00000000..61942bbf
--- /dev/null
+++ b/static/v10/man8/pstat.8
@@ -0,0 +1,418 @@
+.TH PSTAT 8
+.CT 1 sa_mortals
+.SH NAME
+pstat \- print system facts
+.SH SYNOPSIS
+.B /etc/pstat
+[
+.B \-afipstuxT
+]
+[
+.I suboptions
+]
+[
+.I file
+]
+[
+.I namelist
+]
+.SH DESCRIPTION
+.I Pstat
+interprets the contents of certain system tables.
+If
+.I file
+is given, the tables are sought there, otherwise
+in
+.FR /dev/kmem .
+The required namelist is taken from
+.IR namelist ,
+default
+.FR /unix .
+Options are
+.TP 
+.B -a
+Under
+.BR -p ,
+describe all process slots rather than just active ones.
+.TP
+.B -i
+Print the inode table with the these headings:
+.RS
+.PD 0
+.TF SIGNAL
+.TP
+.B LOC
+The core location of this table entry.
+.TP
+.B FLAGS
+Miscellaneous state variables encoded thus:
+.RS
+.TP
+.B L
+locked
+.TP
+.B U
+modified time
+.RI ( filsys (5))
+must be corrected
+.TP
+.B A
+access time must be corrected
+.TP
+.B O
+file was opened
+.TP
+.B W
+wanted by another process 
+.RB ( L
+flag is on)
+.TP
+.B T
+contains an active text
+.RE
+.TP
+.B CNT
+Number of active references to this inode.
+.TP
+.B FS
+File system type, see
+.IR fmount (2).
+.TP
+.B DEVICE
+Device number of file system in which
+this inode resides.
+.TP
+.B INO
+I-number within the file system.
+.TP
+.B MODE
+Mode, see
+.IR stat (2).
+.TP
+.B NLN
+Number of links to this inode.
+.TP
+.B UID
+Userid of owner.
+.TP
+.B SPTR
+Core location of corresponding stream header,
+0 if this is not a stream.
+.TP
+.B SIZ/DEV
+Number of bytes in an ordinary file, or
+device number of a special file.
+.TP
+.B MROOT
+Core location of root inode
+of file system mounted here,
+0 if none.
+.PD
+.RE
+.TP 0
+.B -x
+Print the text table with these headings:
+.PD 0
+.RS
+.TF SIGNAL
+.TP
+.B LOC
+The core location of this table entry.
+.TP
+.B FLAGS
+Miscellaneous state variables encoded thus:
+.RS
+.TP
+.B P
+resulted from demand-page-from-inode exec format, see
+.IR exec (2)
+.TP
+.B T
+traced through
+.IR proc (4)
+.TP
+.B W
+text not yet written to swap device
+.TP
+.B L
+loading in progress
+.TP
+.B K
+locked
+.TP
+.B w
+wanted 
+.RB ( L
+flag is on)
+.RE
+.TP
+.B DADDR
+Disk address in swap, in multiples of 512 bytes.
+.TP
+.B CADDR
+Head of a linked list of loaded processes using this text segment.
+.TP
+.B RSS
+Size of physical memory occupied
+by text segment,
+in multiples of 512 bytes.
+.TP
+.B SIZE
+Size of text segment, in multiples of 512 bytes.
+.TP
+.B IPTR
+Core location of corresponding inode.
+.TP
+.B CNT
+Number of processes using this text segment.
+.TP
+.B CCNT
+Number of processes in core using this text segment.
+.PD
+.RE
+.TP 0
+.B -p
+Print process table for active processes with these headings:
+.RS
+.TP
+.B LOC
+The core location of this table entry.
+.PD 0
+.TF SIGNAL
+.TP
+.B S
+Run state encoded thus:
+.RS
+.TP
+.B 0
+no process
+.TP
+.B 1
+waiting for some event
+.TP
+.B 3
+runnable
+.TP
+.B 4
+being created
+.TP
+.B 5
+being terminated
+.TP
+.B 6
+stopped under trace
+.RE
+.TP
+.B F
+Miscellaneous state variables, or-ed together (hexadecimal):
+.RS
+.TF SIGNAL
+.TP
+.B 0000001
+loaded in memory
+.TP
+.B 0000002
+special system process (swapper or pager)
+.TP
+.B 0000004
+being swapped out
+.TP
+.B 0000008
+obscure swapout flag
+.TP
+.B 0000010
+traced
+.TP
+.B 0000020
+used in tracing
+.TP
+.B 0000040
+locked in core
+.TP
+.B 0000080
+waiting for pagein
+.TP
+.B 0000100
+prevented from swapping during
+.IR fork (2)
+.TP
+.B 0000200
+gathering pages for raw i/o
+.TP
+.B 0000400
+exiting
+.TP
+.B 0008000
+associated text is demand paged from file
+.TP
+.B 0030000
+anomalous paging behaviour expected,
+see
+.IR vlimit
+in
+.IR deprecated (2)
+.TP
+.B 0040000
+in a sleep which will time out
+.TP
+.B 0400000
+in
+.IR select (2)
+.TP
+.B 0800000
+traced via
+.IR proc (4)
+.TP
+.B 1000000
+i/o via
+.IR proc
+in progress
+.TP
+.B 2000000
+stop on exec
+.TP
+.B 4000000
+wanted by
+.I proc
+after pagein
+.RE
+.TF SIGNAL
+.TP
+.B ADDR
+The core location of the page table entry for the first page of the `u-area.'
+.TP
+.B PRI
+Scheduling priority;
+smaller numbers run first.
+.TP
+.B SIG
+Signals received; signals 1-32 coded in bits 0-31.
+.TP
+.B UID
+Real userid.
+.TP
+.B SLP
+Time blocked in seconds;
+times over 127 coded as 127.
+.TP
+.B TIM
+Time resident in seconds;
+times over 127 coded as 127.
+.TP
+.B CPU
+Weighted integral of CPU time, for scheduler.
+.TP
+.B NI
+Nice level,
+see
+.IR nice (2).
+.TP
+.B PGRP
+Process group number.
+.TP
+.B PID
+Process ID number.
+.TP
+.B PPID
+Process ID of parent process.
+.TP
+.B RSS
+Number of physical page frames allocated
+to this process.
+.TP
+.B SRSS
+RSS at last swap, 0 if never swapped.
+.TP
+.B SIZE
+Virtual size of process image (data+stack) in multiples of 512 bytes.
+.TP
+.B WCHAN
+Event address if waiting.
+.TP
+.B LINK
+Pointer to next entry in list of runnable processes.
+.TP
+.B TEXTP
+If text is pure, pointer to location of text table entry.
+.TP
+.B CLKT
+Countdown for
+.IR alarm (2)
+measured in seconds.
+.PD
+.RE
+.TP 0
+.B -u
+Print information about a user process;
+the next argument is its address as given
+by
+.L ADDR
+under
+.B -p
+above.
+The process must be in main memory, or the file used can
+be a core image
+.RI ( core (5))
+and the address 0.
+.TP
+.B -f
+Print the open file table with these headings:
+.PD0
+.RS
+.TF SIGNAL
+.TP
+.B LOC
+The core location of this table entry.
+.PD 0
+.TP
+.B FLG
+Miscellaneous state variables encoded thus:
+.RS
+.TP
+.B R
+open for reading
+.TP
+.B W
+open for writing
+.RE
+.TP
+.B CNT
+Number of processes that know this open file.
+.TP
+.B INO
+The core location of the inode table entry for this file.
+.TP
+.B OFFS
+The file offset, see
+.IR lseek (2).
+.PD
+.RE
+.TP 0
+.B -s
+Print information about swap space usage:
+the number of 1024 byte pages used
+and free,
+and the number of pages belonging
+to text images.
+.TP
+.B -T
+Print the number of used and free slots in several system tables;
+useful to see if they are nearly full.
+.SH FILES
+.TF /dev/kmem
+.TP
+.F /unix
+namelist
+.TP
+.F /dev/kmem
+default source of tables
+.SH SEE ALSO
+.IR ps (1),
+.IR stat (2), 
+.IR filsys (5)
+.br
+M. J. Bach,
+.IR "The Design of the UNIX Operating System" ,
+Prentice-Hall, 1986
+.SH BUGS
+This program is never up to date.