1 .\" Copyright (c) 1980, 1991, 1993, 1994
2 .\" The Regents of the University of California. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. All advertising materials mentioning features or use of this software
13 .\" must display the following acknowledgement:
14 .\" This product includes software developed by the University of
15 .\" California, Berkeley and its contributors.
16 .\" 4. Neither the name of the University nor the names of its contributors
17 .\" may be used to endorse or promote products derived from this software
18 .\" without specific prior written permission.
20 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32 .\" @(#)pstat.8 8.5 (Berkeley) 5/13/94
41 .Nd display system data structures
54 displays open file entry, swap space utilization,
55 terminal state, and vnode data structures.
61 option is implied, and only the
65 The following options are available:
66 .Bl -tag -width indent
68 Print devices out by major/minor instead of name.
70 Print sizes in kilobytes, regardless of the setting of the
74 Print the number of used and free slots in several system tables.
75 This is useful for checking to see how large system tables have become
76 if the system is under heavy load.
78 Print the open file table with these headings:
79 .Bl -tag -width indent
81 The core location of this table entry.
83 The type of object the file table entry points to.
85 Miscellaneous state variables encoded thus:
87 .Bl -tag -width indent -compact
95 signal pgrp when data ready
98 Number of processes that know this open file.
100 Number of messages outstanding for this file.
102 The location of the vnode table entry or socket structure for this file.
108 Print information about swap space usage on all the
109 swap areas compiled into the kernel.
110 The first column is the device name of the partition. The next column is
111 the total space available in the partition. The
113 column indicates the total blocks used so far; the
115 column indicates how much space is remaining on each partition.
118 reports the percentage of space used.
120 If more than one partition is configured into the system, totals for all
121 of the statistics will be reported in the final line of the report.
123 If you supply the option again, as in
125 the system will display a breakdown of the swap bitmap/radix-tree.
127 Print table for terminals
129 .Bl -tag -width indent
131 Number of characters in raw input queue.
133 Number of characters in canonicalized input queue.
135 Number of characters in output queue.
140 Physical device address.
142 Number of delimiters (newlines) in canonicalized input queue.
144 Calculated column position of terminal.
146 Miscellaneous state variables encoded thus:
148 .Bl -tag -width indent -compact
150 delay timeout in progress
152 waiting for open to complete
156 outq has been flushed during DMA
164 process is waiting for space in output queue
166 process is waiting for output to complete
168 open for exclusive use
170 output stopped (ixon flow control)
172 output stopped (carrier flow control)
174 output stopped (CTS flow control)
176 output stopped (DSR flow control)
180 send SIGIO for input events
190 next character is literal
192 retyping suspended input (PENDIN)
194 counting tab width, ignore FLUSHO
196 block mode input routine in use
203 Kernel address of the session structure.
205 Process group for which this is controlling terminal.
229 (This option is no longer supported.)
231 Print the active vnodes. Each group of vnodes corresponding
232 to a particular filesystem is preceded by a two line header. The
233 first line consists of the following:
234 .Bd -ragged -offset indent
235 .No *** MOUNT Em fstype from
243 .Em ufs , nfs , or pc ;
245 is the filesystem is mounted from;
248 the filesystem is mounted on; and
251 of optional flags applied to the mount (see
253 The second line is a header for the individual fields,
254 the first part of which are fixed, and the second part are filesystem
255 type specific. The headers common to all vnodes are:
256 .Bl -tag -width indent
258 Location of this vnode.
262 A list of letters representing vnode flags:
264 .Bl -tag -width indent -compact
299 The number of references to this vnode.
301 The number of I/O buffers held by this vnode.
306 this is the inode number.
308 Miscellaneous filesystem specific state variables encoded thus:
309 .Bl -tag -width indent
312 .Bl -tag -width indent -compact
320 access time must be corrected
322 changed time must be corrected
324 modification time most be corrected
326 contains modifications
328 has a rename in progress
330 inode is on hash list
332 modified, but don't write key
335 .Bl -tag -width indent -compact
338 waiting for I/O buffer flush to complete
340 I/O buffers being flushed
342 locally modified data exists
344 an earlier write failed
346 special file accessed
350 special file times changed
354 someone wants to lock
358 Number of bytes in an ordinary file, or
359 major and minor device of special file.
364 present for backwards-compatibility.
366 Extract values associated with the name list from the specified core
367 instead of the default
370 Extract the name list from the specified system instead of the default
374 .Bl -tag -width /dev/memxxx -compact
378 default source of tables
388 .%T UNIX Implementation