.\" $Header: /home/ahuxley/dev/arc/ppplc/man/RCS/ppplcc.1.shpp,v 1.9 1999/02/20 18:13:29 alexis Exp $
.\"
.TH PPPLCC 1 "15 January 1999"
.SH NAME
ppplcc \- PPP Link Control Client
.br
.\"
.\" we don't need a .br/.ne 5 here since there
.\" isn't any chance really, that we're already
.\" anywhere near the end of the first page.
.\"
.SH SYNOPSIS
.B ppplcc
[
.B \-v
|
.B \-d
.I level
] [
.B \-p
.I period
] [ 
.B \-c 
.I conffile
] [ 
.B \-n
] [
.B \-q
.I period
] 
.I msgid \fR\.\.\.
.br
.B "ppplcc -V"
.br
.\"
.\" we don't need a .br/.ne 5 here since there
.\" isn't any chance really, that we're already
.\" anywhere near the end of the first page.
.\"
.SH DESCRIPTION
This man page documents 
.I ppplcc
version MARKER_PATCHLEVEL.
.PP
.I Ppplcc
is a lightweight program to control
.I ppplcd\fR(8)
via
.I sndmsg\fR(1). 
If commands are specified on the command line, they they are executed.
Otherwise 
.I ppplcc
enters interactive mode; displaying a menu to the user.
.PD
.br
.ne 5
.SH OPTIONS
.\"  This indents everything after the next line by 25 somethings.
.TP 25
.B \-V
Print the version number and exit.
.TP
.B \-v
Sets the verbosity level to 3.
.TP
.B \-d \fIlevel
Sets the verbosity level to 
.I level\fR.
.TP
.B \-n
Commands are simulated, but not actually executed. 
.TP
.B \-p \fIperiod
.I Ppplcc 
pauses the specified number of seconds after executing a command and
before redrawing the menu; command output follow executing so quickly
that it is impossible to read without a pause.
.TP
.B \-c \fIconffile
.I Ppplcc
uses the specified configuration command when restarting
.I ppplcd\fR(8)
with the
.B S
command.
.TP
.B \-n
Commands are simulated instead of actually being executed.
.TP
.B \-q \fIperiod
Commands are queued for processing by
.I ppplcd\fR(8)
after the specified number of seconds, instead of being processed immediately.
.PD
.br
.ne 5
.SH EXAMPLES
The following command connects immediately with news transfer and quality
checking disabled:
.IP
ppplcc c sq 0 0 dn
.br
.ne 5
.SH FILES
.PD 0
.TP 25
.B MARKER_PRGCFGDIR/ppplcd.conf
default location for configuration file for
.I ppplcd\fR(8).
.PD
.br
.ne 5
.SH ENVIRONENT VARIABLES
None.
.br 
.ne 5
.SH DIAGNOSTICS
No diagnostic messages are so cryptic that they need to be explained here.
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH SEE ALSO
sndmsg(1), ppplcd(8)
.br
.ne 5
.SH AUTHOR
Alexis Huxley
.br
.ne 5
.SH BUGS
No known bugs.
.PP
Bug reports and queries should be reported to
.B ppplc-support@danae.demon.co.uk\fR.
.PP
For the latest release of
.I ppplc\fR,
visit
.B http://www.danae.demon.co.uk/software/ppplc/\fR.
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1996-1998 Alexis Huxley
.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., 675 Mass Ave, Cambridge, MA 02139, USA.