1 .\" Copyright (c) 1980, 1991, 1993, 1994
2 .\" The Regents of the University of California. All rights reserved.
3 .\" Copyright (c) 2002 Networks Associates Technology, Inc.
4 .\" All rights reserved.
6 .\" Portions of this software was developed for the FreeBSD Project by
7 .\" ThinkSec AS and NAI Labs, the Security Research Division of Network
8 .\" Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
9 .\" ("CBOSS"), as part of the DARPA CHATS research program.
11 .\" Redistribution and use in source and binary forms, with or without
12 .\" modification, are permitted provided that the following conditions
14 .\" 1. Redistributions of source code must retain the above copyright
15 .\" notice, this list of conditions and the following disclaimer.
16 .\" 2. Redistributions in binary form must reproduce the above copyright
17 .\" notice, this list of conditions and the following disclaimer in the
18 .\" documentation and/or other materials provided with the distribution.
19 .\" 4. Neither the name of the University nor the names of its contributors
20 .\" may be used to endorse or promote products derived from this software
21 .\" without specific prior written permission.
23 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
24 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
27 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
28 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
29 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
30 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
31 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
35 .\" @(#)pstat.8 8.5 (Berkeley) 5/13/94
44 .Nd display system data structures
48 .Op Fl M Ar core Op Fl N Ar system
51 .Op Fl M Ar core Op Fl N Ar system
55 utility displays open file entry, swap space utilization,
56 terminal state, and vnode data structures.
62 option is implied, and only the
70 option is not specified, information is obtained from
71 the currently running kernel via the
74 Otherwise, information is read from the specified core file,
75 using the name list from the specified kernel image (or from
78 The following options are available:
79 .Bl -tag -width indent
81 Print devices out by major/minor instead of name.
85 Use unit suffixes when printing swap partition sizes:
86 Byte, Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte.
88 Print sizes in kilobytes, regardless of the setting of the
92 Print sizes in megabytes, regardless of the setting of the
96 Print sizes in gigabytes, regardless of the setting of the
100 Print the number of used and free slots in several system tables.
101 This is useful for checking to see how large system tables have become
102 if the system is under heavy load.
104 Print the open file table with these headings:
105 .Bl -tag -width indent
107 The core location of this table entry.
109 The type of object the file table entry points to.
111 Miscellaneous state variables encoded thus:
113 .Bl -tag -width indent -compact
121 signal pgrp when data ready
124 Number of processes that know this open file.
126 Number of messages outstanding for this file.
128 The location of the vnode table entry or socket structure for this file.
134 Print information about swap space usage on all the
135 swap areas compiled into the kernel.
136 The first column is the device name of the partition.
138 the total space available in the partition.
141 column indicates the total blocks used so far; the
143 column indicates how much space is remaining on each partition.
146 reports the percentage of space used.
148 If more than one partition is configured into the system, totals for all
149 of the statistics will be reported in the final line of the report.
151 Print table for terminals
153 .Bl -tag -width indent
157 Number of characters in raw input queue.
159 Number of characters in canonicalized input queue.
161 Number of characters in output queue.
163 High water mark for input.
165 Low water mark for input.
167 High water mark for output.
169 Low water mark for output.
171 Calculated column position of terminal.
173 Miscellaneous state variables encoded thus:
175 .Bl -tag -width indent -compact
177 delay timeout in progress
179 waiting for open to complete
183 outq has been flushed during DMA
191 process is waiting for space in output queue
193 process is waiting for output to complete
195 open for exclusive use
197 output stopped (ixon flow control)
199 output stopped (carrier flow control)
201 output stopped (CTS flow control)
203 output stopped (DSR flow control)
207 send SIGIO for input events
217 next character is literal
219 retyping suspended input (PENDIN)
221 counting tab width, ignore FLUSHO
223 block mode input routine in use
230 Kernel address of the session structure.
232 Process group for which this is the controlling terminal.
252 Extract values associated with the name list from the specified core.
257 extract the name list from the specified system instead of the default,
258 which is the kernel image the system has booted from.
268 .%T UNIX Implementation