.\" Copyright (c) 1980, 1991, 1993, 1994.\"	The Regents of the University of California.  All rights reserved..\".\"	@(#)pstat.8	8.4 (Berkeley) 4/19/94.\" Redistribution and use in source and binary forms, with or without.\" modification, are permitted provided that the following conditions.\" are met:.\" 1. Redistributions of source code must retain the above copyright.\"    notice, this list of conditions and the following disclaimer..\" 2. Redistributions in binary form must reproduce the above copyright.\"    notice, this list of conditions and the following disclaimer in the.\"    documentation and/or other materials provided with the distribution..\" 3. All advertising materials mentioning features or use of this software.\"    must display the following acknowledgement:.\"	This product includes software developed by the University of.\"	California, Berkeley and its contributors..\" 4. Neither the name of the University nor the names of its contributors.\"    may be used to endorse or promote products derived from this software.\"    without specific prior written permission..\".\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION).\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF.\" SUCH DAMAGE..\".\"     @(#)pstat.8	8.4 (Berkeley) 4/19/94.\".Dd April 19, 1994.Dt PSTAT 8.Os BSD 4.Sh NAME.Nm pstat.Nd display system data structures.Sh SYNOPSIS.Nm pstat.Op Fl Tfnstv.Op Fl M Ar core.Op Fl N Ar system.Sh DESCRIPTION.Nm Pstatdisplays open file entry, swap space utilization,terminal state, and vnode data structures.If.Ar corefileis given, the information is sought there, otherwisein.Pa /dev/kmem .The required namelist is taken from.Pa /vmunixunless .Ar systemis specified.The.Fl noption specifies that devices should be printed out by major/minornumber rather than by name..PpOptions are.Bl -tag -width indent.It Fl TPrints the number of used and free slots in the several system tablesand is useful for checking to see how large system tables have becomeif the system is under heavy load..It Fl fPrint the open file table with these headings:.Bl -tag -width indent.It LOCThe core location of this table entry..It TYPEThe type of object the file table entry points to..It FLGMiscellaneous state variables encoded thus:.Bl -tag -width indent.It Ropen for reading.It Wopen for writing.It Aopen for appending.It Sshared lock present.It Xexclusive lock present.It Isignal pgrp when data ready.El.It CNTNumber of processes that know this open file..It MSGNumber of messages outstanding for this file..It DATAThe location of the vnode table entry or socket structure for this file..It OFFSETThe file offset (see.Xr lseek 2 ) ..El.It Fl sPrint information about swap space usage on all the swap areas compiled into the kernel.The first column is the device name of the partition.  The next column isthe total space available in the partition.  The .Ar Usedcolumn indicates the total blocks used so far;  the .Ar Availablecolumn indicates how much space is remaining on each partition.The.Ar Capacityreports the percentage of space used..PpIf more than one partition is configured into the system, totals for allof the statistics will be reported in the final line of the report..It Fl tPrint table for terminalswith these headings:.Bl -tag -width indent.It RAWNumber of characters in raw input queue..It CANNumber of characters in canonicalized input queue..It OUTNumber of characters in putput queue..It MODESee.Xr tty 4 ..It ADDRPhysical device address..It DELNumber of delimiters (newlines) in canonicalized input queue..It COLCalculated column position of terminal..It STATEMiscellaneous state variables encoded thus:.Bl -tag -width indent.It Tdelay timeout in progress.It Wwaiting for open to complete.It Oopen.It Foutq has been flushed during DMA.It Ccarrier is on.It Bbusy doing output.It Aprocess is awaiting output.It Xopen for exclusive use.It Soutput stopped.It Hhangup on close.El.It PGRPProcess group for which this is controlling terminal..It DISCLine discipline; blank is old ttyOTTYDISCor.Ql new ttyforNTTYDISCor.Ql netforNETLDISC(see.Xr bk 4 ) ..El.It Fl vPrint the active vnodes.  Each group of vnodes correspondingto a particular filesystem is preceded by a two line header.  Thefirst line consists of the following:.Pp.Df I.No *** MOUNT Em fstype from on.Em on fsflags.De.Ppwhere.Em fstypeis one of.Em ufs , nfs , mfs , or pc ;.Em fromis the filesystem is mounted from;.Em onis the directorythe filesystem is mounted on; and.Em fsflagsis a listof optional flags applied to the mount (see.Xr mount 8 ) ..The second line is a header for the individual fields ,the first part of which are fixed, and the second part are filesystemtype specific.  The headers common to all vnodes are:.Bl -tag -width indent.It ADDRLocation of this vnode..It TYPFile type..It VFLAG.PpA list of letters representing vnode flags:.Bl -tag -width indent.It R\- VROOT.It T\- VTEXT.It L\- VXLOCK.It W\- VXWANT.It E\- VEXLOCK.It S\- VSHLOCK.It T\- VLWAIT.It A\- VALIASED.It B\- VBWAIT.El.Pp.It USEThe number of references to this vnode..It HOLDThe number of I/O buffers held by this vnode..It FILEIDThe vnode fileid.In the case of.Em ufsthis is the inode number..It IFLAGMiscellaneous filesystem specific state variables encoded thus:.Bl -tag -width indent.It "For ufs:".Pp.Bl -tag -width indent.It Llocked.It Uupdate time.Pq Xr fs 5must be corrected.It Aaccess time must be corrected.It Wwanted by another process (L flag is on).It Cchanged time must be corrected.It Sshared lock applied.It Eexclusive lock applied.It Zsomeone waiting for a lock.It Mcontains modifications.It Rhas a rename in progress.El.It "For nfs:".Bl -tag -width indent.It Wwaiting for I/O buffer flush to complete.It PI/O buffers being flushed.It Mlocally modified data exists.It Ean earlier write failed.It Xnon-cacheable lease (nqnfs).It Owrite lease (nqnfs).It Glease was evicted (nqnfs).El.El.It SIZ/RDEVNumber of bytes in an ordinary file, ormajor and minor device of special file..El.El.Sh FILES.Bl -tag -width /dev/kmemxxx -compact.It Pa /vmunixnamelist.It Pa /dev/kmemdefault source of tables.El.Sh SEE ALSO.Xr iostat 1 ,.Xr ps 1 ,.Xr systat 1 ,.Xr vmstat 1 ,.Xr stat 2 ,.Xr fs 5 ,.Rs.Rt Tn UNIX Rt Implementation ,.Ra K. Thompson.Re.Sh BUGSSwap statistics are reported for all swap partitions compiled into the kernel,regardless of whether those partitions are being used..PpDoes not understand NFS swap servers..Sh HISTORYThe.Nm pstatcommand appeared in 4.0BSD.