Debian Codegraph @

upstream/debian-unstable/man1/pon.1

raw
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).