| 1 |
.\" This manual is published under the GPL. |
| 2 |
.\" All guidelines specified in the GPL apply here. |
| 3 |
.\" To get an ascii file: |
| 4 |
.\" groff -man -Tascii pon.1 > pon.txt |
| 5 |
.\" |
| 6 |
.TH PON 1 "July 2000" "Debian Project" "Debian PPPD" |
| 7 |
.SH NAME |
| 8 |
pon, poff, plog \- starts up, shuts down or lists the log of PPP connections |
| 9 |
.SH SYNOPSIS |
| 10 |
.B pon |
| 11 |
[ isp\-name [ options ] ] |
| 12 |
.br |
| 13 |
.B poff |
| 14 |
[ \-r ] [ \-d ] [ \-c ] [ \-a ] [ \-h ] [ isp\-name ] |
| 15 |
.br |
| 16 |
.B plog |
| 17 |
[ arguments ] |
| 18 |
.SH DESCRIPTION |
| 19 |
This manual page describes the \fBpon\fP, \fBplog\fP and \fBpoff\fP |
| 20 |
scripts, which allow users to control PPP connections. |
| 21 |
.PP |
| 22 |
.SS pon |
| 23 |
\fBpon\fP, invoked without arguments, runs the \fI/etc/ppp/ppp_on_boot\fP |
| 24 |
file, if it exists and is executable. Otherwise, a PPP connection will be |
| 25 |
started using configuration from \fI/etc/ppp/peers/provider\fP. |
| 26 |
This is the default behaviour unless an \fBisp\-name\fP argument is given. |
| 27 |
.PP |
| 28 |
For instance, to use ISP configuration "myisp" run: |
| 29 |
.IP |
| 30 |
pon myisp |
| 31 |
.PP |
| 32 |
\fBpon\fP will then use the options file \fI/etc/ppp/peers/myisp\fP. |
| 33 |
You can pass additional \fBpppd options\fP after the ISP name, too. |
| 34 |
\fBpon\fP can be used to run multiple, simultaneous PPP connections. |
| 35 |
.PP |
| 36 |
\fBpon\fP takes the following command line options: |
| 37 |
.RS |
| 38 |
.TP |
| 39 |
.B "\-q" "\-\-quick" |
| 40 |
disconnect when ip\-up finishes running. |
| 41 |
This function is only available to the \fIroot\fP user. |
| 42 |
.SS poff |
| 43 |
\fBpoff\fP closes a PPP connection. If more than one PPP connection exists, |
| 44 |
the one named in the argument to \fBpoff\fP will be killed, e.g. |
| 45 |
.IP |
| 46 |
poff myprovider2 |
| 47 |
.PP |
| 48 |
will terminate the connection to myprovider2, and leave the PPP connections |
| 49 |
to e.g. "myprovider1" or "myprovider3" up and running. |
| 50 |
.PP |
| 51 |
\fBpoff\fP takes the following command line options: |
| 52 |
.RS |
| 53 |
.TP |
| 54 |
.B "\-r" |
| 55 |
causes the connection to be redialed after it is dropped. |
| 56 |
.TP |
| 57 |
.B "\-d" |
| 58 |
toggles the state of pppd's debug option. |
| 59 |
.TP |
| 60 |
.B "\-c" |
| 61 |
causes |
| 62 |
.BR pppd (8) |
| 63 |
to renegotiate compression. |
| 64 |
.TP |
| 65 |
.B "\-a" |
| 66 |
stops all running ppp connections. If the argument \fBisp\-name\fP |
| 67 |
is given it will be ignored. |
| 68 |
.TP |
| 69 |
.B "\-h" |
| 70 |
displays help information. |
| 71 |
.TP |
| 72 |
.B "\-v" |
| 73 |
prints the version and exits. |
| 74 |
.PP |
| 75 |
If no argument is given, \fBpoff\fP will stop or signal pppd if and only |
| 76 |
if there is exactly one running. If more than one connection is active, |
| 77 |
it will exit with an error code of 1. |
| 78 |
.PP |
| 79 |
.SS plog |
| 80 |
\fBplog\fP shows you the last few lines of \fI/var/log/ppp.log\fP. If that |
| 81 |
file doesn't exist, it shows you the last few lines of your |
| 82 |
\fI/var/log/syslog\fP file, but excluding the lines not generated by pppd. |
| 83 |
This script makes use of the |
| 84 |
.BR tail (1) |
| 85 |
command, so arguments that can be passed to |
| 86 |
.BR tail (1) |
| 87 |
can also be passed to \fBplog\fP. |
| 88 |
.PP |
| 89 |
Note: the \fBplog\fP script can only be used by root or another system |
| 90 |
administrator in group "adm", due to security reasons. Also, to have all |
| 91 |
pppd-generated information in one logfile, that plog can show, you need the |
| 92 |
following line in your \fI/etc/syslog.conf\fP file: |
| 93 |
.PP |
| 94 |
local2.* \-/var/log/ppp.log |
| 95 |
.RE |
| 96 |
.SH FILES |
| 97 |
.TP |
| 98 |
.I /etc/ppp/options |
| 99 |
PPPd system options file. |
| 100 |
.TP |
| 101 |
.I /etc/ppp/pap\-secrets |
| 102 |
System PAP passwords file. |
| 103 |
.TP |
| 104 |
.I /etc/ppp/chap\-secrets |
| 105 |
System CHAP passwords file. |
| 106 |
.TP |
| 107 |
.I /etc/ppp/peers/ |
| 108 |
Directory holding the peer options files. The default file is called |
| 109 |
\fIprovider\fP. |
| 110 |
.TP |
| 111 |
.I /etc/chatscripts/provider |
| 112 |
The chat script invoked from the default \fI/etc/ppp/peers/provider\fP. |
| 113 |
.TP |
| 114 |
.I /var/log/ppp.log |
| 115 |
The default PPP log file. |
| 116 |
.SH AUTHORS |
| 117 |
The p-commands were written by Christoph Lameter <[email protected]>. |
| 118 |
Updated and revised by Philip Hands <[email protected]>. |
| 119 |
.br |
| 120 |
This manual was written by Othmar Pasteka <[email protected]>. Modified |
| 121 |
by Rob Levin <[email protected]>, with some extensions taken from |
| 122 |
the old p-commands manual written by John Hasler <[email protected]>. |
| 123 |
.SH "SEE ALSO" |
| 124 |
.BR pppd (8), |
| 125 |
.BR chat (8), |
| 126 |
.BR tail (1). |