.TH "pstatus" "1" "" "" ""
.SH "NAME"
pstatus \- Display status of POPular proxy and server
.SH "SYNOPSIS"
.B "pstatus"
[\-a, --active]
[\--help]
[\-f \fBFILE\fR,
--file \fBFILE\fR]
[\-l \fBTIME\fR,
--loop \fBTIME\fR]
[\-p \fBPRG\fR,
--program \fBPRG\fR]
[\-r \fBRANGE\fR,
--range \fBRANGE\fR]
[\--version]
.SH "DESCRIPTION"
.PP
This command dumps the status information of a running
\fBpproxy\fR or \fBpserv\fR, respectively\&.
The data is dumped on STDOUT in a human readable form\&. In both cases
the list of sessions with current data and statistical data is dumped\&.
.SH "OPTIONS"
.TP
-a, --active
Print only active session slots\&.
.TP
-f \fBFILE\fR, --file \fBFILE\fR
Filename to read the data from\&. Normally this is
\fB/var/run/popular/pproxy\&.state\fR or
\fB/var/run/popular/pserv\&.state\fR\&. If no file
name is given and the --program option is
not used, both these names are tried and the first one found
is used\&. This option can\&'t be used together with the
--program option\&.
.TP
--help
Print short help screen\&.
.TP
-l \fBTIME\fR, --loop \fBTIME\fR
Print data in a loop every TIME seconds\&. Default is no looping\&.
If no TIME is given, one second is used\&.
.TP
-p \fBPRG\fR, --program \fBPRG\fR
Program to read data from\&. Can be \fBpproxy\fR or
\fBpserv\fR\&. The corresponding
\fB\&.state\fR in
\fB/var/run/popular\fR is read\&. This option
can\&'t be used together with the --file option\&.
.TP
-r \fBRANGE\fR, --range \fBRANGE\fR
Print only the range of slots\&. RANGE can be one of \&'n-m\&', \&'n-\&',
or \&'-m\&'\&.
.TP
--version
Print version information\&.
.SH "SEE ALSO"
.PP
pcheck(1), pcheckd(8), pclean(8), pcontrol(1), pdeliver(1), pproxy(8), pserv(8), ptestpdm(1), The POPular Manual
.SH "AUTHOR"
.PP
Jochen Topf jochen@remote\&.org
.PP
\fB
http://www\&.remote\&.org/jochen/mail/popular/
\fR
<URL:http://www\&.remote\&.org/jochen/mail/popular/>
.SH "COPYRIGHT"
.PP
The POPular suite is copyright (C) 1999-2002 by Jochen Topf
jochen@remote\&.org\&.
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version\&.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&. See the
GNU General Public License for more details\&.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc\&., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA