NAME¶
pon, poff, plog - starts up, shuts down or lists the log of PPP connections
SYNOPSIS¶
pon [ isp-name [ options ] ]
poff [ -r ] [ -d ] [ -c ] [ -a ] [ -h ] [ isp-name ]
plog [ arguments ]
DESCRIPTION¶
This manual page describes the
pon,
plog and
poff scripts,
which allow users to control PPP connections.
pon¶
pon, invoked without arguments, runs the
/etc/ppp/ppp_on_boot
file, if it exists and is executable. Otherwise, a PPP connection will be
started using configuration from
/etc/ppp/peers/provider. This is the
default behaviour unless an
isp-name argument is given.
For instance, to use ISP configuration "myisp" run:
- pon myisp
pon will then use the options file
/etc/ppp/peers/myisp. You can
pass additional
pppd options after the ISP name, too.
pon can be
used to run multiple, simultaneous PPP connections.
pon takes the following command line options:
- -q --quick
- disconnect when ip-up finishes running. This function is only available to
the root user.
poff¶
poff closes a PPP connection. If more than one PPP connection 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 connections to
e.g. "myprovider1" or "myprovider3" up and running.
poff takes the following command line options:
- -r
- causes the connection to be redialed after it is 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,
poff will stop or signal pppd if and only if
there is exactly one running. If more than one connection is active, it will
exit with an error code of 1.
plog¶
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 your
/var/log/syslog file, but excluding the lines not generated by pppd.
This script makes use of the
tail(1) command, so arguments that can be
passed to
tail(1) can also be passed to
plog.
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 logfile, that plog can show, you need
the following line in your
/etc/syslog.conf file:
local2.* -/var/log/ppp.log
FILES¶
- /etc/ppp/options
- PPPd system options file.
- /etc/ppp/pap-secrets
- System PAP passwords file.
- /etc/ppp/chap-secrets
- System CHAP passwords file.
- /etc/ppp/peers/
- Directory holding the peer options files. The default file is called
provider.
- /etc/chatscripts/provider
- The chat script invoked from the default
/etc/ppp/peers/provider.
- /var/log/ppp.log
- The default PPP log file.
AUTHORS¶
The p-commands were written by Christoph Lameter <clameter@debian.org>.
Updated and revised by Philip Hands <phil@hands.com>.
This manual was written by Othmar Pasteka <othmar@tron.at>. Modified by
Rob Levin <lilo@openprojects.net>, with some extensions taken from the
old p-commands manual written by John Hasler <jhasler@debian.org>.
SEE ALSO¶
pppd(8),
chat(8),
tail(1).