| ppp.8 (39470) | ppp.8 (40561) |
|---|---|
| 1.\" $Id: ppp.8,v 1.125 1998/09/17 00:45:12 brian Exp $ | 1.\" $Id: ppp.8,v 1.126 1998/09/18 23:28:10 brian Exp $ |
| 2.Dd 20 September 1995 3.Os FreeBSD 4.Dt PPP 8 5.Sh NAME 6.Nm ppp 7.Nd Point to Point Protocol (a.k.a. user-ppp) 8.Sh SYNOPSIS 9.Nm --- 393 unchanged lines hidden (view full) --- 403.Em PPP 404link), enter the following command: 405.Bd -literal -offset indent 406PPP ON awfulhak> add default HISADDR 407.Ed 408.Pp 409The string 410.Sq HISADDR | 2.Dd 20 September 1995 3.Os FreeBSD 4.Dt PPP 8 5.Sh NAME 6.Nm ppp 7.Nd Point to Point Protocol (a.k.a. user-ppp) 8.Sh SYNOPSIS 9.Nm --- 393 unchanged lines hidden (view full) --- 403.Em PPP 404link), enter the following command: 405.Bd -literal -offset indent 406PPP ON awfulhak> add default HISADDR 407.Ed 408.Pp 409The string 410.Sq HISADDR |
| 411represents the IP address of the connected peer. It is possible to 412use the keyword 413.Sq INTERFACE 414in place of 415.Sq HISADDR . 416This will create a direct route on the tun interface. 417If it fails due to an existing route, you can overwrite the existing | 411represents the IP address of the connected peer. 412If the 413.Dq add 414command fails due to an existing route, you can overwrite the existing |
| 418route using 419.Bd -literal -offset indent 420PPP ON awfulhak> add! default HISADDR 421.Ed 422.Pp 423You can now use your network applications (ping, telnet, ftp etc.) 424in other windows on your machine. 425Refer to the --- 83 unchanged lines hidden (view full) --- 509.Pa /etc/ppp/ppp.linkup 510file is available, its contents are executed 511when the 512.Em PPP 513connection is established. See the provided 514.Dq pmdemand 515example in 516.Pa /etc/ppp/ppp.conf.sample | 415route using 416.Bd -literal -offset indent 417PPP ON awfulhak> add! default HISADDR 418.Ed 419.Pp 420You can now use your network applications (ping, telnet, ftp etc.) 421in other windows on your machine. 422Refer to the --- 83 unchanged lines hidden (view full) --- 506.Pa /etc/ppp/ppp.linkup 507file is available, its contents are executed 508when the 509.Em PPP 510connection is established. See the provided 511.Dq pmdemand 512example in 513.Pa /etc/ppp/ppp.conf.sample |
| 517which runs a script in the background after the connection is established. 518The literal strings 519.Dv HISADDR , 520.Dv MYADDR | 514which runs a script in the background after the connection is established 515(refer to the 516.Dq shell |
| 521and | 517and |
| 522.Dv INTERFACE 523may be used, and will be replaced with the relevant IP addresses and interface 524name. Similarly, when a connection is closed, the 525contents of the | 518.Dq bg 519commands below for a description of possible substition strings). Similarly, 520when a connection is closed, the contents of the |
| 526.Pa /etc/ppp/ppp.linkdown | 521.Pa /etc/ppp/ppp.linkdown |
| 527file are executed. 528Both of these files have the same format as | 522file are executed. Both of these files have the same format as |
| 529.Pa /etc/ppp/ppp.conf . 530.Pp 531In previous versions of 532.Nm ppp , 533it was necessary to re-add routes such as the default route in the 534.Pa ppp.linkup 535file. 536.Nm Ppp --- 1592 unchanged lines hidden (view full) --- 2129.Nm 2130is running in 2131.Fl direct 2132mode, an entry is made in the utmp and wtmp files for that user. Disabling 2133this option will tell 2134.Nm 2135not to make any utmp or wtmp entries. This is usually only necessary if 2136you require the user to both login and authenticate themselves. | 523.Pa /etc/ppp/ppp.conf . 524.Pp 525In previous versions of 526.Nm ppp , 527it was necessary to re-add routes such as the default route in the 528.Pa ppp.linkup 529file. 530.Nm Ppp --- 1592 unchanged lines hidden (view full) --- 2123.Nm 2124is running in 2125.Fl direct 2126mode, an entry is made in the utmp and wtmp files for that user. Disabling 2127this option will tell 2128.Nm 2129not to make any utmp or wtmp entries. This is usually only necessary if 2130you require the user to both login and authenticate themselves. |
| 2131.It iface-alias 2132Default: Enabled if 2133.Fl alias 2134is specified. This option simply tells 2135.Nm 2136to add new interface addresses to the interface rather than replacing them. 2137The option can only be enabled if IP aliasing is enabled 2138.Pq Dq alias enable yes . 2139.Pp 2140With this option enabled, 2141.Nm 2142will pass traffic for old interface addresses through the IP alias engine 2143.Pq see Xr libalias 5 , 2144resulting in the ability (in 2145.Fl auto 2146mode) to properly connect the process that caused the PPP link to 2147come up in the first place. 2148.Pp 2149Disabling IP aliasing with 2150.Dq alias enable off 2151will also disable 2152.Sq iface-alias . |
|
| 2137.El 2138.Pp 2139.It add[!] Ar dest[/nn] [mask] gateway 2140.Ar Dest 2141is the destination IP address. The netmask is specified either as a 2142number of bits with 2143.Ar /nn 2144or as an IP number using --- 12 unchanged lines hidden (view full) --- 2157machine/network. Refer to the 2158.Xr route 8 2159command for further details. 2160.Pp 2161It is possible to use the symbolic names 2162.Sq MYADDR 2163or 2164.Sq HISADDR | 2153.El 2154.Pp 2155.It add[!] Ar dest[/nn] [mask] gateway 2156.Ar Dest 2157is the destination IP address. The netmask is specified either as a 2158number of bits with 2159.Ar /nn 2160or as an IP number using --- 12 unchanged lines hidden (view full) --- 2173machine/network. Refer to the 2174.Xr route 8 2175command for further details. 2176.Pp 2177It is possible to use the symbolic names 2178.Sq MYADDR 2179or 2180.Sq HISADDR |
| 2165as the destination, and either | 2181as the destination, and |
| 2166.Sq HISADDR | 2182.Sq HISADDR |
| 2167or 2168.Sq INTERFACE | |
| 2169as the 2170.Ar gateway . 2171.Sq MYADDR | 2183as the 2184.Ar gateway . 2185.Sq MYADDR |
| 2172is replaced with the interface address, | 2186is replaced with the interface address and |
| 2173.Sq HISADDR | 2187.Sq HISADDR |
| 2174is replaced with the interface destination address and 2175.Sq INTERFACE 2176is replaced with the current interface name. If the interfaces destination 2177address has not yet been assigned 2178.Pq via Dq set ifaddr , 2179the current 2180.Sq INTERFACE 2181is used instead of 2182.Sq HISADDR . | 2188is replaced with the interface destination (peer) address. |
| 2183.Pp 2184If the 2185.Ar add! 2186command is used 2187.Pq note the trailing Dq \&! , 2188then if the route already exists, it will be updated as with the 2189.Sq route change 2190command (see --- 280 unchanged lines hidden (view full) --- 2471layer is terminated but the modem is not brought offline and the link 2472is not closed. If 2473.Sq ccp 2474is specified, only the relevant compression layer(s) are terminated. 2475.It help|? Op Ar command 2476Show a list of available commands. If 2477.Ar command 2478is specified, show the usage string for that command. | 2189.Pp 2190If the 2191.Ar add! 2192command is used 2193.Pq note the trailing Dq \&! , 2194then if the route already exists, it will be updated as with the 2195.Sq route change 2196command (see --- 280 unchanged lines hidden (view full) --- 2477layer is terminated but the modem is not brought offline and the link 2478is not closed. If 2479.Sq ccp 2480is specified, only the relevant compression layer(s) are terminated. 2481.It help|? Op Ar command 2482Show a list of available commands. If 2483.Ar command 2484is specified, show the usage string for that command. |
| 2485.It iface Ar command Op args 2486This command is used to control the interface used by 2487.Nm ppp . 2488.Ar Command 2489may be one of the following: 2490.Bl -tag -width XX 2491.It iface add[!] Ar addr[/bits| mask] peer 2492Add the given 2493.Ar addr mask peer 2494combination to the interface. Instead of specifying 2495.Ar mask , 2496.Ar /bits 2497can be used 2498.Pq with no space between \&it and Ar addr . 2499If the given address already exists, the command fails unless the 2500.Dq \&! 2501is used - in which case the previous interface address entry is overwritten 2502with the new one, allowing a change of netmask or peer address. 2503.It iface clear 2504If this command is used while 2505.Nm 2506is in the OPENED state, all addresses except for the IPCP negotiated 2507address are deleted from the interface. If 2508.Nm 2509is not in the OPENED state, all interface addresses are deleted. 2510.Pp 2511.It iface delete[!]|rm[!] Ar addr 2512This command deletes the given 2513.Ar addr 2514from the interface. If the 2515.Dq \&! 2516is used, no error is given if the address isn't currently assigned to 2517the interface (and no deletion takes place). 2518.It iface show 2519Shows the current state and current addresses for the interface. It is 2520much the same as running 2521.Dq ifconfig INTERFACE . 2522.It iface help Op Ar sub-command 2523This command, when invoked without 2524.Ar sub-command , 2525will show a list of possbile 2526.Dq iface 2527sub-commands and a brief synopsis for each. When invoked with 2528.Ar sub-command , 2529only the synopsis for the given sub-command is shown. 2530.El |
|
| 2479.It [data]link Ar name[,name...] command Op Ar args 2480This command may prefix any other command if the user wishes to 2481specify which link the command should affect. This is only 2482applicable after multiple links have been created in Multi-link 2483mode using the 2484.Dq clone 2485command. 2486.Pp --- 668 unchanged lines hidden (view full) --- 3155.Sq mode 3156of the specified link. This is normally only useful in multi-link mode, 3157but may also be used in uni-link mode. 3158.Pp 3159It is not possible to change a link that is 3160.Sq direct 3161or 3162.Sq dedicated . | 2531.It [data]link Ar name[,name...] command Op Ar args 2532This command may prefix any other command if the user wishes to 2533specify which link the command should affect. This is only 2534applicable after multiple links have been created in Multi-link 2535mode using the 2536.Dq clone 2537command. 2538.Pp --- 668 unchanged lines hidden (view full) --- 3207.Sq mode 3208of the specified link. This is normally only useful in multi-link mode, 3209but may also be used in uni-link mode. 3210.Pp 3211It is not possible to change a link that is 3212.Sq direct 3213or 3214.Sq dedicated . |
| 3215.Pp 3216Note: If you issue the command 3217.Dq set mode auto , 3218and have IP aliasing enabled, it may be useful to 3219.Dq enable iface-alias 3220afterwards. This will allow 3221.Nm 3222to do the necessary address translations to enable the process that 3223triggers the connection to connect once the link is up despite the 3224peer assigning us a new (dynamic) IP address. |
|
| 3163.It set mrru Op Ar value 3164Setting this option enables Multi-link PPP negotiations, also known as 3165Multi-link Protocol or MP. There is no default MRRU (Maximum 3166Reconstructed Receive Unit) value. If no argument is given, multi-link 3167mode is disabled. 3168.It set mru Op Ar value 3169The default MRU (Maximum Receive Unit) is 1500. If it is increased, the 3170other side *may* increase its mtu. There is no point in decreasing the --- 233 unchanged lines hidden (view full) --- 3404.It show filter Op Ar name 3405List the current rules for the given filter. If 3406.Ar name 3407is not specified, all filters are shown. 3408.It show hdlc 3409Show the current HDLC statistics. 3410.It show help|? 3411Give a summary of available show commands. | 3225.It set mrru Op Ar value 3226Setting this option enables Multi-link PPP negotiations, also known as 3227Multi-link Protocol or MP. There is no default MRRU (Maximum 3228Reconstructed Receive Unit) value. If no argument is given, multi-link 3229mode is disabled. 3230.It set mru Op Ar value 3231The default MRU (Maximum Receive Unit) is 1500. If it is increased, the 3232other side *may* increase its mtu. There is no point in decreasing the --- 233 unchanged lines hidden (view full) --- 3466.It show filter Op Ar name 3467List the current rules for the given filter. If 3468.Ar name 3469is not specified, all filters are shown. 3470.It show hdlc 3471Show the current HDLC statistics. 3472.It show help|? 3473Give a summary of available show commands. |
| 3474.It show iface 3475Show the current interface information 3476.Pq the same \&as Dq iface show . |
|
| 3412.It show ipcp 3413Show the current IPCP statistics. 3414.It show lcp 3415Show the current LCP statistics. 3416.It show [data]link 3417Show high level link information. 3418.It show links 3419Show a list of available logical links. --- 155 unchanged lines hidden --- | 3477.It show ipcp 3478Show the current IPCP statistics. 3479.It show lcp 3480Show the current LCP statistics. 3481.It show [data]link 3482Show high level link information. 3483.It show links 3484Show a list of available logical links. --- 155 unchanged lines hidden --- |