![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to pstat.8 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / man / man8|
Return to pstat.8 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / man / man8 |
1.1 root 1: .\" Copyright (c) 1980 Regents of the University of California.
2: .\" All rights reserved. The Berkeley software License Agreement
3: .\" specifies the terms and conditions for redistribution.
4: .\"
5: .\" @(#)pstat.8 6.3 (Berkeley) 5/24/86
6: .\"
7: .TH PSTAT 8 "May 24, 1986"
8: .UC 4
9: .SH NAME
10: pstat \- print system facts
11: .SH SYNOPSIS
12: .B /etc/pstat
13: .B \-aixptufT
14: [
15: .B suboptions
16: ] [
17: .B system
18: ] [
19: .B corefile
20: ]
21: .SH DESCRIPTION
22: .I Pstat
23: interprets the contents of certain system tables.
24: If
25: .I corefile
26: is given, the tables are sought there, otherwise
27: in
28: .I /dev/kmem.
29: The required namelist is taken from
30: .I /vmunix
31: unless
32: .I system
33: is specified.
34: Options are
35: .TP \w'WCHAN\ 'u
36: .B \-a
37: Under
38: .BR \-p ,
39: describe all process slots rather than just active ones.
40: .TP
41: .B \-i
42: Print the inode table with the these headings:
43: .IP LOC
44: The core location of this table entry.
45: .PD 0
46: .IP FLAGS
47: Miscellaneous state variables encoded thus:
48: .RS
49: .IP L
50: locked
51: .IP U
52: update time
53: .RI ( fs (5))
54: must be corrected
55: .IP A
56: access time must be corrected
57: .IP M
58: file system is mounted here
59: .IP W
60: wanted by another process (L flag is on)
61: .IP T
62: contains a text file
63: .IP C
64: changed time must be corrected
65: .IP S
66: shared lock applied
67: .IP E
68: exclusive lock applied
69: .IP Z
70: someone waiting for a lock
71: .RE
72: .IP CNT
73: Number of open file table entries for this inode.
74: .IP DEV
75: Major and minor device number of file system in which
76: this inode resides.
77: .IP RDC
78: Reference count of shared locks on the inode.
79: .IP WRC
80: Reference count of exclusive locks on the inode (this may
81: be > 1 if, for example, a file descriptor is inherited across a fork).
82: .IP INO
83: I-number within the device.
84: .IP MODE
85: Mode bits, see
86: .IR chmod (2).
87: .IP NLK
88: Number of links to this inode.
89: .IP UID
90: User ID of owner.
91: .IP SIZ/DEV
92: Number of bytes in an ordinary file, or
93: major and minor device of special file.
94: .PD
95: .TP
96: .B \-x
97: Print the text table with these headings:
98: .IP LOC
99: The core location of this table entry.
100: .PD 0
101: .IP FLAGS
102: Miscellaneous state variables encoded thus:
103: .RS
104: .IP T
105: .IR ptrace (2)
106: in effect
107: .IP W
108: text not yet written on swap device
109: .IP L
110: loading in progress
111: .IP K
112: locked
113: .IP w
114: wanted (L flag is on)
115: .IP P
116: resulted from demand-page-from-inode exec format (see
117: .IR execve (2))
118: .RE
119: .PD
120: .IP DADDR
121: Disk address in swap, measured in multiples of 512 bytes.
122: .IP CADDR
123: Head of a linked list of loaded processes using this text segment.
124: .IP RSS
125: Size of resident text, measured in multiples of 512 bytes.
126: .IP SIZE
127: Size of text segment, measured in multiples of 512 bytes.
128: .IP IPTR
129: Core location of corresponding inode.
130: .IP CNT
131: Number of processes using this text segment.
132: .IP CCNT
133: Number of processes in core using this text segment.
134: .IP FORW
135: Forward link in free list.
136: .IP BACK
137: Backward link in free list.
138: .PD
139: .TP
140: .B \-p
141: Print process table for active processes with these headings:
142: .IP LOC
143: The core location of this table entry.
144: .PD 0
145: .IP S
146: Run state encoded thus:
147: .RS
148: .IP 0
149: no process
150: .IP 1
151: waiting for some event
152: .IP 3
153: runnable
154: .IP 4
155: being created
156: .IP 5
157: being terminated
158: .IP 6
159: stopped (by signal or under trace)
160: .RE
161: .IP F
162: Miscellaneous state variables, or'ed together (hexadecimal):
163: .RS
164: .IP 0001 9n
165: loaded
166: .IP 0002
167: the scheduler process
168: .IP 0004
169: locked for swap out
170: .IP 0008
171: swapped out
172: .IP 0010
173: traced
174: .IP 0020
175: used in tracing
176: . \".IP 000040
177: . \"locked in by
178: . \".IR lock (2).
179: .IP 0080
180: in page-wait
181: .IP 0100
182: prevented from swapping during
183: .IR fork (2)
184: .IP 0200
185: will restore old mask after taking signal
186: .IP 0400
187: exiting
188: .IP 0800
189: doing physical I/O (bio.c)
190: .IP 1000
191: process resulted from a
192: .IR vfork (2)
193: which is not yet complete
194: .IP 2000
195: another flag for
196: .IR vfork (2)
197: .IP 4000
198: process has no virtual memory, as it is a parent in the context of
199: .IR vfork (2)
200: .IP 8000
201: process is demand paging data pages from its text inode.
202: .IP 10000
203: process using sequential VM patterns
204: .IP 20000
205: process using random VM patterns
206: .IP 100000
207: using old 4.1-compatible signal semantics
208: .IP 200000
209: process needs profiling tick
210: .IP 400000
211: process is scanning descriptors during select
212: .IP 1000000
213: process page tables have changed
214: .RE
215: .IP POIP
216: number of pages currently being pushed out from this process.
217: .IP PRI
218: Scheduling priority, see
219: .IR setpriority (2).
220: .IP SIG
221: Signals received (signals 1-32 coded in bits 0-31),
222: .IP UID
223: Real user ID.
224: .IP SLP
225: Amount of time process has been blocked.
226: .IP TIM
227: Time resident in seconds; times over 127 coded as 127.
228: .IP CPU
229: Weighted integral of CPU time, for scheduler.
230: .IP NI
231: Nice level,
232: see
233: .IR setpriority (2).
234: .IP PGRP
235: Process number of root of process group.
236: .IP PID
237: The process ID number.
238: .IP PPID
239: The process ID of parent process.
240: .IP ADDR
241: If in core, the page frame number of the first page of the `u-area' of
242: the process.
243: If swapped out, the position in the swap area
244: measured in multiples of 512 bytes.
245: .IP RSS
246: Resident set size \- the number of physical page frames allocated
247: to this process.
248: .IP SRSS
249: RSS at last swap (0 if never swapped).
250: .IP SIZE
251: Virtual size of process image (data+stack) in multiples of 512 bytes.
252: .IP WCHAN
253: Wait channel number of a waiting process.
254: .IP LINK
255: Link pointer in list of runnable processes.
256: .IP TEXTP
257: If text is pure, pointer to location of text table entry.
258: .PD
259: .TP
260: .B \-t
261: Print table for terminals
262: with these headings:
263: .IP RAW
264: Number of characters in raw input queue.
265: .PD 0
266: .IP CAN
267: Number of characters in canonicalized input queue.
268: .IP OUT
269: Number of characters in putput queue.
270: .IP MODE
271: See
272: .IR tty (4).
273: .IP ADDR
274: Physical device address.
275: .IP DEL
276: Number of delimiters (newlines) in canonicalized input queue.
277: .IP COL
278: Calculated column position of terminal.
279: .IP STATE
280: Miscellaneous state variables encoded thus:
281: .RS
282: .IP T
283: delay timeout in progress
284: .IP W
285: waiting for open to complete
286: .IP O
287: open
288: .IP F
289: outq has been flushed during DMA
290: .IP C
291: carrier is on
292: .IP B
293: busy doing output
294: .IP A
295: process is awaiting output
296: .IP X
297: open for exclusive use
298: .IP S
299: output stopped
300: .IP H
301: hangup on close
302: .RE
303: .IP PGRP
304: Process group for which this is controlling terminal.
305: .IP DISC
306: Line discipline; blank is old tty OTTYDISC or ``new tty'' for NTTYDISC
307: or ``net'' for NETLDISC (see
308: .IR bk (4)).
309: .PD
310: .TP
311: .B \-u
312: print information about a user process;
313: the next argument is its address as given
314: by
315: .IR ps (1).
316: The process must be in main memory, or the file used can
317: be a core image and the address 0.
318: Only the fields located in the first page cluster can be located
319: succesfully if the process is in main memory.
320: .TP
321: .B \-f
322: Print the open file table with these headings:
323: .IP LOC
324: The core location of this table entry.
325: .IP TYPE
326: The type of object the file table entry points to.
327: .PD 0
328: .IP FLG
329: Miscellaneous state variables encoded thus:
330: .RS
331: .IP R
332: open for reading
333: .IP W
334: open for writing
335: .IP A
336: open for appending
337: .IP S
338: shared lock present
339: .IP X
340: exclusive lock present
341: .IP I
342: signal pgrp when data ready
343: .RE
344: .IP CNT
345: Number of processes that know this open file.
346: .IP MSG
347: Number of messages outstanding for this file.
348: .IP DATA
349: The location of the inode table entry or socket structure for this file.
350: .IP OFFSET
351: The file offset (see
352: .IR lseek (2)).
353: .PD
354: .PP
355: .B \-s
356: print information about swap space usage: the number of (1k byte) pages used
357: and free is given as well as the number of used pages which belong
358: to text images.
359: .PP
360: .B \-T
361: prints the number of used and free slots in the several system tables
362: and is useful for checking to see how full system tables have become if the
363: system is under heavy load.
364: .SH FILES
365: .ta \w'/dev/kmem 'u
366: /vmunix namelist
367: .br
368: /dev/kmem default source of tables
369: .SH SEE ALSO
370: iostat(1),
371: ps(1),
372: systat(1),
373: vmstat(1),
374: stat(2),
375: fs(5),
376: .br
377: K. Thompson,
378: .I UNIX Implementation
379: .SH BUGS
380: It would be very useful if the system recorded \*(lqmaximum occupancy\*(rq
381: on the tables reported by
382: .B \-T;
383: even more useful if these tables were dynamically allocated.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.