Section 1: plog
This page was been converted automatically, from Debian GNU/Linux
man pages.
PON(1) Debian PPPD PON(1)
NAME
pon, poff, plog - starts up, shuts down or lists the log
of PPP connections
SYNOPSIS
pon [ isp-name ]
poff [ -r ] [ -d ] [ -c ] [ -a ] [ -h ] isp-name
plog [ argument ]
DESCRIPTION
This manual page describes the pon, poff and plog scripts,
which allow users to control PPP connections.
pon starts a PPP connection to a provider, reading its
configuration from /etc/ppp/peers/provider and using the
chatscript /etc/chatscripts/provider. This is the default
setting if isp-name is not given.
To start a PPP connection to a different provider, specify
an isp-name operand. For instance, to use provider con-
figuration "provider2" run
pon provider2
The system will then use the chatscript
/etc/chatscripts/provider2 and the options file
/etc/ppp/peers/provider2. You can use pon to run multi-
ple, simultaneous PPP connections.
poff closes a PPP connection. If more than one PPP connec-
tion exists, the one named in the argument to poff will be
killed, e.g.
poff myprovider2
will terminate the connection to myprovider2, and leave
the PPP connection to "myprovider1" up and running.
plog shows you the last few lines of /var/log/ppp.log. If
that file doesn't exist, it shows you the last few lines
of /var/log/syslog file, but excluding the lines not gen-
erated by pppd. This script makes use of the tail(1) com-
mand, so arguments that can be passed to tail(1) can also
be passed to plog.
OPTIONS
Options for pon
isp-name
is the name of the ISP connection to start. If no
isp-name is specified, pon will use the name
"provider".
Options for poff
-r causes the connection to be redialed after it is
Debian Project February 2000 1
PON(1) Debian PPPD PON(1)
dropped.
-d toggles the state of pppd's debug option.
-c causes pppd(8) to renegotiate compression.
-a stops all running ppp connections. If the argument
isp-name is given it will be ignored.
-h displays help information.
-v prints the version and exits.
If no argument is given it will kill all ppp connections.
Like the -a option.
Options for plog
argument
is any argument you can also pass to tail(1).
REQUIREMENTS
pppd(8) must be installed and configured.
/etc/chatscripts/provider is the default chatscript, used
when pon is invoked without an argument. Edit it to suit
your needs. See chat(8).
/etc/ppp/peers/provider is the default options file, used
when pon is invoked without an argument. Edit it to suit
your needs. See pppd(8).
When pon is invoked with an isp-name argument, different
filenames are used. For example, if isp-name "myprovider"
is specified, chatscript /etc/chatscripts/myprovider and
options file /etc/ppp/peers/myprovider are used.
NOTE
The plog script can only be used by root or another system
administrator in group "adm" due to security reasons.
Also, to have all pppd-generated information in one log-
file, that plog can show, you need the following line in
your /etc/syslog.conf file:
local2.* -/var/log/ppp.log
FILES
/etc/chatscripts/provider
The default chat script.
/etc/ppp/peers/provider
The default peer option file.
/etc/ppp/chap-secrets
System CHAP passwords file.
Debian Project February 2000 2
PON(1) Debian PPPD PON(1)
/etc/ppp/pap-secrets
System PAP passwords file.
/etc/ppp/options
System PPP option file.
/var/log/ppp.log
The default PPP log file.
AUTHORS
The p-commands were written by Christoph Lameter . Updated and revised by Philip Hands
.
This manual was written by Othmar Pasteka
and modified by Rob Levin , with
some extensions taken from the old p-commands manual writ-
ten by John Hasler .
SEE ALSO
chat(8), pppd(8), tail(1).
Debian Project February 2000 3