Penguin
Recent Changes
Annotated edit history of pon(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 PON
2 !!!PON
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 FILES
7 AUTHORS
8 SEE ALSO
9 ----
10 !!NAME
11
12
13 pon, poff, plog - starts up, shuts down or lists the log of PPP connections
14 !!SYNOPSIS
15
16
17 __pon__ [[ isp-name [[ options ] ]__
18 poff__ [[ -r ] [[ -d ] [[ -c ] [[ -a ] [[ -h ] [[ isp-name
19 ]__
20 plog__ [[ arguments ]
21 !!DESCRIPTION
22
23
24 This manual page describes the __pon__, __plog__ and
25 __poff__ scripts, which allow users to control PPP
26 connections.
27
28
29 __pon__
30
31
32 __pon__, invoked without arguments, runs the
33 ''/etc/ppp/ppp_on_boot'' file, if it exists and is
34 executable. Otherwise, a PPP connection will be started
35 using configuration from ''/etc/ppp/peers/provider''.
36 This is the default behaviour unless an __isp-name__
37 argument is given.
38
39
40 For instance, to use ISP configuration
41
42
43 pon myisp
44
45
46 __pon__ will then use the options file
47 ''/etc/ppp/peers/myisp''. You can pass additional
48 __options__ after the ISP name, too. __pon__ can be
49 used to run multiple, simultaneous PPP
50 connections.
51
52
53 __poff__
54
55
56 __poff__ closes a PPP connection. If more than one PPP
57 connection exists, the one named in the argument to
58 __poff__ will be killed, e.g.
59
60
61 poff myprovider2
62
63
64 will terminate the connection to myprovider2, and leave the
65 PPP connections to e.g.
66
67
68 __poff__ takes the following command line
69 options:
70
71
72 __-r__
73
74
75 causes the connection to be redialed after it is
76 dropped.
77
78
79 __-d__
80
81
82 toggles the state of pppd's debug option.
83
84
85 __-c__
86
87
88 causes pppd(8) to renegotiate
89 compression.
90
91
92 __-a__
93
94
95 stops all running ppp connections. If the argument
96 __isp-name__ is given it will be ignored.
97
98
99 __-h__
100
101
102 displays help information.
103
104
105 __-v__
106
107
108 prints the version and exits.
109
110
111 If no argument is given, __poff__ will stop or signal
112 pppd if and only if there is exactly one running. If more
113 than one connection is active, it will exit with an error
114 code of 1.
115
116
117 __plog__
118
119
120 __plog__ shows you the last few lines of
121 ''/var/log/ppp.log''. If that file doesn't exist, it
122 shows you the last few lines of your ''/var/log/syslog''
123 file, but excluding the lines not generated by pppd. This
124 script makes use of the tail(1) command, so arguments
125 that can be passed to tail(1) can also be passed to
126 __plog__.
127
128
129 Note: the __plog__ script can only be used by root or
130 another system administrator in group
131 __/etc/syslog.conf''
132 file:
133
134
135 local2.* -/var/log/ppp.log
136 !!FILES
137
138
139 ''/etc/ppp/options''
140
141
142 PPPd system options file.
143
144
145 ''/etc/ppp/pap-secrets''
146
147
148 System PAP passwords file.
149
150
151 ''/etc/ppp/chap-secrets''
152
153
154 System CHAP passwords file.
155
156
157 ''/etc/ppp/peers/''
158
159
160 Directory holding the peer options files. The default file
161 is called ''provider''.
162
163
164 ''/etc/chatscripts/provider''
165
166
167 The chat script invoked from the default
168 ''/etc/ppp/peers/provider''.
169
170
171 ''/var/log/ppp.log''
172
173
174 The default PPP log file.
175 !!AUTHORS
176
177
178 The p-commands were written by Christoph Lameter
179 This manual was written by Othmar Pasteka
180 !!SEE ALSO
181
182
183 pppd(8), chat(8), tail(1).
184 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.