Commit | Line | Data |
---|---|---|
713bd1bd BJ |
1 | .TH PSTAT 1M |
2 | .UC | |
3 | .SH NAME | |
4 | pstat \- print system facts | |
5 | .SH SYNOPSIS | |
6 | .B pstat | |
7 | [ | |
8 | .B \-aixptuf | |
9 | ] [ suboptions ] | |
10 | [ file ] | |
11 | .SH DESCRIPTION | |
12 | .I Pstat | |
13 | interprets the contents of certain system tables. | |
14 | If | |
15 | .I file | |
16 | is given, the tables are sought there, otherwise | |
17 | in | |
18 | .I /dev/kmem. | |
19 | The required namelist is taken from | |
20 | .I /vmunix. | |
21 | Options are | |
22 | .TP \w'WCHAN\ 'u | |
23 | .B \-a | |
24 | Under | |
25 | .BR \-p , | |
26 | describe all process slots rather than just active ones. | |
27 | .TP | |
28 | .B \-i | |
29 | Print the inode table with the these headings: | |
30 | .IP LOC | |
31 | The core location of this table entry. | |
32 | .PD 0 | |
33 | .IP FLAGS | |
34 | Miscellaneous state variables encoded thus: | |
35 | .RS | |
36 | .IP L | |
37 | locked | |
38 | .IP U | |
39 | update time | |
40 | .IR filsys (5)) | |
41 | must be corrected | |
42 | .IP A | |
43 | access time must be corrected | |
44 | .IP M | |
45 | file system is mounted here | |
46 | .IP W | |
47 | wanted by another process (L flag is on) | |
48 | .IP T | |
49 | contains a text file | |
50 | .IP C | |
51 | changed time must be corrected | |
52 | .RE | |
53 | .IP CNT | |
54 | Number of open file table entries for this inode. | |
55 | .IP DEV | |
56 | Major and minor device number of file system in which | |
57 | this inode resides. | |
58 | .IP INO | |
59 | I-number within the device. | |
60 | .IP MODE | |
61 | Mode bits, see | |
62 | .IR chmod (2). | |
63 | .IP NLK | |
64 | Number of links to this inode. | |
65 | .IP UID | |
66 | User ID of owner. | |
67 | .IP SIZ/DEV | |
68 | Number of bytes in an ordinary file, or | |
69 | major and minor device of special file. | |
70 | .PD | |
71 | .TP | |
72 | .B \-x | |
73 | Print the text table with these headings: | |
74 | .IP LOC | |
75 | The core location of this table entry. | |
76 | .PD 0 | |
77 | .IP FLAGS | |
78 | Miscellaneous state variables encoded thus: | |
79 | .RS | |
80 | .IP T | |
81 | .IR ptrace (2) | |
82 | in effect | |
83 | .IP W | |
84 | text not yet written on swap device | |
85 | .IP L | |
86 | loading in progress | |
87 | .IP K | |
88 | locked | |
89 | .IP w | |
90 | wanted (L flag is on) | |
91 | .IP P | |
92 | resulted from demand-page-from-inode exec format (see | |
93 | .IR exec (2)) | |
94 | .RE | |
95 | .PD | |
96 | .IP DADDR | |
97 | Disk address in swap, measured in multiples of 512 bytes. | |
98 | .IP CADDR | |
99 | Head of a linked list of loaded processes using this text segment. | |
100 | .IP SIZE | |
101 | Size of text segment, measured in multiples of 512 bytes. | |
102 | .IP IPTR | |
103 | Core location of corresponding inode. | |
104 | .IP CNT | |
105 | Number of processes using this text segment. | |
106 | .IP CCNT | |
107 | Number of processes in core using this text segment. | |
108 | .PD | |
109 | .TP | |
110 | .B \-p | |
111 | Print process table for active processes with these headings: | |
112 | .IP LOC | |
113 | The core location of this table entry. | |
114 | .PD 0 | |
115 | .IP S | |
116 | Run state encoded thus: | |
117 | .RS | |
118 | .IP 0 | |
119 | no process | |
120 | .IP 1 | |
121 | waiting for some event | |
122 | .IP 3 | |
123 | runnable | |
124 | .IP 4 | |
125 | being created | |
126 | .IP 5 | |
127 | being terminated | |
128 | .IP 6 | |
129 | stopped under trace | |
130 | .RE | |
131 | .IP F | |
132 | Miscellaneous state variables, or-ed together (hexadecimal): | |
133 | .RS | |
134 | .IP 0001 | |
135 | loaded | |
136 | .IP 0002 | |
137 | the scheduler process | |
138 | .IP 0004 | |
139 | locked for swap out | |
140 | .IP 0008 | |
141 | swapped out | |
142 | .IP 0010 | |
143 | traced | |
144 | .IP 0020 | |
145 | used in tracing | |
146 | .IP 0040 | |
147 | locked in by | |
148 | .IR lock (2). | |
149 | .IP 0080 | |
150 | in page-wait | |
151 | .IP 0100 | |
152 | prevented from swapping during | |
153 | .IR fork (2) | |
154 | .IP 0200 | |
155 | gathering pages for raw i/o | |
156 | .IP 0400 | |
157 | exiting | |
158 | .IP 1000 | |
159 | process resulted from a | |
160 | .IR vfork (2) | |
161 | which is not yet complete | |
162 | .IP 2000 | |
163 | another flag for | |
164 | .IR vfork (2) | |
165 | .IP 4000 | |
166 | process has no virtual memory, as it is a parent in the context of | |
167 | .IR vfork (2) | |
168 | .IP 8000 | |
169 | process is demand paging data pages from its text inode. | |
170 | .RE | |
171 | .IP POIP | |
172 | number of pages currently being pushed out from this process. | |
173 | .IP PRI | |
174 | Scheduling priority, see | |
175 | .IR nice (2). | |
176 | .IP SIGNAL | |
177 | Signals received (signals 1-16 coded in bits 0-15), | |
178 | .IP UID | |
179 | Real user ID. | |
180 | .IP SLP | |
181 | Amount of time process has been blocked. | |
182 | .IP TIM | |
183 | Time resident in seconds; times over 127 coded as 127. | |
184 | .IP CPU | |
185 | Weighted integral of CPU time, for scheduler. | |
186 | .IP NI | |
187 | Nice level, | |
188 | see | |
189 | .IR nice (2). | |
190 | .IP PGRP | |
191 | Process number of root of process group | |
192 | (the opener of the controlling terminal). | |
193 | .IP PID | |
194 | The process ID number. | |
195 | .IP PPID | |
196 | The process ID of parent process. | |
197 | .IP ADDR | |
198 | If in core, the page frame number of the first page of the `u-area' of | |
199 | the process. | |
200 | If swapped out, the position in the swap area | |
201 | measured in multiples of 512 bytes. | |
202 | .IP RSS | |
203 | Resident set size \- the number of physical page frames allocated | |
204 | to this process. | |
205 | .IP SRSS | |
206 | RSS at last swap (0 if never swapped). | |
207 | .IP SIZE | |
208 | Virtual size of process image (data+stack) in multiples of 512 bytes. | |
209 | .IP WCHAN | |
210 | Wait channel number of a waiting process. | |
211 | .IP LINK | |
212 | Link pointer in list of runnable processes. | |
213 | .IP TEXTP | |
214 | If text is pure, pointer to location of text table entry. | |
215 | .IP CLKT | |
216 | Countdown for | |
217 | .IR alarm (2) | |
218 | measured in seconds. | |
219 | .PD | |
220 | .TP | |
221 | .B \-t | |
222 | Print table for terminals | |
223 | with these headings: | |
224 | .IP RAW | |
225 | Number of characters in raw input queue. | |
226 | .PD 0 | |
227 | .IP CAN | |
228 | Number of characters in canonicalized input queue. | |
229 | .IP OUT | |
230 | Number of characters in putput queue. | |
231 | .IP MODE | |
232 | See | |
233 | .IR tty (4). | |
234 | .IP ADDR | |
235 | Physical device address. | |
236 | .IP DEL | |
237 | Number of delimiters (newlines) in canonicalized input queue. | |
238 | .IP COL | |
239 | Calculated column position of terminal. | |
240 | .IP STATE | |
241 | Miscellaneous state variables encoded thus: | |
242 | .RS | |
243 | .IP W | |
244 | waiting for open to complete | |
245 | .IP O | |
246 | open | |
247 | .IP S | |
248 | has special (output) start routine | |
249 | .IP C | |
250 | carrier is on | |
251 | .IP B | |
252 | busy doing output | |
253 | .IP A | |
254 | process is awaiting output | |
255 | .IP X | |
256 | open for exclusive use | |
257 | .IP H | |
258 | hangup on close | |
259 | .RE | |
260 | .IP PGRP | |
261 | Process group for which this is controlling terminal. | |
262 | .PD | |
263 | .TP | |
264 | .B \-u | |
265 | print information about a user process; | |
266 | the next argument is its address as given | |
267 | by | |
268 | .IR ps (1). | |
269 | The process must be in main memory, or the file used can | |
270 | be a core image and the address 0. | |
271 | .TP | |
272 | .B \-f | |
273 | Print the open file table with these headings: | |
274 | .IP LOC | |
275 | The core location of this table entry. | |
276 | .PD 0 | |
277 | .IP FLG | |
278 | Miscellaneous state variables encoded thus: | |
279 | .RS | |
280 | .IP R | |
281 | open for reading | |
282 | .IP W | |
283 | open for writing | |
284 | .IP P | |
285 | pipe | |
286 | .RE | |
287 | .IP CNT | |
288 | Number of processes that know this open file. | |
289 | .IP INO | |
290 | The location of the inode table entry for this file. | |
291 | .IP OFFS | |
292 | The file offset, see | |
293 | .IR lseek (2). | |
294 | .PD | |
295 | .PP | |
296 | .SH FILES | |
297 | .ta \w'/dev/kmem 'u | |
298 | /vmunix namelist | |
299 | .br | |
300 | /dev/kmem default source of tables | |
301 | .SH SEE ALSO | |
302 | ps(1), stat(2), filsys(5) | |
303 | .br | |
304 | K. Thompson, | |
305 | .I UNIX Implementation | |
306 | .br | |
307 | O. Babaoglu and W. Joy | |
308 | .I "Data Structures added in the Berkeley Virtual Memory Extensions to the UNIX System" |