ppp.8 (6059) | ppp.8 (6735) |
---|---|
1.\" manual page [] for ppp 0.93 2.\" $Id:$ | 1.\" manual page [] for ppp 0.94 beta2 + alpha 2.\" $Id: ppp.8,v 1.1.1.1 1995/01/31 06:29:58 amurai Exp $ |
3.\" SH section heading 4.\" SS subsection heading 5.\" LP paragraph 6.\" IP indented paragraph 7.\" TP hanging label 8.TH PPP 8 9.SH NAME 10ppp \- Point to Point Protocol (aka iijppp) 11.SH SYNOPSIS 12.B ppp 13[ 14.I -auto | -direct -dedicated 15] [ 16.I system 17] 18.SH DESCRIPTION 19.LP | 3.\" SH section heading 4.\" SS subsection heading 5.\" LP paragraph 6.\" IP indented paragraph 7.\" TP hanging label 8.TH PPP 8 9.SH NAME 10ppp \- Point to Point Protocol (aka iijppp) 11.SH SYNOPSIS 12.B ppp 13[ 14.I -auto | -direct -dedicated 15] [ 16.I system 17] 18.SH DESCRIPTION 19.LP |
20 This is user process \fIPPP\fR software package. Normally, \fIPPP\fR is implemented as a part of kernel and hard to debug and/or modify its behavior. However, in this implementation, \fIPPP\fR is implemented as a user process with the help of tunnel device driver. | 20This is user process \fIPPP\fR software package. Normally, \fIPPP\fR 21is implemented as a part of kernel and hard to debug and/or modify its 22behavior. However, in this implementation, \fIPPP\fR is implemented as 23a user process with the help of tunnel device driver. |
21.LP 22 23.SH Major Features 24 25.TP 2 | 24.LP 25 26.SH Major Features 27 28.TP 2 |
26o 27Provide interactive user interface. Using its command mode, user can easily enter commands to establish the connection with the peer, check the status of connection, and close the connection. 28 | 29o Provide interactive user interface. Using its command mode, user can 30easily enter commands to establish the connection with the peer, check 31the status of connection, and close the connection. And now, all 32functions has password protected if describe your hostname/password in 33secret file or exist secret file itself. 34 |
29.TP 2 | 35.TP 2 |
30o 31Supports both of manual and automatic dialing. Interactive mode has ``term'' command which enables you to talk to your modem directory. When your modem is connected to the peer, and it starts to speak \fIPPP\fR, \fIPPP\fR software detects it and turns into packet mode automatically. Once you have convinced how to connect with the peer, you can write chat script to define necessary dialing and login procedure for later convenience. | 36o Supports both of manual and automatic dialing. Interactive mode has 37``term'' command which enables you to talk to your modem 38directory. When your modem is connected to the peer, and it starts to 39speak \fIPPP\fR, \fIPPP\fR software detects it and turns into packet 40mode automatically. Once you have convinced how to connect with the 41peer, you can write chat script to define necessary dialing and login 42procedure for later convenience. 43 |
32.TP 2 | 44.TP 2 |
33o 34Supports on-demand dialup capability. By using auto mode, \fIPPP\fR program will act as a daemon and wait for the packet send to the peer. Once packet is found, daemon automatically dials and establish the connection. | 45o Supports on-demand dialup capability. By using auto mode, \fIPPP\fR 46program will act as a daemon and wait for the packet send to the peer. 47Once packet is found, daemon automatically dials and establish the 48connection. |
35 36.TP 2 37o | 49 50.TP 2 51o |
38Can act as server which accept incoming \fIPPP\fR connection. 39 | 52Can act as server which accept incoming \fIPPP\fR connection. 53 |
40.TP 2 41o 42Supports PAP and CHAP authentification. 43 44.TP 2 | 54.TP 2 55o 56Supports PAP and CHAP authentification. 57 58.TP 2 |
45o 46Supports packet filtering. User can define three kinds of filters; ifilter for incoming packet, ofilter for outgoing packet and dfilter to define dialing trigger packet. | 59o 60Supports Proxy Arp. |
47 48.TP 2 | 61 62.TP 2 |
49o 50Tunnel driver supports bpf. That is, user can use tcpdump to check packet flow over the \fIPPP\fR link. | 63o Supports packet filtering. User can define four kinds of filters; 64ifilter for incoming packet, ofilter for outgoing packet, dfilter to 65define dialing trigger packet and afilter to keep alive a connection 66by trigger packet. |
51 52.TP 2 | 67 68.TP 2 |
69o Tunnel driver supports bpf. That is, user can use tcpdump to check 70packet flow over the \fIPPP\fR link. 71 72.TP 2 |
|
53o 54Supports \fIPPP\fR over TCP capability. 55 56.TP 2 57o 58Supports IETF draft Predictor-1 compression. 59 60.TP 2 | 73o 74Supports \fIPPP\fR over TCP capability. 75 76.TP 2 77o 78Supports IETF draft Predictor-1 compression. 79 80.TP 2 |
61o 62Runs under BSDI-1.1 and FreeBSD-1.1. Patch for NeXTSTEP 3.2 is also available on the net. | 81o Runs under BSDI-1.1 and FreeBSD-1.1. Patch for NeXTSTEP 3.2 is also 82available on the net. |
63 64.SH MANUAL DIALING | 83 84.SH MANUAL DIALING |
65.LP | |
66 67 % ppp 68 User Process PPP written by Toshiharu OHNO. | 85 86 % ppp 87 User Process PPP written by Toshiharu OHNO. |
88 -- If you write your hostname and password in ppp.secret, 89 you can't do anything even quit command -- 90 ppp on tama> quit 91 what ? 92 ppp on tama> pass <password> |
|
69 -- You can specify modem and device name using following commands. | 93 -- You can specify modem and device name using following commands. |
70 ppp> set line /dev/cua01 71 ppp> set speed 38400 72 ppp> set parity even 73 ppp> show modem | 94 ppp ON tama> set line /dev/cua01 95 ppp ON tama> set speed 38400 96 ppp ON tama> set parity even 97 ppp ON tama> show modem |
74 -- Modem related parameters are shown in here | 98 -- Modem related parameters are shown in here |
75 ppp> | 99 ppp ON tama> |
76 -- Use term command to talk with your modem | 100 -- Use term command to talk with your modem |
77 ppp> term | 101 ppp ON tama> term |
78 at 79 OK 80 atdt123456 81 CONNECT 82 83 login: ppp 84 Password: 85 -- PPP started in remote side --- 86 87 -- When peer start to speak PPP, the program will detect it 88 -- automatically and back to command mode. | 102 at 103 OK 104 atdt123456 105 CONNECT 106 107 login: ppp 108 Password: 109 -- PPP started in remote side --- 110 111 -- When peer start to speak PPP, the program will detect it 112 -- automatically and back to command mode. |
89 ppp> | 113 ppp on tama> |
90 \fBPPP\fR> 91 92 -- NOW, you are get connected !! Note that prompt has changed to 93 -- capital letters | 114 \fBPPP\fR> 115 116 -- NOW, you are get connected !! Note that prompt has changed to 117 -- capital letters |
94 PPP> show lcp | 118 PPP ON tama> show lcp |
95 96 -- You'll see LCP status -- 97 | 119 120 -- You'll see LCP status -- 121 |
98 PPP> show ipcp | 122 PPP ON tama> show ipcp |
99 100 -- You'll see IPCP status -- 101 -- At this point, your machine has host route to the peer. 102 -- If your want to add default route entry, then enter 103 | 123 124 -- You'll see IPCP status -- 125 -- At this point, your machine has host route to the peer. 126 -- If your want to add default route entry, then enter 127 |
104 PPP> add 0 0 HISADDR | 128 PPP ON tama> add 0 0 HISADDR |
105 106 -- Here string `HISADDR' represents IP address of connected peer. 107 | 129 130 -- Here string `HISADDR' represents IP address of connected peer. 131 |
108 PPP> | 132 PPP ON tama> |
109 -- Use applications (i.e. ping, telnet, ftp) in other windows 110 | 133 -- Use applications (i.e. ping, telnet, ftp) in other windows 134 |
111 PPP> show log | 135 PPP ON tama> show log |
112 113 -- Gives you some logging messages 114 | 136 137 -- Gives you some logging messages 138 |
115 PPP> close | 139 PPP ON tama> close |
116 117 -- Connection is closed, and modem will be hanged. 118 | 140 141 -- Connection is closed, and modem will be hanged. 142 |
119 ppp> quit | 143 ppp ON tama> quit |
120 % 121.LP | 144 % 145.LP |
146 |
|
122.SH AUTOMATIC DIALING 123 124.LP | 147.SH AUTOMATIC DIALING 148 149.LP |
125To use automatic dialing, you must prepare Dial and Login chat script.See example definition found in ppp.conf.sample(Format of ppp.conf is pretty simple.) 126.LP | 150To use automatic dialing, you must prepare Dial and Login chat script. 151See example definition found in ppp.conf.sample (Format of ppp.conf is 152pretty simple.) |
127 128.TP 2 129o 130Each line contains one command, label or comment. 131 132.TP 2 133o 134Line stating with # is treated as a comment line. 135 136.TP 2 137o 138Label name has to start from first column and should be followed by colon (:). 139 140.TP 2 141o 142Command line must contains space or tab at first column. 143 144.LP | 153 154.TP 2 155o 156Each line contains one command, label or comment. 157 158.TP 2 159o 160Line stating with # is treated as a comment line. 161 162.TP 2 163o 164Label name has to start from first column and should be followed by colon (:). 165 166.TP 2 167o 168Command line must contains space or tab at first column. 169 170.LP |
145If ppp.conf is ready, specify destination label name when you invoke ppp. Commands associated with destination label is executed when ppp command is invoked. Note that commands associated with ``default'' label is ALWAYS executed. | 171If ppp.conf is ready, specify destination label name when you invoke 172ppp. Commands associated with destination label is executed when ppp 173command is invoked. Note that commands associated with ``default'' 174label is ALWAYS executed. |
146 147Once connection is made, you'll find that prompt is changed to 148 149 capital \fIPPP\fR>. 150 151 % ppp pm2 152 ... | 175 176Once connection is made, you'll find that prompt is changed to 177 178 capital \fIPPP\fR>. 179 180 % ppp pm2 181 ... |
153 ppp> dial | 182 ppp ON tama> dial |
154 dial OK! 155 login OK! | 183 dial OK! 184 login OK! |
156 PPP> | 185 PPP ON tama> |
157 | 186 |
158If ppp.linkup file is available, its contents are executed when \fIPPP\fR link is connected. See example which add default route. The string HISADDR matches with IP address of connected peer. 159.LP | 187If ppp.linkup file is available, its contents are executed when 188\fIPPP\fR link is connected. See example which add default route. 189The string HISADDR matches with IP address of connected peer. |
160 | 190 |
191 |
|
161.SH DAIL ON DEMAND 162 163.LP | 192.SH DAIL ON DEMAND 193 194.LP |
164 To play with demand dialing, you must use -auto option. Also, you must specify destination label with proper setup in ppp.conf. It must contain ``ifaddr'' command to define peer's IP address. (refer /etc/ppp/ppp.conf.sample) 165.LP | 195 To play with demand dialing, you must use -auto option. Also, you 196must specify destination label with proper setup in ppp.conf. It must 197contain ``ifaddr'' command to define peer's IP address. (refer 198/etc/ppp/ppp.conf.sample) |
166 | 199 |
200 |
|
167 % ppp -auto pm2demand 168 ... 169 % 170 171.LP | 201 % ppp -auto pm2demand 202 ... 203 % 204 205.LP |
172When -auto is specified, \fIPPP\fR program works as a daemon. But, you are still able to use command features to check its behavior. 173.LP | 206When -auto is specified, \fIPPP\fR program works as a daemon. But, 207you are still able to use command features to check its behavior. |
174 | 208 |
209 |
|
175 % telnet localhost 3000 176 ... | 210 % telnet localhost 3000 211 ... |
177 PPP> show ipcp | 212 PPP on tama> show ipcp |
178 .... 179 180.LP | 213 .... 214 215.LP |
181 Each ppp has associated port number, which is computed as "3000 + tunnel_device_number". If 3000 is not good base number, edit defs.h. When packet toward to remote network is detected, \fIPPP\fR will take dialing action and try to connect with the peer. If dialing is failed, program will wait for 30 seconds. Once this hold time expired, another trigger packet cause dialing action. Note that automatic re-dialing is NOT implemented. 182.LP | 216 Each ppp has associated port number, which is computed as "3000 + 217tunnel_device_number". If 3000 is not good base number, edit defs.h. 218When packet toward to remote network is detected, \fIPPP\fR will take 219dialing action and try to connect with the peer. If dialing is failed, 220program will wait for 30 seconds. Once this hold time expired, another 221trigger packet cause dialing action. Note that automatic re-dialing is 222NOT implemented. |
183 | 223 |
224 |
|
184 To terminate program, use 185 | 225 To terminate program, use 226 |
186 PPP> close | 227 PPP on tama> close |
187 \fBppp\fR> quit all 188 189.LP 190 Simple ``quit'' command will terminates telnet connection, but \fIPPP\fR program itself is not terminated. You must use ``quit all'' to terminate the program running as daemon. 191.LP 192 193.SH PACKET FILTERING 194 --- 91 unchanged lines hidden (view full) --- 286 287.LP 288 To disable CCP/predictor function completely, use ``disable pred'' and ``deny pred'' command. 289.LP 290 291.SH Controlling IP address 292 293.LP | 228 \fBppp\fR> quit all 229 230.LP 231 Simple ``quit'' command will terminates telnet connection, but \fIPPP\fR program itself is not terminated. You must use ``quit all'' to terminate the program running as daemon. 232.LP 233 234.SH PACKET FILTERING 235 --- 91 unchanged lines hidden (view full) --- 327 328.LP 329 To disable CCP/predictor function completely, use ``disable pred'' and ``deny pred'' command. 330.LP 331 332.SH Controlling IP address 333 334.LP |
294 \fIPPP\fR uses IPCP to negotiate IP addresses. Each side of node informs IP address that willing to use to the peer, and if requested IP address is acceptable, \fIPPP\fR returns ACK to requester. Otherwise, \fIPPP\fR returns NAK to suggest the peer to use different IP address. When both side of nodes agrees to accept the received request (and send ACK), IPCP is reached to open state and network level connection is established. 295.LP | 335 \fIPPP\fR uses IPCP to negotiate IP addresses. Each side of node 336informs IP address that willing to use to the peer, and if requested 337IP address is acceptable, \fIPPP\fR returns ACK to 338requester. Otherwise, \fIPPP\fR returns NAK to suggest the peer to use 339different IP address. When both side of nodes agrees to accept the 340received request (and send ACK), IPCP is reached to open state and 341network level connection is established. |
296 | 342 |
343 |
|
297.LP | 344.LP |
298 To control, this IPCP behavior, this implementation has ``set ifaddr'' to define MY and HIS IP address. 299.LP | 345 To control, this IPCP behavior, this implementation has ``set 346ifaddr'' to define MY and HIS IP address. |
300 | 347 |
348 |
|
301.TP3 302ifaddr src_addr dst_addr 303 304.LP | 349.TP3 350ifaddr src_addr dst_addr 351 352.LP |
305 Where, src_addr is the IP address that my side is willing to use, and dst_addr is the IP address which his side should use. | 353Where, src_addr is the IP address that my side is willing to use, and 354dst_addr is the IP address which his side should use. |
306.LP 307 308.TP3 309ifaddr 192.244.177.38 192.244.177.2 310 311For example, above specification means 312 313.TP | 355.LP 356 357.TP3 358ifaddr 192.244.177.38 192.244.177.2 359 360For example, above specification means 361 362.TP |
314o 315I strongly want to use 192.244.177.38 as my side. I'll disagree when peer suggest me to use other addresses. | 363o I strongly want to use 192.244.177.38 as my side. I'll disagree when 364peer suggest me to use other addresses. |
316 317.TP 2 | 365 366.TP 2 |
318o 319I strongly insists peer to use 192.244.177.2 as his side address. I don't permit him to use any IP address but 192.244.177.2. When peer request other IP address, I always suggest him to use 192.244.177.2. | 367o I strongly insists peer to use 192.244.177.2 as his side address. I 368don't permit him to use any IP address but 192.244.177.2. When peer 369request other IP address, I always suggest him to use 192.244.177.2. |
320 321.LP 322 This is all right, when each side has pre-determined IP address. | 370 371.LP 372 This is all right, when each side has pre-determined IP address. |
323However, it is often the case one side is acting as a server which 324controls IP address and the other side should obey the direction from him. 325In order to allow more flexible behavior, `ifaddr' command allows user to specify IP address more loosely. 326.LP | 373However, it is often the case one side is acting as a server which 374controls IP address and the other side should obey the direction from 375him. In order to allow more flexible behavior, `ifaddr' command 376allows user to specify IP address more loosely. |
327 | 377 |
378 |
|
328.TP 2 329ifaddr 192.244.177.38/24 192.244.177.2/20 330 | 379.TP 2 380ifaddr 192.244.177.38/24 192.244.177.2/20 381 |
331 Number followed by slash (/) represents number of bits significant in IP address. That is, this example means | 382 Number followed by slash (/) represents number of bits significant in 383IP address. That is, this example means |
332 333.TP 2 | 384 385.TP 2 |
334o 335I'd like to use 192.244.177.38 as my side address, if it is possible. But I also accept any IP address between 192.244.177.0 and 192.244.177.255. | 386o I'd like to use 192.244.177.38 as my side address, if it is 387possible. But I also accept any IP address between 192.244.177.0 and 388192.244.177.255. |
336 337.TP 2 | 389 390.TP 2 |
338o 339I'd like to make him to use 192.244.177.2 as his side address. But I also permit him to use any IP address between 192.244.176.0 and 192.244.191.255. | 391o I'd like to make him to use 192.244.177.2 as his side address. But 392I also permit him to use any IP address between 192.244.176.0 and 393192.244.191.255. |
340 341 Notes: 342 343.TP 2 | 394 395 Notes: 396 397.TP 2 |
344o 345As you may have already noticed, 192.244.177.2 is equivalent to say 192.244.177.2/32. | 398o As you may have already noticed, 192.244.177.2 is equivalent to say 399192.244.177.2/32. |
346 347.TP 2 | 400 401.TP 2 |
348o 349As an exception, 0 is equivalent to 0.0.0.0/0. Means, I have no idea about IP address and obey what he says. | 402o As an exception, 0 is equivalent to 0.0.0.0/0. Means, I have no idea 403about IP address and obey what he says. |
350 351.TP 2 | 404 405.TP 2 |
352o 353192.244.177.2/0 means that I'll accept/permit any IP address but I'll try to insist to use 192.244.177.2 at first. | 406o 192.244.177.2/0 means that I'll accept/permit any IP address but 407I'll try to insist to use 192.244.177.2 at first. |
354 355.SH Connecting with service provider 356 357.LP 358 1) Describe provider's phone number in DialScript. Use ``set dial'' or 359 ``set phone'' command. 360 361 2) Describle login procedure in LoginScript. Use ``set login'' command. --- 21 unchanged lines hidden (view full) --- 383.B disable chap (or disable pap) 384.TP 3 385.B set authname MyName 386.TP 3 387.B set authkey MyPassword 388.TP 3 389 390.LP | 408 409.SH Connecting with service provider 410 411.LP 412 1) Describe provider's phone number in DialScript. Use ``set dial'' or 413 ``set phone'' command. 414 415 2) Describle login procedure in LoginScript. Use ``set login'' command. --- 21 unchanged lines hidden (view full) --- 437.B disable chap (or disable pap) 438.TP 3 439.B set authname MyName 440.TP 3 441.B set authkey MyPassword 442.TP 3 443 444.LP |
391Please refer /etc/ppp/example/ppp.conf.iij for some real examples. | 445Please refer /etc/ppp/ppp.conf.iij for some real examples. |
392.LP 393 394.SH Logging facility 395 396.LP | 446.LP 447 448.SH Logging facility 449 450.LP |
397 \fI\fIPPP\fR\fR is able to generate following level log info as /var/log/ppp.log 398.LP | 451 \fI\fIPPP\fR\fR is able to generate following level log info as 452/var/log/ppp.log |
399 | 453 |
454 |
|
400.TP 401.B Phase 402Phase transition log output 403.TP 404.B Chat 405Generate Chat script trace log 406.TP 407.B LQM 408Generate LQR report 409.TP 410.B LCP 411Generate LCP/IPCP packet trace 412.TP 413.B TCP/IP 414Dump TCP/IP packet 415.TP | 455.TP 456.B Phase 457Phase transition log output 458.TP 459.B Chat 460Generate Chat script trace log 461.TP 462.B LQM 463Generate LQR report 464.TP 465.B LCP 466Generate LCP/IPCP packet trace 467.TP 468.B TCP/IP 469Dump TCP/IP packet 470.TP |
416HDLC | 471.B HDLC |
417Dump HDLC packet in hex 418.TP 419.B Async 420Dump async level packet in hex 421 422.LP | 472Dump HDLC packet in hex 473.TP 474.B Async 475Dump async level packet in hex 476 477.LP |
423 ``set debug'' command allows you to set logging output level, 424and multiple levels can be specified. 425Default is equivalent to ``set debug phase lcp''. | 478``set debug'' command allows you to set logging output level, and 479multiple levels can be specified. Default is equivalent to ``set 480debug phase lcp''. |
426 427.SH For more details 428 429.TP 2 430o 431Please read Japanese doc for complete explanation. 432Well, it is not useful for non-japanese readers, 433but examples in the document may help you to guess. --- 10 unchanged lines hidden (view full) --- 444o 445NetBSD and BSDI-1.0 has been supported in previous release, 446but no longer supported in this release. 447Please contact to author if you need old driver code. 448 449.SH FILES 450.LP 451\fIPPP\fR may refers three files, ppp.conf, ppp.linkup and ppp.secret. | 481 482.SH For more details 483 484.TP 2 485o 486Please read Japanese doc for complete explanation. 487Well, it is not useful for non-japanese readers, 488but examples in the document may help you to guess. --- 10 unchanged lines hidden (view full) --- 499o 500NetBSD and BSDI-1.0 has been supported in previous release, 501but no longer supported in this release. 502Please contact to author if you need old driver code. 503 504.SH FILES 505.LP 506\fIPPP\fR may refers three files, ppp.conf, ppp.linkup and ppp.secret. |
452These files are placed in /etc/ppp, 453but user can create his own files under HOME directory as .ppp.conf, 454.ppp.linkup and .ppp.secret. 455the ppp always try to consult to user's personal setup first. | 507These files are placed in /etc/ppp, but user can create his own files 508under HOME directory as .ppp.conf,.ppp.linkup and .ppp.secret.the ppp 509always try to consult to user's personal setup first. |
456 457.TP | 510 511.TP |
458.B $HOME/ppp/.ppp.[linkup|secret] | 512.B $HOME/ppp/.ppp.[conf|linkup|secret] |
459User depend configuration files. 460 461.TP 462.B /etc/ppp/ppp.conf 463System default configuration file. 464 465.TP 466.B /etc/ppp/ppp.secret --- 9 unchanged lines hidden (view full) --- 476.B /var/log/ppp.log 477Logging and debug information file. 478 479.TP 480.B /var/spool/lock/Lck..* 481tty port locking file. 482 483.SH BUGS | 513User depend configuration files. 514 515.TP 516.B /etc/ppp/ppp.conf 517System default configuration file. 518 519.TP 520.B /etc/ppp/ppp.secret --- 9 unchanged lines hidden (view full) --- 530.B /var/log/ppp.log 531Logging and debug information file. 532 533.TP 534.B /var/spool/lock/Lck..* 535tty port locking file. 536 537.SH BUGS |
484A Proxy arp is not support, yet. 485The TTS is little bit longer than pppd2.1, it's under improving ;-) | |
486 487.SH HISTORY | 538 539.SH HISTORY |
488This programm has deliverd into core since FreeBSD-2.1 489by Atsushi Murai (amurai@spec.co.jp). | 540This programm has deliverd into core since FreeBSD-2.1 by Atsushi 541Murai (amurai@spec.co.jp). |
490 491.SH AUTHORS 492Toshiharu OHNO (tony-o@iij.ad.jp) | 542 543.SH AUTHORS 544Toshiharu OHNO (tony-o@iij.ad.jp) |