| ppp.8 (76026) | ppp.8 (77690) |
|---|---|
| 1.\" $FreeBSD: head/usr.sbin/ppp/ppp.8.m4 76026 2001-04-26 13:10:59Z brian $ | 1.\" 2.\" Copyright (c) 2001 Brian Somers <brian@Awfulhak.org> 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 14.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 15.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24.\" SUCH DAMAGE. 25.\" 26.\" $FreeBSD: head/usr.sbin/ppp/ppp.8.m4 77690 2001-06-04 14:38:29Z brian $ 27.\" |
| 2.Dd September 20, 1995 3.Dt PPP 8 4.Os 5.Sh NAME 6.Nm ppp 7.Nd Point to Point Protocol (a.k.a. user-ppp) 8.Sh SYNOPSIS 9.Nm --- 13 unchanged lines hidden (view full) --- 23and it's thus somewhat hard to debug and/or modify its behaviour. 24However, in this implementation 25.Em PPP 26is done as a user process with the help of the 27tunnel device driver (tun). 28.Pp 29The 30.Fl nat | 28.Dd September 20, 1995 29.Dt PPP 8 30.Os 31.Sh NAME 32.Nm ppp 33.Nd Point to Point Protocol (a.k.a. user-ppp) 34.Sh SYNOPSIS 35.Nm --- 13 unchanged lines hidden (view full) --- 49and it's thus somewhat hard to debug and/or modify its behaviour. 50However, in this implementation 51.Em PPP 52is done as a user process with the help of the 53tunnel device driver (tun). 54.Pp 55The 56.Fl nat |
| 31flag (or 32.Fl alias 33flag for backwards compatibility) does the equivalent of a | 57flag does the equivalent of a |
| 34.Dq nat enable yes , 35enabling 36.Nm Ns No 's 37network address translation features. 38This allows 39.Nm 40to act as a NAT or masquerading engine for all machines on an internal 41LAN. --- 178 unchanged lines hidden (view full) --- 220CallBack Control Protocol (ftp://ftp.microsoft.com/developr/rfc/cbcp.txt). 221.It Supports NAT or packet aliasing. 222Packet aliasing (a.k.a. IP masquerading) allows computers on a 223private, unregistered network to access the Internet. 224The 225.Em PPP 226host acts as a masquerading gateway. 227IP addresses as well as TCP and | 58.Dq nat enable yes , 59enabling 60.Nm Ns No 's 61network address translation features. 62This allows 63.Nm 64to act as a NAT or masquerading engine for all machines on an internal 65LAN. --- 178 unchanged lines hidden (view full) --- 244CallBack Control Protocol (ftp://ftp.microsoft.com/developr/rfc/cbcp.txt). 245.It Supports NAT or packet aliasing. 246Packet aliasing (a.k.a. IP masquerading) allows computers on a 247private, unregistered network to access the Internet. 248The 249.Em PPP 250host acts as a masquerading gateway. 251IP addresses as well as TCP and |
| 228UDP port numbers are aliased for outgoing packets and de-aliased for | 252UDP port numbers are NAT'd for outgoing packets and de-NAT'd for |
| 229returning packets. 230.It Supports background PPP connections. 231In background mode, if 232.Nm 233successfully establishes the connection, it will become a daemon. 234Otherwise, it will exit with an error. 235This allows the setup of 236scripts that wish to execute certain commands only if the connection --- 1333 unchanged lines hidden (view full) --- 1570.Dq set authname 1571and 1572.Dq set authkey 1573in your profile). 1574.Pp 1575.Sh NETWORK ADDRESS TRANSLATION (PACKET ALIASING) 1576The 1577.Fl nat | 253returning packets. 254.It Supports background PPP connections. 255In background mode, if 256.Nm 257successfully establishes the connection, it will become a daemon. 258Otherwise, it will exit with an error. 259This allows the setup of 260scripts that wish to execute certain commands only if the connection --- 1333 unchanged lines hidden (view full) --- 1594.Dq set authname 1595and 1596.Dq set authkey 1597in your profile). 1598.Pp 1599.Sh NETWORK ADDRESS TRANSLATION (PACKET ALIASING) 1600The 1601.Fl nat |
| 1578.Pq \&or Fl alias | |
| 1579command line option enables network address translation (a.k.a. packet 1580aliasing). 1581This allows the 1582.Nm 1583host to act as a masquerading gateway for other computers over 1584a local area network. | 1602command line option enables network address translation (a.k.a. packet 1603aliasing). 1604This allows the 1605.Nm 1606host to act as a masquerading gateway for other computers over 1607a local area network. |
| 1585Outgoing IP packets are aliased so that they appear to come from the | 1608Outgoing IP packets are NAT'd so that they appear to come from the |
| 1586.Nm | 1609.Nm |
| 1587host, and incoming packets are de-aliased so that they are routed | 1610host, and incoming packets are de-NAT'd so that they are routed |
| 1588to the correct machine on the local area network. | 1611to the correct machine on the local area network. |
| 1589Packet aliasing allows computers on private, unregistered 1590subnets to have Internet access, although they are invisible 1591from the outside world. | 1612NAT allows computers on private, unregistered subnets to have Internet 1613access, although they are invisible from the outside world. |
| 1592In general, correct 1593.Nm 1594operation should first be verified with network address translation disabled. 1595Then, the 1596.Fl nat 1597option should be switched on, and network applications (web browser, 1598.Xr telnet 1 , 1599.Xr ftp 1 , --- 1654 unchanged lines hidden (view full) --- 3254This command allows the control of the network address translation (also 3255known as masquerading or IP aliasing) facilities that are built into 3256.Nm . 3257NAT is done on the external interface only, and is unlikely to make sense 3258if used with the 3259.Fl direct 3260flag. 3261.Pp | 1614In general, correct 1615.Nm 1616operation should first be verified with network address translation disabled. 1617Then, the 1618.Fl nat 1619option should be switched on, and network applications (web browser, 1620.Xr telnet 1 , 1621.Xr ftp 1 , --- 1654 unchanged lines hidden (view full) --- 3276This command allows the control of the network address translation (also 3277known as masquerading or IP aliasing) facilities that are built into 3278.Nm . 3279NAT is done on the external interface only, and is unlikely to make sense 3280if used with the 3281.Fl direct 3282flag. 3283.Pp |
| 3262For backwards compatibility, the word 3263.Dq alias 3264may be used in place of 3265.Dq nat . | |
| 3266If nat is enabled on your system (it may be omitted at compile time), 3267the following commands are possible: 3268.Bl -tag -width 2n 3269.It nat enable yes|no 3270This command either switches network address translation on or turns it off. 3271The 3272.Fl nat 3273command line flag is synonymous with --- 106 unchanged lines hidden (view full) --- 3380IRC connection. 3381.It nat unregistered_only yes|no 3382Only alter outgoing packets with an unregistered source address. 3383According to RFC 1918, unregistered source addresses 3384are 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16. 3385.El 3386.Pp 3387These commands are also discussed in the file | 3284If nat is enabled on your system (it may be omitted at compile time), 3285the following commands are possible: 3286.Bl -tag -width 2n 3287.It nat enable yes|no 3288This command either switches network address translation on or turns it off. 3289The 3290.Fl nat 3291command line flag is synonymous with --- 106 unchanged lines hidden (view full) --- 3398IRC connection. 3399.It nat unregistered_only yes|no 3400Only alter outgoing packets with an unregistered source address. 3401According to RFC 1918, unregistered source addresses 3402are 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16. 3403.El 3404.Pp 3405These commands are also discussed in the file |
| 3388.Pa README.alias | 3406.Pa README.nat |
| 3389which comes with the source distribution. 3390.Pp 3391.It Op !\& Ns Xo 3392.No bg Ar command 3393.Xc 3394The given 3395.Ar command 3396is executed in the background with the following words replaced: --- 2203 unchanged lines hidden --- | 3407which comes with the source distribution. 3408.Pp 3409.It Op !\& Ns Xo 3410.No bg Ar command 3411.Xc 3412The given 3413.Ar command 3414is executed in the background with the following words replaced: --- 2203 unchanged lines hidden --- |