|
|
1.1 root 1: .TH PSTAT 8
2: .CT 1 sa_mortals
3: .SH NAME
4: pstat \- print system facts
5: .SH SYNOPSIS
6: .B /etc/pstat
7: [
8: .B \-afipstuxT
9: ]
10: [
11: .I suboptions
12: ]
13: [
14: .I file
15: ]
16: [
17: .I namelist
18: ]
19: .SH DESCRIPTION
20: .I Pstat
21: interprets the contents of certain system tables.
22: If
23: .I file
24: is given, the tables are sought there, otherwise
25: in
26: .FR /dev/kmem .
27: The required namelist is taken from
28: .IR namelist ,
29: default
30: .FR /unix .
31: Options are
32: .TP
33: .B -a
34: Under
35: .BR -p ,
36: describe all process slots rather than just active ones.
37: .TP
38: .B -i
39: Print the inode table with the these headings:
40: .RS
41: .PD 0
42: .TF SIGNAL
43: .TP
44: .B LOC
45: The core location of this table entry.
46: .TP
47: .B FLAGS
48: Miscellaneous state variables encoded thus:
49: .RS
50: .TP
51: .B L
52: locked
53: .TP
54: .B U
55: modified time
56: .RI ( filsys (5))
57: must be corrected
58: .TP
59: .B A
60: access time must be corrected
61: .TP
62: .B O
63: file was opened
64: .TP
65: .B W
66: wanted by another process
67: .RB ( L
68: flag is on)
69: .TP
70: .B T
71: contains an active text
72: .RE
73: .TP
74: .B CNT
75: Number of active references to this inode.
76: .TP
77: .B FS
78: File system type, see
79: .IR fmount (2).
80: .TP
81: .B DEVICE
82: Device number of file system in which
83: this inode resides.
84: .TP
85: .B INO
86: I-number within the file system.
87: .TP
88: .B MODE
89: Mode, see
90: .IR stat (2).
91: .TP
92: .B NLN
93: Number of links to this inode.
94: .TP
95: .B UID
96: Userid of owner.
97: .TP
98: .B SPTR
99: Core location of corresponding stream header,
100: 0 if this is not a stream.
101: .TP
102: .B SIZ/DEV
103: Number of bytes in an ordinary file, or
104: device number of a special file.
105: .TP
106: .B MROOT
107: Core location of root inode
108: of file system mounted here,
109: 0 if none.
110: .PD
111: .RE
112: .TP 0
113: .B -x
114: Print the text table with these headings:
115: .PD 0
116: .RS
117: .TF SIGNAL
118: .TP
119: .B LOC
120: The core location of this table entry.
121: .TP
122: .B FLAGS
123: Miscellaneous state variables encoded thus:
124: .RS
125: .TP
126: .B P
127: resulted from demand-page-from-inode exec format, see
128: .IR exec (2)
129: .TP
130: .B T
131: traced through
132: .IR proc (4)
133: .TP
134: .B W
135: text not yet written to swap device
136: .TP
137: .B L
138: loading in progress
139: .TP
140: .B K
141: locked
142: .TP
143: .B w
144: wanted
145: .RB ( L
146: flag is on)
147: .RE
148: .TP
149: .B DADDR
150: Disk address in swap, in multiples of 512 bytes.
151: .TP
152: .B CADDR
153: Head of a linked list of loaded processes using this text segment.
154: .TP
155: .B RSS
156: Size of physical memory occupied
157: by text segment,
158: in multiples of 512 bytes.
159: .TP
160: .B SIZE
161: Size of text segment, in multiples of 512 bytes.
162: .TP
163: .B IPTR
164: Core location of corresponding inode.
165: .TP
166: .B CNT
167: Number of processes using this text segment.
168: .TP
169: .B CCNT
170: Number of processes in core using this text segment.
171: .PD
172: .RE
173: .TP 0
174: .B -p
175: Print process table for active processes with these headings:
176: .RS
177: .TP
178: .B LOC
179: The core location of this table entry.
180: .PD 0
181: .TF SIGNAL
182: .TP
183: .B S
184: Run state encoded thus:
185: .RS
186: .TP
187: .B 0
188: no process
189: .TP
190: .B 1
191: waiting for some event
192: .TP
193: .B 3
194: runnable
195: .TP
196: .B 4
197: being created
198: .TP
199: .B 5
200: being terminated
201: .TP
202: .B 6
203: stopped under trace
204: .RE
205: .TP
206: .B F
207: Miscellaneous state variables, or-ed together (hexadecimal):
208: .RS
209: .TF SIGNAL
210: .TP
211: .B 0000001
212: loaded in memory
213: .TP
214: .B 0000002
215: special system process (swapper or pager)
216: .TP
217: .B 0000004
218: being swapped out
219: .TP
220: .B 0000008
221: obscure swapout flag
222: .TP
223: .B 0000010
224: traced
225: .TP
226: .B 0000020
227: used in tracing
228: .TP
229: .B 0000040
230: locked in core
231: .TP
232: .B 0000080
233: waiting for pagein
234: .TP
235: .B 0000100
236: prevented from swapping during
237: .IR fork (2)
238: .TP
239: .B 0000200
240: gathering pages for raw i/o
241: .TP
242: .B 0000400
243: exiting
244: .TP
245: .B 0008000
246: associated text is demand paged from file
247: .TP
248: .B 0030000
249: anomalous paging behaviour expected,
250: see
251: .IR vlimit
252: in
253: .IR deprecated (2)
254: .TP
255: .B 0040000
256: in a sleep which will time out
257: .TP
258: .B 0400000
259: in
260: .IR select (2)
261: .TP
262: .B 0800000
263: traced via
264: .IR proc (4)
265: .TP
266: .B 1000000
267: i/o via
268: .IR proc
269: in progress
270: .TP
271: .B 2000000
272: stop on exec
273: .TP
274: .B 4000000
275: wanted by
276: .I proc
277: after pagein
278: .RE
279: .TF SIGNAL
280: .TP
281: .B ADDR
282: The core location of the page table entry for the first page of the `u-area.'
283: .TP
284: .B PRI
285: Scheduling priority;
286: smaller numbers run first.
287: .TP
288: .B SIG
289: Signals received; signals 1-32 coded in bits 0-31.
290: .TP
291: .B UID
292: Real userid.
293: .TP
294: .B SLP
295: Time blocked in seconds;
296: times over 127 coded as 127.
297: .TP
298: .B TIM
299: Time resident in seconds;
300: times over 127 coded as 127.
301: .TP
302: .B CPU
303: Weighted integral of CPU time, for scheduler.
304: .TP
305: .B NI
306: Nice level,
307: see
308: .IR nice (2).
309: .TP
310: .B PGRP
311: Process group number.
312: .TP
313: .B PID
314: Process ID number.
315: .TP
316: .B PPID
317: Process ID of parent process.
318: .TP
319: .B RSS
320: Number of physical page frames allocated
321: to this process.
322: .TP
323: .B SRSS
324: RSS at last swap, 0 if never swapped.
325: .TP
326: .B SIZE
327: Virtual size of process image (data+stack) in multiples of 512 bytes.
328: .TP
329: .B WCHAN
330: Event address if waiting.
331: .TP
332: .B LINK
333: Pointer to next entry in list of runnable processes.
334: .TP
335: .B TEXTP
336: If text is pure, pointer to location of text table entry.
337: .TP
338: .B CLKT
339: Countdown for
340: .IR alarm (2)
341: measured in seconds.
342: .PD
343: .RE
344: .TP 0
345: .B -u
346: Print information about a user process;
347: the next argument is its address as given
348: by
349: .L ADDR
350: under
351: .B -p
352: above.
353: The process must be in main memory, or the file used can
354: be a core image
355: .RI ( core (5))
356: and the address 0.
357: .TP
358: .B -f
359: Print the open file table with these headings:
360: .PD0
361: .RS
362: .TF SIGNAL
363: .TP
364: .B LOC
365: The core location of this table entry.
366: .PD 0
367: .TP
368: .B FLG
369: Miscellaneous state variables encoded thus:
370: .RS
371: .TP
372: .B R
373: open for reading
374: .TP
375: .B W
376: open for writing
377: .RE
378: .TP
379: .B CNT
380: Number of processes that know this open file.
381: .TP
382: .B INO
383: The core location of the inode table entry for this file.
384: .TP
385: .B OFFS
386: The file offset, see
387: .IR lseek (2).
388: .PD
389: .RE
390: .TP 0
391: .B -s
392: Print information about swap space usage:
393: the number of 1024 byte pages used
394: and free,
395: and the number of pages belonging
396: to text images.
397: .TP
398: .B -T
399: Print the number of used and free slots in several system tables;
400: useful to see if they are nearly full.
401: .SH FILES
402: .TF /dev/kmem
403: .TP
404: .F /unix
405: namelist
406: .TP
407: .F /dev/kmem
408: default source of tables
409: .SH SEE ALSO
410: .IR ps (1),
411: .IR stat (2),
412: .IR filsys (5)
413: .br
414: M. J. Bach,
415: .IR "The Design of the UNIX Operating System" ,
416: Prentice-Hall, 1986
417: .SH BUGS
418: This program is never up to date.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.