Commit | Line | Data |
---|---|---|
2a905848 RG |
1 | .\" manual page v0.4 [3/3/93] for pppd 1.2beta |
2 | .\" SH section heading | |
3 | .\" SS subsection heading | |
4 | .\" LP paragraph | |
5 | .\" IP indented paragraph | |
6 | .\" TP hanging label | |
7 | .TH PPPD 8 | |
8 | .SH NAME | |
9 | pppd \- Point to Point Protocol daemon | |
10 | .SH SYNOPSIS | |
11 | .B pppd | |
12 | [ | |
13 | .I option | |
14 | ] | |
15 | .B tty_name speed | |
16 | [ | |
17 | .I local_IP_address | |
18 | ]:[ | |
19 | .I remote_IP_address | |
20 | ] | |
21 | .SH DESCRIPTION | |
22 | .LP | |
23 | The Point-to-Point Protocol (PPP) provides a method for transmitting | |
24 | datagrams over serial point-to-point links. | |
25 | .I pppd | |
26 | is composed of three parts: | |
27 | .TP | |
28 | 1. A method for encapsulating datagrams over serial links. | |
29 | .TP | |
30 | 2. An extensible Link Control Protocol (LCP). | |
31 | .TP | |
32 | 3. A family of Network Control Protocols (NCP) for establishing | |
33 | and configuring different network-layer protocols. | |
34 | .LP | |
35 | .I pppd | |
36 | currently supports the encapsulation scheme, the basic LCP, and an | |
37 | NCP for establishing and configuring the Internet Protocol (IP) | |
38 | (called the IP Control Protocol, IPCP). | |
39 | .SH OPTIONS | |
40 | .TP | |
41 | .B -all | |
42 | Don't request/allow any options | |
43 | .TP | |
44 | .B -ac | |
45 | Disable Address/Control compression negotiation | |
46 | .TP | |
47 | .B -am | |
48 | Disable asyncmap negotiation | |
49 | .TP | |
50 | .B -as <n> | |
51 | Set the desired async map to hex <n>. The default async map is 0xffffffff. | |
52 | .TP | |
53 | .B -d | |
54 | Increase debugging level | |
55 | .TP | |
56 | .B -detach | |
57 | Don't fork to become a background process | |
58 | .TP | |
59 | .B -ip | |
60 | Disable IP address negotiation | |
61 | .TP | |
62 | .B -mn | |
63 | Disable magic number negotiation | |
64 | .TP | |
65 | .B -mru | |
66 | Disable MRU [Maximum Receive Unit] negotiation | |
67 | .TP | |
68 | .B -p | |
69 | Set passive mode | |
70 | .TP | |
71 | .B -pc | |
72 | Disable protocol field compression negotiation | |
73 | .TP | |
74 | .B +ua <p> | |
75 | Require UPAP [User/Password Authentication Protocol] authentication. | |
76 | Use the data in file <p> for the user and password to send to the | |
77 | peer. The file contains the remote user name, followed by a newline, | |
78 | followed by the remote password. | |
79 | .TP | |
80 | .B -ua | |
81 | Don't allow UPAP authentication | |
82 | .TP | |
83 | .B +chap | |
84 | Require CHAP [Cryptographic Handshake Authentication Protocol] authentication. | |
85 | Use the data in file /usr/local/etc/ppp/chap, which contains | |
86 | host name/secret pairs separated by newlines, to authenticate the peer. | |
87 | In the data file, a host name of "default" will match any host name | |
88 | not already specified in the file. | |
89 | .TP | |
90 | .B -chap | |
91 | Don't allow CHAP authentication | |
92 | .TP | |
93 | .B asyncmap <map> | |
94 | Set the async character map to <map>. | |
95 | This map describes which control characters to "escape" in the serial data | |
96 | stream. | |
97 | The argument is a 32 bit hex number represented as 8 hex characters, | |
98 | with each bit representing a character to escape. | |
99 | The lowest bit (i.e. 00000001) represents the character 0x00 | |
100 | The highest bit (i.e. 80000000) represents the character 0x1f or ^_. | |
101 | .TP | |
102 | .B connect <p> | |
103 | Use the executable or shell command specified by <p> to set-up the | |
104 | serial line. This script would typically use the "chat" program to | |
105 | dial the modem and start the remote ppp session. | |
106 | .TP | |
107 | .B crtscts | |
108 | Use hardware flow control (i.e. RTS/CTS) to control the flow of data on | |
109 | the serial port. | |
110 | .TP | |
111 | .B debug | |
112 | Increase debugging level | |
113 | .TP | |
114 | .B domain <d> | |
115 | Append the domain name <d> to the local host name for authentication | |
116 | purposes. I.e., if gethostname() returns the name porsche, but the | |
117 | fully qualified domain name is porsche.Quotron.COM, you would use the | |
118 | domain option to set the domain name to Quotron.COM. | |
119 | .TP | |
120 | .B mru <n> | |
121 | Set MRU value to <n> for negotiation. The minimum MRU value is 128. | |
122 | The default MRU value is 1500. | |
123 | .TP | |
124 | .B netmask <n> | |
125 | Set the interface netmask to <n>, a 32 bit netmask in "decimal dot notation" | |
126 | (i.e. 255.255.255.0). | |
127 | .TP | |
128 | .B passive | |
129 | Set passive mode; Don't send LCP configure requests. Sets initial state to | |
130 | "listen". | |
131 | .TP | |
132 | .B vjmode <m> | |
133 | Specifies which version of IPCP Van Jacobson Compression negotiation | |
134 | to use. Specify | |
135 | .I old | |
136 | for <m> to have backward compatibility with early versions of | |
137 | .I pppd | |
138 | which operated "incorrectly" when negotiating Compression-Type due to a | |
139 | typographical error in the RFC. | |
140 | .I pppd | |
141 | (4.1, patch level 4 and later) | |
142 | have this problem corrected but to allow interoperability with older versions | |
143 | you can force this "incorrect" behavior. Specify | |
144 | .I rfc1172 | |
145 | for <m> to use the RFC1172 value for negotiation. To use the | |
146 | new version of negotiation specified in RFC1132 for | |
147 | IPCP (the default), specify | |
148 | .I rfc1132 | |
149 | for <m>. | |
150 | .TP | |
151 | .B -vj | |
152 | This disables the use of Van Jacobson style IP header compression | |
153 | altogether. | |
154 | .TP | |
155 | .B <tty_name> | |
156 | Communicate over the named device | |
157 | .TP | |
158 | .B <speed> | |
159 | Set the baud rate to <speed> | |
160 | .TP | |
161 | .B <local_IP_address>:<remote_IP_address> | |
162 | Set the local and/or remote interface IP addresses. Either one may be omitted. | |
163 | \".SH EXAMPLES | |
164 | \".SH FILES | |
165 | .SH SEE ALSO | |
166 | .TP | |
167 | .B RFC1144 | |
168 | Jacobson, V. | |
169 | .I Compressing TCP/IP headers for low-speed serial links. | |
170 | 1990 February. | |
171 | .TP | |
172 | .B RFC1171 | |
173 | Perkins, D. | |
174 | .I Point\-to\-Point Protocol for the transmission of multi\-protocol | |
175 | .I datagrams over Point\-to\-Point links. | |
176 | 1990 July. | |
177 | .TP | |
178 | .B RFC1172 | |
179 | Perkins, D.; Hobby, R. | |
180 | .I Point\-to\-Point Protocol (PPP) initial configuration options. | |
181 | 1990 July. | |
182 | .TP | |
183 | .B RFC1331 | |
184 | Simpson, W. | |
185 | .I The Point\-to\-Point Protocol (PPP) for the Transmission of Multi-protocol | |
186 | .I Datagrams over Point\-to\-Point Links | |
187 | 1992 May. | |
188 | .TP | |
189 | .B RFC1332 | |
190 | McGregor, G. | |
191 | .I The PPP Internet Protocol Control Protocol (IPCP). | |
192 | 1991 August. | |
193 | .TP | |
194 | .B RFC1333 | |
195 | Simpson, W. | |
196 | .I PPP Link Quality Monitoring | |
197 | 1992 May. | |
198 | .TP | |
199 | .B Internet Draft | |
200 | Lloyd, B.; Simpson, W. | |
201 | .I PPP Authentication Protocols. | |
202 | 1991 November. | |
203 | .TP | |
204 | .B Internet Draft | |
205 | Rivest, R. | |
206 | .I The MD5 Message-Digest Algorithm. | |
207 | 1991 July. | |
208 | .SH DIAGNOSTICS | |
209 | .LP | |
210 | There is, currently, only one level of debugging available. Debugging is | |
211 | enabled by setting the -d or debug flag on the command line. Debugging may | |
212 | also be enabled after | |
213 | .I pppd | |
214 | is running by sending a SIGUSR1 to the | |
215 | .I pppd | |
216 | process. | |
217 | Debugging may be disabled by sending a SIGUSR2 to the | |
218 | .I pppd | |
219 | process. | |
220 | .LP | |
221 | Error and warning messages are sent to the syslog daemon using facility | |
222 | LOG_DAEMON unless | |
223 | .I pppd | |
224 | has been compiled with debugging code. In this case the logging | |
225 | facility used will be LOG_LOCAL2 in order to allow separation of the debug | |
226 | output from the other daemons using the LOG_DAEMON facility. You can | |
227 | override this by defining the macro LOG_PPP to the desired facility | |
228 | and recompiling. In order to see the error and debug messages, you | |
229 | will need to edit your /etc/syslog.conf file to direct the messages to | |
230 | the desired output device or file. | |
231 | .LP | |
232 | Debugging is currently available for | |
233 | .I fsm.c | |
234 | \- the {Link, IP} Control Protocol Finite State Machine module; | |
235 | .I lcp.c | |
236 | \- the PPP Link Control Protocol module; | |
237 | .I ipcp.c | |
238 | \- the PPP IP Control Protocol module; | |
239 | .I upap.c | |
240 | \- the User/Password Authentication Protocol module; | |
241 | and | |
242 | .I chap.c | |
243 | \- the Challenge Handshake Authentication Protocol module. | |
244 | .SH NOTES | |
245 | The following signals have the specified effect when sent to the | |
246 | .I pppd | |
247 | process. | |
248 | .TP | |
249 | .B SIGINT | |
250 | This signal is normally generated by a Ctrl-C or DEL. | |
251 | Causes | |
252 | .I pppd | |
253 | to initiate a graceful disconnect and exit. | |
254 | .I pppd | |
255 | will adjust the timeouts and close the connection. | |
256 | .TP | |
257 | .B SIGTERM | |
258 | Causes | |
259 | .I pppd | |
260 | to initiate a graceful disconnect and exit. | |
261 | .I pppd | |
262 | will adjust the timeouts and close the connection. | |
263 | .TP | |
264 | .B SIGHUP | |
265 | Indicates that the physical layer has been disconnected. You will | |
266 | probably see "Bad file number" errors in the log output due to the way | |
267 | the STREAMS-based tty driver handles a hangup. You can ignore | |
268 | these errors in this case. | |
269 | .I pppd | |
270 | will adjust the timeouts and reset the connection. | |
271 | .SH BUGS | |
272 | Note that sections the current implementation of | |
273 | .I pppd | |
274 | are based on older RFCs and draft RFCs and may not be fully | |
275 | compatible with the latest draft RFC versions. | |
276 | .SH AUTHORS | |
277 | Drew Perkins, | |
278 | Brad Clements, | |
279 | Karl Fox, | |
280 | Greg Christy, | |
281 | Brad Parker (brad@fcr.com) |