mirror/freebsd
1
0
Fork 0
mirror of https://git.FreeBSD.org/src.git synced 2025-01-20 15:43:16 +00:00
Code Issues Releases Activity

Some documentation corrections & typo fixes....

Browse Source
This commit is contained in:
Brian Somers 1998-05-29 18:32:41 +00:00
parent 81358fa3fc
commit 05dbe14bd3
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=36466
7 changed files with 217 additions and 180 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
usr.sbin/ppp/README.alias
View File

@ -7,7 +7,7 @@ User PPP Packet Aliasing
2. Setup
3. New commands in ppp
4. Future Work
5. Authors / Acknowledgments
5. Authors / Acknowledgements
6. Revision History for Aliasing Code
@ -52,7 +52,7 @@ masquerading solutions.
The implementation supports all standard, non-encoding TCP and UDP protocols.
Examples of these protocols are http, gopher and telnet. The standard UDP
mode of RealAudio is not presently supported, but the TCP mode does work
mode of Real-Audio is not presently supported, but the TCP mode does work
correctly.
The packet aliasing code also handle many ICMP messages. In particular,
@ -86,12 +86,12 @@ and masks.
3. New commands in ppp
In order to control aliasing behavior in a simple manner (no need for
recompilation), a new command has been added to iij-ppp: alias. This
In order to control aliasing behaviour in a simple manner (no need for
recompilation), a new command has been added to ppp: alias. This
is in addition to the -alias command line option. System managers and
more experienced users may prefer to use the iij-ppp command syntax
more experienced users may prefer to use the ppp command syntax
within the ppp.conf file. The alias command also allows packet aliasing
behavior to be more precisely specified.
behaviour to be more precisely specified.
The decision to add a command instead of extending 'set' or 'option' was
to make obvious that these options only work when aliasing is enabled.
@ -119,7 +119,7 @@ Set to "yes" to disable all incoming connections. This just drops
connections to, for example, ftp, telnet or web servers. The aliasing
mechanism prevents these connections. Technically, this option denies
all incoming TCP and UDP requests, making the aliasing software a
fairly efficient one-way firewall. The default is no, which will
fairly efficient one-way firewall. The default is no, which will allow
all incoming connections to telnetd, ftpd, etc.
@ -128,7 +128,7 @@ all incoming connections to telnetd, ftpd, etc.
Controls logging of alias link creation to "/var/log/alias.log" - this
is usually only useful if debugging a setup, to see if the bug is in
the PPP aliasing. The debugging information is fairly limited, listing
the number of aliasing links open for different prototocols.
the number of aliasing links open for different protocols.
- alias same_ports [yes|no] (default yes)
@ -137,7 +137,7 @@ When a connection is being established going through the aliasing
routines, it will normally have its port number changed to allow the
aliasing code to track it. If same_ports is enabled, the alias
software attempts to keep the connection's source port unchanged.
This will allow rsh, RPC and other specialized protocols to work
This will allow rsh, RPC and other specialised protocols to work
_most of the time_, at least on the host machine. Please, do not
report this being unstable as a bug - it is a result of the way
aliasing has to work. TCP/IP was intended to have one IP address
@ -149,11 +149,11 @@ per machine.
This is a fairly obscure option. For the most part, the packet aliasing
software does not have to allocate system sockets when it chooses an
aliasing port number. Under very specific circumstances, FTP data
connections (which don't know the remote port nubmer, though it is
connections (which don't know the remote port number, though it is
usually 20) and IRC DCC send (which doesn't know either the address or
the port from which the connection will come), there can potentially be
some interference with an open server socket having the same port number
on the ppp host machine. This possibility for interferience only exists
on the ppp host machine. This possibility for interference only exists
until the TCP connection has been acknowledged on both sides. The safe
option is yes, though fewer system resources are consumed by specifying
no.
@ -183,7 +183,7 @@ local area network. One example of this would be:
alias port tcp 192.168.0.4:telnet 8066
All traffic to port 8066 fthe ppp host would then be sent to
All traffic to port 8066 of the ppp host would then be sent to
the telnet port (23) of machine 192.168.0.4. Port numbers
can either be designated numerically or by symbolic names
listed in /etc/services. Similarly, addresses can be either
@ -205,14 +205,14 @@ case of a single, dynamically allocated IP address:
The above command would redirect all incoming traffic to
machine 10.0.0.8.
If several address aliases specifiy the same public addres
If several address aliases specify the same public address
as follows
alias addr 192.168.0.2 public_addr
alias addr 192.168.0.3 public_addr
alias addr 192.168.0.4 public_addr
then incoming traffice will be directed to the last
then incoming traffic will be directed to the last
translated local address (192.168.0.4), but outgoing
traffic to the first two addresses will still be aliased
to the specified public address.
@ -239,12 +239,12 @@ robust.
The packet aliasing engine (alias.c, alias_db.c, alias_ftp.c, alias_irc.c
and alias_util.c) runs in user space, and is intended to be both portable
and reusable for interfaces other than ppp. To access the basic engine
only requires four simple function calls (initialization, communication of
only requires four simple function calls (initialisation, communication of
host address, outgoing aliasing and incoming de-aliasing).
5. Authors / Acknowledgments
5. Authors / Acknowledgements
Charles Mott (cmott@srv.net) <versions 1.0 - 1.8, 2.0, 2.1>
Eivind Eklund (perhaps@yes.no) <versions 1.8b - 1.9, new ppp commands>
@ -275,7 +275,7 @@ Version 1.2: September 7, 1996 (cjm)
Fragment handling error in alias_db.c corrected.
Version 1.3: September 15, 1996 (cjm)
- Generalized mechanism for handling incoming connections
- Generalised mechanism for handling incoming connections
(no more 0 to 1023 restriction).
- Increased ICMP support (will handle traceroute now).
- Improved TCP close connection logic.
@ -291,7 +291,7 @@ Version 1.6: September 18, 1996
Simplified ICMP data storage. Will now handle
tracert from Win95 as well as FreeBSD traceroute.
Verstion 1.7: January 9, 1997 (cjm)
Version 1.7: January 9, 1997 (cjm)
- Reduced malloc() activity for ICMP echo and
timestamp requests.
- Added handling for out-of-order IP fragments.
@ -303,12 +303,12 @@ Verstion 1.7: January 9, 1997 (cjm)
from two hosts which are both running packet
aliasing.
Verstion 1.8: January 14, 1997 (cjm)
Version 1.8: January 14, 1997 (cjm)
- Fixed data type error in function StartPoint()
in alias_db.c (this bug did not exist before v1.7)
Version 1.8b: January 16, 1997 (Eivind Eklund <perhaps@yes.no>)
- Upgraded base PPP version to be the sourcecode from
- Upgraded base PPP version to be the source code from
FreeBSD 2.1.6, with additional security patches. This
version should still be possible to run on 2.1.5, though -
I've run it with a 2.1.5 kernel without problems.
@ -335,10 +335,10 @@ Version 1.9: February 1, 1997 (Eivind Eklund <perhaps@yes.no>)
(cjm)
Version 2.0: March, 1997 (cjm)
- Incoming packets which are not recognized by the packet
- Incoming packets which are not recognised by the packet
aliasing engine are now completely dropped in ip.c.
- Aliasing links are cleared when a host interface address
changes (due to re-dial and dynamic address allocatioa).
changes (due to re-dial and dynamic address allocation).
- PacketAliasPermanentLink() API added.
- Option for only aliasing private, unregistered IP addresses
added.
@ -347,6 +347,6 @@ Version 2.0: March, 1997 (cjm)
Version 2.1: May, 1997 (cjm)
- Continuing rework to the aliasing lookup engine to support
multiple incoming addresses and static NAT.
- Now supports outgoing as well as incoming ICMP error messges/
- Now supports outgoing as well as incoming ICMP error messages/
- PPP commands to support address and port redirection.

6
usr.sbin/ppp/README.changes
View File

@ -34,7 +34,7 @@ o The value of the CONNECT environment variable is logged in the
o Out-of-sequence FSM packets (IPCP/LCP/CCP) are dropped by default.
o Reconnect values are used after an LQR timeout.
o ^C works on the parent in -background mode.
o The dial/call/open command works asyncronously. As a result, prompts
o The dial/call/open command works asynchronously. As a result, prompts
do not lose control while dialing.
o The `display' command has been removed. All information is available
with the appropriate `show' command.
@ -51,7 +51,7 @@ o `Set stopped' only has two parameters. It's no longer possible to
have an IPCP stopped timer.
o `Set timeout' only has one parameter. Use `set lqrperiod' and `set
{lcp,ccp,ipcp,chap,pap}retry' for the other timers. `show timeout'
is also now available using the relevent show commands.
is also now available using the relevant show commands.
o `set loopback' is now `enable/disable loopback'.
o `show auto', `show loopback' and `show mtu' are all part of `show bundle'.
o `show mru' is part of `show lcp'
@ -68,3 +68,5 @@ o Ppp can use tun devices > tun255.
o Protocol-compressed packets are accepted even if they were denied
at LCP negotiation time.
o Passwords aren't logged when logging the ``set server'' line.
o Command line options only need enough characters to uniquely identify
them. -a == -auto, -dd == -ddial etc. -interactive is also allowed.

15
usr.sbin/ppp/README.devel
View File

@ -4,19 +4,22 @@ The original version was usually referred to as iij-ppp.
Ppp is currently maintained under FreeBSD and OpenBSD by Brian Somers
<brian@Awfulhak.org>. The sources for both operating systems are the
same although the Makefiles vary due to the nature of each system.
If and when it's ported to another OS, things will probably be shuffled
around so that there are several Makefiles, one per architecture.
same except that OpenBSD is missing some files (the OpenBSD project
does not want libalias - not as a library anyway) and the Makefiles vary
due to the nature of each system. If and when it's ported to another OS,
things will probably be shuffled around so that there are several Makefiles,
one per architecture.
The latest sources are available in FreeBSD-current and OpenBSD-current.
An archive hacked so that it will build on just about any version of
FreeBSD is frequently generated and made available on
http://www.FreeBSD.org/~brian. Once the first OpenBSD release is made
with ppp, an up-to-date OpenBSD archive will be made available too.
http://www.FreeBSD.org/~brian. An up-to-date OpenBSD archive will also be
made available soon.
A FAQ is available at http://www.FreeBSD.org/FAQ/userppp.html. It applies
equally to OpenBSD as it does to FreeBSD. The man page is quite extensive,
and there are lots of examples in /etc/ppp/ppp.*.sample. These examples
come with the hacked archive above but must be installed manually.
come with the hacked archive above but must be installed manually with
``make etc-install''.
Ppp is still under development. There is no official TODO list.

46
usr.sbin/ppp/README.nat
View File

@ -7,7 +7,7 @@ User PPP Packet Aliasing
2. Setup
3. New commands in ppp
4. Future Work
5. Authors / Acknowledgments
5. Authors / Acknowledgements
6. Revision History for Aliasing Code
@ -52,7 +52,7 @@ masquerading solutions.
The implementation supports all standard, non-encoding TCP and UDP protocols.
Examples of these protocols are http, gopher and telnet. The standard UDP
mode of RealAudio is not presently supported, but the TCP mode does work
mode of Real-Audio is not presently supported, but the TCP mode does work
correctly.
The packet aliasing code also handle many ICMP messages. In particular,
@ -86,12 +86,12 @@ and masks.
3. New commands in ppp
In order to control aliasing behavior in a simple manner (no need for
recompilation), a new command has been added to iij-ppp: alias. This
In order to control aliasing behaviour in a simple manner (no need for
recompilation), a new command has been added to ppp: alias. This
is in addition to the -alias command line option. System managers and
more experienced users may prefer to use the iij-ppp command syntax
more experienced users may prefer to use the ppp command syntax
within the ppp.conf file. The alias command also allows packet aliasing
behavior to be more precisely specified.
behaviour to be more precisely specified.
The decision to add a command instead of extending 'set' or 'option' was
to make obvious that these options only work when aliasing is enabled.
@ -119,7 +119,7 @@ Set to "yes" to disable all incoming connections. This just drops
connections to, for example, ftp, telnet or web servers. The aliasing
mechanism prevents these connections. Technically, this option denies
all incoming TCP and UDP requests, making the aliasing software a
fairly efficient one-way firewall. The default is no, which will
fairly efficient one-way firewall. The default is no, which will allow
all incoming connections to telnetd, ftpd, etc.
@ -128,7 +128,7 @@ all incoming connections to telnetd, ftpd, etc.
Controls logging of alias link creation to "/var/log/alias.log" - this
is usually only useful if debugging a setup, to see if the bug is in
the PPP aliasing. The debugging information is fairly limited, listing
the number of aliasing links open for different prototocols.
the number of aliasing links open for different protocols.
- alias same_ports [yes|no] (default yes)
@ -137,7 +137,7 @@ When a connection is being established going through the aliasing
routines, it will normally have its port number changed to allow the
aliasing code to track it. If same_ports is enabled, the alias
software attempts to keep the connection's source port unchanged.
This will allow rsh, RPC and other specialized protocols to work
This will allow rsh, RPC and other specialised protocols to work
_most of the time_, at least on the host machine. Please, do not
report this being unstable as a bug - it is a result of the way
aliasing has to work. TCP/IP was intended to have one IP address
@ -149,11 +149,11 @@ per machine.
This is a fairly obscure option. For the most part, the packet aliasing
software does not have to allocate system sockets when it chooses an
aliasing port number. Under very specific circumstances, FTP data
connections (which don't know the remote port nubmer, though it is
connections (which don't know the remote port number, though it is
usually 20) and IRC DCC send (which doesn't know either the address or
the port from which the connection will come), there can potentially be
some interference with an open server socket having the same port number
on the ppp host machine. This possibility for interferience only exists
on the ppp host machine. This possibility for interference only exists
until the TCP connection has been acknowledged on both sides. The safe
option is yes, though fewer system resources are consumed by specifying
no.
@ -183,7 +183,7 @@ local area network. One example of this would be:
alias port tcp 192.168.0.4:telnet 8066
All traffic to port 8066 fthe ppp host would then be sent to
All traffic to port 8066 of the ppp host would then be sent to
the telnet port (23) of machine 192.168.0.4. Port numbers
can either be designated numerically or by symbolic names
listed in /etc/services. Similarly, addresses can be either
@ -205,14 +205,14 @@ case of a single, dynamically allocated IP address:
The above command would redirect all incoming traffic to
machine 10.0.0.8.
If several address aliases specifiy the same public addres
If several address aliases specify the same public address
as follows
alias addr 192.168.0.2 public_addr
alias addr 192.168.0.3 public_addr
alias addr 192.168.0.4 public_addr
then incoming traffice will be directed to the last
then incoming traffic will be directed to the last
translated local address (192.168.0.4), but outgoing
traffic to the first two addresses will still be aliased
to the specified public address.
@ -239,12 +239,12 @@ robust.
The packet aliasing engine (alias.c, alias_db.c, alias_ftp.c, alias_irc.c
and alias_util.c) runs in user space, and is intended to be both portable
and reusable for interfaces other than ppp. To access the basic engine
only requires four simple function calls (initialization, communication of
only requires four simple function calls (initialisation, communication of
host address, outgoing aliasing and incoming de-aliasing).
5. Authors / Acknowledgments
5. Authors / Acknowledgements
Charles Mott (cmott@srv.net) <versions 1.0 - 1.8, 2.0, 2.1>
Eivind Eklund (perhaps@yes.no) <versions 1.8b - 1.9, new ppp commands>
@ -275,7 +275,7 @@ Version 1.2: September 7, 1996 (cjm)
Fragment handling error in alias_db.c corrected.
Version 1.3: September 15, 1996 (cjm)
- Generalized mechanism for handling incoming connections
- Generalised mechanism for handling incoming connections
(no more 0 to 1023 restriction).
- Increased ICMP support (will handle traceroute now).
- Improved TCP close connection logic.
@ -291,7 +291,7 @@ Version 1.6: September 18, 1996
Simplified ICMP data storage. Will now handle
tracert from Win95 as well as FreeBSD traceroute.
Verstion 1.7: January 9, 1997 (cjm)
Version 1.7: January 9, 1997 (cjm)
- Reduced malloc() activity for ICMP echo and
timestamp requests.
- Added handling for out-of-order IP fragments.
@ -303,12 +303,12 @@ Verstion 1.7: January 9, 1997 (cjm)
from two hosts which are both running packet
aliasing.
Verstion 1.8: January 14, 1997 (cjm)
Version 1.8: January 14, 1997 (cjm)
- Fixed data type error in function StartPoint()
in alias_db.c (this bug did not exist before v1.7)
Version 1.8b: January 16, 1997 (Eivind Eklund <perhaps@yes.no>)
- Upgraded base PPP version to be the sourcecode from
- Upgraded base PPP version to be the source code from
FreeBSD 2.1.6, with additional security patches. This
version should still be possible to run on 2.1.5, though -
I've run it with a 2.1.5 kernel without problems.
@ -335,10 +335,10 @@ Version 1.9: February 1, 1997 (Eivind Eklund <perhaps@yes.no>)
(cjm)
Version 2.0: March, 1997 (cjm)
- Incoming packets which are not recognized by the packet
- Incoming packets which are not recognised by the packet
aliasing engine are now completely dropped in ip.c.
- Aliasing links are cleared when a host interface address
changes (due to re-dial and dynamic address allocatioa).
changes (due to re-dial and dynamic address allocation).
- PacketAliasPermanentLink() API added.
- Option for only aliasing private, unregistered IP addresses
added.
@ -347,6 +347,6 @@ Version 2.0: March, 1997 (cjm)
Version 2.1: May, 1997 (cjm)
- Continuing rework to the aliasing lookup engine to support
multiple incoming addresses and static NAT.
- Now supports outgoing as well as incoming ICMP error messges/
- Now supports outgoing as well as incoming ICMP error messages/
- PPP commands to support address and port redirection.

4
usr.sbin/ppp/lcp.c
View File

@ -17,7 +17,7 @@
* IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
* WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
*
* $Id: lcp.c,v 1.55.2.54 1998/05/15 23:58:24 brian Exp $
* $Id: lcp.c,v 1.57 1998/05/21 21:46:00 brian Exp $
*
* TODO:
* o Limit data field length by MRU
@ -120,7 +120,7 @@ static const char *cftypes[] = {
"NDE", /* 16: Nominal-Data-Encapsulation */
"MRRU", /* 17: Multilink-MRRU */
"SHORTSEQ", /* 18: Multilink-Short-Sequence-Number-Header */
"ENDDISC", /* 19: Multilink-Endpoint-Descriminator */
"ENDDISC", /* 19: Multilink-Endpoint-Discriminator */
"PROPRIETRY", /* 20: Proprietary */
"DCEID", /* 21: DCE-Identifier */
"MULTIPP", /* 22: Multi-Link-Plus-Procedure */

140
usr.sbin/ppp/ppp.8
View File

@ -1,4 +1,4 @@
.\" $Id: ppp.8,v 1.100 1998/05/21 21:47:48 brian Exp $
.\" $Id: ppp.8,v 1.101 1998/05/21 23:45:10 brian Exp $
.Dd 20 September 1995
.Os FreeBSD
.Dt PPP 8
@ -97,7 +97,7 @@ connections on stdin/stdout.
.It Supports PAP and CHAP authentication.
With PAP or CHAP, it is possible to skip the Unix style
.Xr login 1
proceedure, and use the
procedure, and use the
.Em PPP
protocol for authentication instead. If the peer requests Microsoft
CHAP authentication and
@ -149,7 +149,7 @@ Name Server Addresses and NetBIOS Name Server Addresses can be negotiated
with clients using the Microsoft
.Em PPP
stack (ie. Win95, WinNT)
.It Supports Multilink PPP
.It Supports Multi-link PPP
It is possible to configure
.Nm
to open more than one physical connection to the peer, combining the
@ -266,13 +266,13 @@ signal to
after altering
.Pa /etc/syslog.conf .
.It
Although not strictly relevent to
Although not strictly relevant to
.Nm ppp Ns No s
operation, you should configure your resolver so that it works correctly.
This can be done by configuring a local DNS
.Pq using Xr named 8
or by adding the correct
.Sq nameserver
.Sq name-server
lines to the file
.Pa /etc/resolv.conf .
Refer to the
@ -497,7 +497,7 @@ The literal strings
.Dv MYADDR
and
.Dv INTERFACE
may be used, and will be replaced with the relevent IP addresses and interface
may be used, and will be replaced with the relevant IP addresses and interface
name. Similarly, when a connection is closed, the
contents of the
.Pa /etc/ppp/ppp.linkdown
@ -838,7 +838,7 @@ allowing anybody to establish ppp session with your machine
a password, opening yourself up to all sorts of potential attacks.
.Sh AUTHENTICATING INCOMING CONNECTIONS
Normally, the receiver of a connection requires that the peer
authenticates themself. This may be done using
authenticates itself. This may be done using
.Xr login 1 ,
but alternatively, you can use PAP or CHAP. CHAP is the more secure
of the two, but some clients may not support it. Once you decide which
@ -846,7 +846,7 @@ you wish to use, add the command
.Sq enable chap
or
.Sq enable pap
to the relevent section of
to the relevant section of
.Pa ppp.conf .
.Pp
You must then configure the
@ -861,7 +861,15 @@ The
.Ar name
and
.Ar key
specify the client as expected. If the client does not offer a suitable
specify the client as expected. If
.Ar key
is
.Dq \&*
and PAP is being used,
.Nm
will look up the password database
.Pq Xr passwd 5
when authenticating. If the client does not offer a suitable
response based on any
.Ar name No / Ar key
combination in
@ -884,7 +892,7 @@ This will change the subsequent parsing of the
and
.Pa ppp.linkdown
files.
.Sh PPP OVER TCP (a.k.a Tunneling)
.Sh PPP OVER TCP (a.k.a Tunnelling)
Instead of running
.Nm
over a serial link, it is possible to
@ -1089,7 +1097,7 @@ and
.Op Ar dst_addr Ns Op / Ns Ar width
are the source and destination IP number specifications. If
.Op / Ns Ar width
is specified, it gives the number of relevent netmask bits,
is specified, it gives the number of relevant netmask bits,
allowing the specification of an address range.
.It
.Ar Proto
@ -1615,11 +1623,11 @@ to close any existing server socket, dropping all existing diagnostic
connections.
.El
.Pp
.Sh MULTILINK PPP
.Sh MULTI-LINK PPP
If you wish to use more than one physical link to connect to a
.Em PPP
peer, that peer must also understand the
.Em MULTILINK PPP
.Em MULTI-LINK PPP
protocol. Refer to RFC 1990 for specification details.
.Pp
The peer is identified using a combination of his
@ -1639,12 +1647,12 @@ commands. The
.Pq and Sq authkey
must be agreed in advance with the peer.
.Pp
Multilink capabilities are enabled using the
Multi-link capabilities are enabled using the
.Dq set mrru
command (set maximum reconstructed receive unit). Once multilink
command (set maximum reconstructed receive unit). Once multi-link
is enabled,
.Nm
will attempt to negotiate a multilink connection with the peer.
will attempt to negotiate a multi-link connection with the peer.
.Pp
By default, only one
.Sq link
@ -1690,7 +1698,7 @@ in an operation at the
.Sq bundle
level. For example, once two or more links are available, the command
.Dq show ccp
will show CCP configuration and statistics at the multilink level, and
will show CCP configuration and statistics at the multi-link level, and
.Dq link deflink show ccp
will show the same information at the
.Dq deflink
@ -1753,8 +1761,8 @@ context and which should not have any context.
When
.Nm
has negotiated
.Em MULTILINK
mode with the peer, it creates a unix domain socket in the
.Em MULTI-LINK
mode with the peer, it creates a local domain socket in the
.Pa /var/run
directory. This socket is used to pass link information (including
the actual link file descriptor) between different
@ -1770,7 +1778,7 @@ or directly from
capability), without needing to have initial control of the serial
line. Once
.Nm
negotiates multilink mode, it will pass its open link to any
negotiates multi-link mode, it will pass its open link to any
already running process. If there is no already running process,
.Nm
will act as the master, creating the socket and listening for new
@ -1836,9 +1844,9 @@ Some
.Em PPP
implementations use "MS-CHAP" rather than MD5 when encrypting the
challenge. MS-CHAP is a combination of MD4 and DES. If
.Nm was build
on a machine with DES libraries available, it will respond to MS-CHAP
authentication requests, but will never request them.
.Nm
was built on a machine with DES libraries available, it will respond
to MS-CHAP authentication requests, but will never request them.
.It deflate
Default: Enabled and Accepted. This option decides if deflate
compression will be used by the Compression Control Protocol (CCP).
@ -1864,7 +1872,7 @@ as specified in
Type
.Ar 24
is actually specified as
.Dq PPP Magnalink Variable Resource Compression
.Dq PPP Magna-link Variable Resource Compression
in
.Pa rfc1975 Ns No !
.Nm Ppp
@ -1970,8 +1978,8 @@ Default: Enabled and Accepted. This option determines if
.Nm
will request and accept requests for short
.Pq 12 bit
sequence numbers when negotiating multilink mode. This is only
applicable if our MRRU is set (thus enabling multilink).
sequence numbers when negotiating multi-link mode. This is only
applicable if our MRRU is set (thus enabling multi-link).
.It vjcomp
Default: Enabled and Accepted. This option determines if Van Jacobson
header compression will be used.
@ -2010,14 +2018,18 @@ the interface is also the default route as it avoids the necessity
of a loopback route.
.It passwdauth
Default: Disabled. Enabling this option will tell the PAP authentication
code to use the password file (see
code to use the password database (see
.Xr passwd 5 )
to authenticate the caller rather than the
to authenticate the caller if they cannot be found in the
.Pa /etc/ppp/ppp.secret
file.
.Pa /etc/ppp/ppp.secret
is checked before
.Xr passwd 5 .
is always checked first. If you wish to use passwords from
.Xr passwd 5 ,
but also to specify an IP number or label for a given client, use
.Dq \&*
as the client password in
.Pa /etc/ppp/ppp.secret .
.It proxy
Default: Disabled. Enabling this option will tell
.Nm
@ -2038,15 +2050,15 @@ or
change, this list is re-applied to the routing table.
.Pp
Disabling this option will prevent the re-application of sticky routes,
altough the
although the
.Sq stick route
list will still be maintained.
.It throughput
Default: Enabled. This option tells
.Nm
to gather thoroughput statistics. Input and output is sampled over
to gather throughput statistics. Input and output is sampled over
a rolling 5 second window, and current, best and total figures are
retained. This data is output when the relevent
retained. This data is output when the relevant
.Em PPP
layer shuts down, and is also available using the
.Dq show
@ -2198,7 +2210,7 @@ Possible modes are:
and
.Sq * .
.Pp
When running in multilink mode, a section can be loaded if it allows
When running in multi-link mode, a section can be loaded if it allows
.Em any
of the currently existing line modes.
.El
@ -2268,6 +2280,10 @@ dress. According to RFC 1918, unregistered source addresses
are 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16.
.El
.Pp
These commands are also discussed in the file
.Pa README.alias
which comes with the source distribution.
.Pp
.It [!]bg Ar command
The given
.Ar command
@ -2298,7 +2314,7 @@ If no arguments are given, or if
.Dq lcp
is specified, the link will be closed. If
.Dq ccp
is specified, only the relevent compression layer is closed. If the
is specified, only the relevant compression layer is closed. If the
.Dq \&!
is used, the compression layer will remain in the closed state, otherwise
it will re-enter the STOPPED state, waiting for the peer to initiate
@ -2344,7 +2360,7 @@ scripts for the given
Otherwise, the current settings are used to establish
the connection, and all closed links are brought up.
.It down Op Ar lcp|ccp
Bring the relevent layer down ungracefully, as if the underlying layer
Bring the relevant layer down ungracefully, as if the underlying layer
had become unavailable. It's not considered polite to use this command on
a Finite State Machine that's in the OPEN state. If no arguments are
supplied,
@ -2357,7 +2373,7 @@ is specified, show the usage string for that command.
.It [data]link Ar name[,name...] command Op Ar args
This command may prefix any other command if the user wishes to
specify which link the command should affect. This is only
applicable after multiple links have been created in Multilink
applicable after multiple links have been created in Multi-link
mode using the
.Dq clone
command.
@ -2394,7 +2410,7 @@ argument is the same as using
.Dq dial
in that all closed links are brought up. If the
.Dq ccp
argument is used, the relevent compression layer is opened.
argument is used, the relevant compression layer is opened.
.It passwd Ar pass
Specify the password required for access to the full
.Nm
@ -2427,7 +2443,7 @@ will exit despite the source of the command after closing all existing
connections.
.It remove|rm
This command removes the given link. It is only really useful in
multilink mode. A link must be
multi-link mode. A link must be
in the
.Dv CLOSED
state before it is removed.
@ -2452,7 +2468,7 @@ This option is not (yet) implemented.
This option allows the setting of any of the following variables:
.Bl -tag -width 20
.It set accmap Ar hex-value
ACCMap stands for Asyncronous Control Character Map. This is always
ACCMap stands for Asynchronous Control Character Map. This is always
negotiated with the peer, and defaults to a value of 00000000 in hex.
This protocol is required to defeat hardware that depends on passing
certain characters from end to end (such as XON/XOFF etc).
@ -2472,8 +2488,8 @@ is logged as
for security reasons.
.It set authname Ar id
This sets the authentication id used in client mode PAP or CHAP negotiation.
.It set autoload Ar maxduration maxload [minduration minload]
These settings apply only in multilink mode and all default to zero.
.It set autoload Ar max-duration max-load [min-duration min-load]
These settings apply only in multi-link mode and all default to zero.
When more than one
.Ar demand-dial
.Pq also known as Fl auto
@ -2482,9 +2498,9 @@ mode link is available, only the first link is made active when
first reads data from the tun device. The next
.Ar demand-dial
link will be opened only when at least
.Ar maxload
.Ar max-load
packets have been in the send queue for
.Ar maxduration
.Ar max-duration
seconds. Because both values default to zero,
.Ar demand-dial
links will simply come up one at a time by default.
@ -2494,11 +2510,11 @@ If two or more links are open, at least one of which is a
link, a
.Ar demand-dial
link will be closed when there is less than
.Ar minpackets
.Ar min-packets
in the queue for more than
.Ar minduration .
.Ar min-duration .
If
.Ar minduration
.Ar min-duration
is zero, this timer is disabled. Because both values default to zero,
.Ar demand-dial
links will stay active until the bundle idle timer expires.
@ -2541,12 +2557,12 @@ If
.Dq value
does not begin with
.Pa /dev/ ,
it must either begin with an exclaimation mark
it must either begin with an exclamation mark
.Pq Dq \&!
or be of the format
.Dq host:port .
.Pp
If it begins with an exclaimation mark, the rest of the device name is
If it begins with an exclamation mark, the rest of the device name is
treated as a program name, and that program is executed when the device
is opened. Standard input, output and error are fed back to
.Nm
@ -2629,7 +2645,7 @@ set dial "... ATDT\\\\T CONNECT"
.Pp
It is also possible to execute external commands from the chat script.
To do this, the first character of the expect or send string is an
exclaimation mark
exclamation mark
.Pq Dq \&! .
When the command is executed, standard input and standard output are
directed to the modem device (see the
@ -2709,13 +2725,13 @@ The current label is used.
.It IP
Our local IP number is used. As LCP is negotiated prior to IPCP, it is
possible that the IPCP layer will subsequently change this value. If
it does, the endpoint descriminator stays at the old value unless manually
it does, the endpoint discriminator stays at the old value unless manually
reset.
.It MAC
This is similar to the
.Ar IP
option above, except that the MAC address associated with the local IP
number is used. If the local IP number is not resident on any ethernet
number is used. If the local IP number is not resident on any Ethernet
interface, the command will fail.
.Pp
As the local IP number defaults to whatever the machine host name is,
@ -2850,7 +2866,7 @@ Note that the
.Ar HISADDR
argument may be overridden by the third field in the
.Pa ppp.secret
file once the client has authenticated themself
file once the client has authenticated itself
.Pq if PAP or CHAP are Dq enabled .
Refer to the
.Em AUTHENTICATING INCOMING CONNECTIONS
@ -2893,16 +2909,16 @@ command if you wish to send LQR requests to the peer.
.It set mode Ar interactive|auto|ddial|background
This command allows you to change the
.Sq mode
of the specified link. This is normally only useful in multilink mode,
but may also be used in unilink mode.
of the specified link. This is normally only useful in multi-link mode,
but may also be used in uni-link mode.
.Pp
It is not possible to change a link that is
.Sq direct
or
.Sq dedicated .
.It set mrru Ar value
Setting this option enables Multilink PPP negotiations, also known as
Multilink Protocol or MP. There is no default MRRU (Maximum
Setting this option enables Multi-link PPP negotiations, also known as
Multi-link Protocol or MP. There is no default MRRU (Maximum
Reconstructed Receive Unit) value.
.Em PPP
protocol *must* be able to accept packets of at
@ -3004,11 +3020,11 @@ instructs
.Nm
to close any existing socket.
.Pp
If you wish to specify a unix domain socket,
If you wish to specify a local domain socket,
.Ar LocalName
must be specified as an absolute file name, otherwise it is assumed
to be the name or number of a TCP port. You may specify the octal umask that
should be used with unix domain sockets as a four character octal number
should be used with local domain sockets as a four character octal number
beginning with
.Sq 0 .
Refer to
@ -3023,7 +3039,7 @@ You must also specify the password that must be entered by the client
command above) when connecting to this socket. If the password is
specified as an empty string, no password is required for connecting clients.
.Pp
When specifying a unix domain socket, the first
When specifying a local domain socket, the first
.Dq %d
sequence found in the socket name will be replaced with the current
interface unit number. This is useful when you wish to use the same
@ -3248,7 +3264,7 @@ modes.
.It Pa /etc/services
Get port number if port number is using service name.
.It Pa /var/run/ppp-authname-class-value
In multilink mode, unix domain sockets are created using the peer
In multi-link mode, local domain sockets are created using the peer
authentication name
.Pq Sq authname ,
the peer endpoint discriminator class
@ -3299,4 +3315,4 @@ It was substantially modified during 1997 by Brian Somers
(just after the 2.2 release).
.Pp
Most of the code was rewritten by Brian Somers in early 1998 when
multilink ppp support was added.
multi-link ppp support was added.

140
usr.sbin/ppp/ppp.8.m4
View File

@ -1,4 +1,4 @@
.\" $Id: ppp.8,v 1.100 1998/05/21 21:47:48 brian Exp $
.\" $Id: ppp.8,v 1.101 1998/05/21 23:45:10 brian Exp $
.Dd 20 September 1995
.Os FreeBSD
.Dt PPP 8
@ -97,7 +97,7 @@ connections on stdin/stdout.
.It Supports PAP and CHAP authentication.
With PAP or CHAP, it is possible to skip the Unix style
.Xr login 1
proceedure, and use the
procedure, and use the
.Em PPP
protocol for authentication instead. If the peer requests Microsoft
CHAP authentication and
@ -149,7 +149,7 @@ Name Server Addresses and NetBIOS Name Server Addresses can be negotiated
with clients using the Microsoft
.Em PPP
stack (ie. Win95, WinNT)
.It Supports Multilink PPP
.It Supports Multi-link PPP
It is possible to configure
.Nm
to open more than one physical connection to the peer, combining the
@ -266,13 +266,13 @@ signal to
after altering
.Pa /etc/syslog.conf .
.It
Although not strictly relevent to
Although not strictly relevant to
.Nm ppp Ns No s
operation, you should configure your resolver so that it works correctly.
This can be done by configuring a local DNS
.Pq using Xr named 8
or by adding the correct
.Sq nameserver
.Sq name-server
lines to the file
.Pa /etc/resolv.conf .
Refer to the
@ -497,7 +497,7 @@ The literal strings
.Dv MYADDR
and
.Dv INTERFACE
may be used, and will be replaced with the relevent IP addresses and interface
may be used, and will be replaced with the relevant IP addresses and interface
name. Similarly, when a connection is closed, the
contents of the
.Pa /etc/ppp/ppp.linkdown
@ -838,7 +838,7 @@ allowing anybody to establish ppp session with your machine
a password, opening yourself up to all sorts of potential attacks.
.Sh AUTHENTICATING INCOMING CONNECTIONS
Normally, the receiver of a connection requires that the peer
authenticates themself. This may be done using
authenticates itself. This may be done using
.Xr login 1 ,
but alternatively, you can use PAP or CHAP. CHAP is the more secure
of the two, but some clients may not support it. Once you decide which
@ -846,7 +846,7 @@ you wish to use, add the command
.Sq enable chap
or
.Sq enable pap
to the relevent section of
to the relevant section of
.Pa ppp.conf .
.Pp
You must then configure the
@ -861,7 +861,15 @@ The
.Ar name
and
.Ar key
specify the client as expected. If the client does not offer a suitable
specify the client as expected. If
.Ar key
is
.Dq \&*
and PAP is being used,
.Nm
will look up the password database
.Pq Xr passwd 5
when authenticating. If the client does not offer a suitable
response based on any
.Ar name No / Ar key
combination in
@ -884,7 +892,7 @@ This will change the subsequent parsing of the
and
.Pa ppp.linkdown
files.
.Sh PPP OVER TCP (a.k.a Tunneling)
.Sh PPP OVER TCP (a.k.a Tunnelling)
Instead of running
.Nm
over a serial link, it is possible to
@ -1089,7 +1097,7 @@ and
.Op Ar dst_addr Ns Op / Ns Ar width
are the source and destination IP number specifications. If
.Op / Ns Ar width
is specified, it gives the number of relevent netmask bits,
is specified, it gives the number of relevant netmask bits,
allowing the specification of an address range.
.It
.Ar Proto
@ -1615,11 +1623,11 @@ to close any existing server socket, dropping all existing diagnostic
connections.
.El
.Pp
.Sh MULTILINK PPP
.Sh MULTI-LINK PPP
If you wish to use more than one physical link to connect to a
.Em PPP
peer, that peer must also understand the
.Em MULTILINK PPP
.Em MULTI-LINK PPP
protocol. Refer to RFC 1990 for specification details.
.Pp
The peer is identified using a combination of his
@ -1639,12 +1647,12 @@ commands. The
.Pq and Sq authkey
must be agreed in advance with the peer.
.Pp
Multilink capabilities are enabled using the
Multi-link capabilities are enabled using the
.Dq set mrru
command (set maximum reconstructed receive unit). Once multilink
command (set maximum reconstructed receive unit). Once multi-link
is enabled,
.Nm
will attempt to negotiate a multilink connection with the peer.
will attempt to negotiate a multi-link connection with the peer.
.Pp
By default, only one
.Sq link
@ -1690,7 +1698,7 @@ in an operation at the
.Sq bundle
level. For example, once two or more links are available, the command
.Dq show ccp
will show CCP configuration and statistics at the multilink level, and
will show CCP configuration and statistics at the multi-link level, and
.Dq link deflink show ccp
will show the same information at the
.Dq deflink
@ -1753,8 +1761,8 @@ context and which should not have any context.
When
.Nm
has negotiated
.Em MULTILINK
mode with the peer, it creates a unix domain socket in the
.Em MULTI-LINK
mode with the peer, it creates a local domain socket in the
.Pa /var/run
directory. This socket is used to pass link information (including
the actual link file descriptor) between different
@ -1770,7 +1778,7 @@ or directly from
capability), without needing to have initial control of the serial
line. Once
.Nm
negotiates multilink mode, it will pass its open link to any
negotiates multi-link mode, it will pass its open link to any
already running process. If there is no already running process,
.Nm
will act as the master, creating the socket and listening for new
@ -1836,9 +1844,9 @@ Some
.Em PPP
implementations use "MS-CHAP" rather than MD5 when encrypting the
challenge. MS-CHAP is a combination of MD4 and DES. If
.Nm was build
on a machine with DES libraries available, it will respond to MS-CHAP
authentication requests, but will never request them.
.Nm
was built on a machine with DES libraries available, it will respond
to MS-CHAP authentication requests, but will never request them.
.It deflate
Default: Enabled and Accepted. This option decides if deflate
compression will be used by the Compression Control Protocol (CCP).
@ -1864,7 +1872,7 @@ as specified in
Type
.Ar 24
is actually specified as
.Dq PPP Magnalink Variable Resource Compression
.Dq PPP Magna-link Variable Resource Compression
in
.Pa rfc1975 Ns No !
.Nm Ppp
@ -1970,8 +1978,8 @@ Default: Enabled and Accepted. This option determines if
.Nm
will request and accept requests for short
.Pq 12 bit
sequence numbers when negotiating multilink mode. This is only
applicable if our MRRU is set (thus enabling multilink).
sequence numbers when negotiating multi-link mode. This is only
applicable if our MRRU is set (thus enabling multi-link).
.It vjcomp
Default: Enabled and Accepted. This option determines if Van Jacobson
header compression will be used.
@ -2010,14 +2018,18 @@ the interface is also the default route as it avoids the necessity
of a loopback route.
.It passwdauth
Default: Disabled. Enabling this option will tell the PAP authentication
code to use the password file (see
code to use the password database (see
.Xr passwd 5 )
to authenticate the caller rather than the
to authenticate the caller if they cannot be found in the
.Pa /etc/ppp/ppp.secret
file.
.Pa /etc/ppp/ppp.secret
is checked before
.Xr passwd 5 .
is always checked first. If you wish to use passwords from
.Xr passwd 5 ,
but also to specify an IP number or label for a given client, use
.Dq \&*
as the client password in
.Pa /etc/ppp/ppp.secret .
.It proxy
Default: Disabled. Enabling this option will tell
.Nm
@ -2038,15 +2050,15 @@ or
change, this list is re-applied to the routing table.
.Pp
Disabling this option will prevent the re-application of sticky routes,
altough the
although the
.Sq stick route
list will still be maintained.
.It throughput
Default: Enabled. This option tells
.Nm
to gather thoroughput statistics. Input and output is sampled over
to gather throughput statistics. Input and output is sampled over
a rolling 5 second window, and current, best and total figures are
retained. This data is output when the relevent
retained. This data is output when the relevant
.Em PPP
layer shuts down, and is also available using the
.Dq show
@ -2198,7 +2210,7 @@ Possible modes are:
and
.Sq * .
.Pp
When running in multilink mode, a section can be loaded if it allows
When running in multi-link mode, a section can be loaded if it allows
.Em any
of the currently existing line modes.
.El
@ -2268,6 +2280,10 @@ dress. According to RFC 1918, unregistered source addresses
are 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16.
.El
.Pp
These commands are also discussed in the file
.Pa README.alias
which comes with the source distribution.
.Pp
.It [!]bg Ar command
The given
.Ar command
@ -2298,7 +2314,7 @@ If no arguments are given, or if
.Dq lcp
is specified, the link will be closed. If
.Dq ccp
is specified, only the relevent compression layer is closed. If the
is specified, only the relevant compression layer is closed. If the
.Dq \&!
is used, the compression layer will remain in the closed state, otherwise
it will re-enter the STOPPED state, waiting for the peer to initiate
@ -2344,7 +2360,7 @@ scripts for the given
Otherwise, the current settings are used to establish
the connection, and all closed links are brought up.
.It down Op Ar lcp|ccp
Bring the relevent layer down ungracefully, as if the underlying layer
Bring the relevant layer down ungracefully, as if the underlying layer
had become unavailable. It's not considered polite to use this command on
a Finite State Machine that's in the OPEN state. If no arguments are
supplied,
@ -2357,7 +2373,7 @@ is specified, show the usage string for that command.
.It [data]link Ar name[,name...] command Op Ar args
This command may prefix any other command if the user wishes to
specify which link the command should affect. This is only
applicable after multiple links have been created in Multilink
applicable after multiple links have been created in Multi-link
mode using the
.Dq clone
command.
@ -2394,7 +2410,7 @@ argument is the same as using
.Dq dial
in that all closed links are brought up. If the
.Dq ccp
argument is used, the relevent compression layer is opened.
argument is used, the relevant compression layer is opened.
.It passwd Ar pass
Specify the password required for access to the full
.Nm
@ -2427,7 +2443,7 @@ will exit despite the source of the command after closing all existing
connections.
.It remove|rm
This command removes the given link. It is only really useful in
multilink mode. A link must be
multi-link mode. A link must be
in the
.Dv CLOSED
state before it is removed.
@ -2452,7 +2468,7 @@ This option is not (yet) implemented.
This option allows the setting of any of the following variables:
.Bl -tag -width 20
.It set accmap Ar hex-value
ACCMap stands for Asyncronous Control Character Map. This is always
ACCMap stands for Asynchronous Control Character Map. This is always
negotiated with the peer, and defaults to a value of 00000000 in hex.
This protocol is required to defeat hardware that depends on passing
certain characters from end to end (such as XON/XOFF etc).
@ -2472,8 +2488,8 @@ is logged as
for security reasons.
.It set authname Ar id
This sets the authentication id used in client mode PAP or CHAP negotiation.
.It set autoload Ar maxduration maxload [minduration minload]
These settings apply only in multilink mode and all default to zero.
.It set autoload Ar max-duration max-load [min-duration min-load]
These settings apply only in multi-link mode and all default to zero.
When more than one
.Ar demand-dial
.Pq also known as Fl auto
@ -2482,9 +2498,9 @@ mode link is available, only the first link is made active when
first reads data from the tun device. The next
.Ar demand-dial
link will be opened only when at least
.Ar maxload
.Ar max-load
packets have been in the send queue for
.Ar maxduration
.Ar max-duration
seconds. Because both values default to zero,
.Ar demand-dial
links will simply come up one at a time by default.
@ -2494,11 +2510,11 @@ If two or more links are open, at least one of which is a
link, a
.Ar demand-dial
link will be closed when there is less than
.Ar minpackets
.Ar min-packets
in the queue for more than
.Ar minduration .
.Ar min-duration .
If
.Ar minduration
.Ar min-duration
is zero, this timer is disabled. Because both values default to zero,
.Ar demand-dial
links will stay active until the bundle idle timer expires.
@ -2541,12 +2557,12 @@ If
.Dq value
does not begin with
.Pa /dev/ ,
it must either begin with an exclaimation mark
it must either begin with an exclamation mark
.Pq Dq \&!
or be of the format
.Dq host:port .
.Pp
If it begins with an exclaimation mark, the rest of the device name is
If it begins with an exclamation mark, the rest of the device name is
treated as a program name, and that program is executed when the device
is opened. Standard input, output and error are fed back to
.Nm
@ -2629,7 +2645,7 @@ set dial "... ATDT\\\\T CONNECT"
.Pp
It is also possible to execute external commands from the chat script.
To do this, the first character of the expect or send string is an
exclaimation mark
exclamation mark
.Pq Dq \&! .
When the command is executed, standard input and standard output are
directed to the modem device (see the
@ -2709,13 +2725,13 @@ The current label is used.
.It IP
Our local IP number is used. As LCP is negotiated prior to IPCP, it is
possible that the IPCP layer will subsequently change this value. If
it does, the endpoint descriminator stays at the old value unless manually
it does, the endpoint discriminator stays at the old value unless manually
reset.
.It MAC
This is similar to the
.Ar IP
option above, except that the MAC address associated with the local IP
number is used. If the local IP number is not resident on any ethernet
number is used. If the local IP number is not resident on any Ethernet
interface, the command will fail.
.Pp
As the local IP number defaults to whatever the machine host name is,
@ -2850,7 +2866,7 @@ Note that the
.Ar HISADDR
argument may be overridden by the third field in the
.Pa ppp.secret
file once the client has authenticated themself
file once the client has authenticated itself
.Pq if PAP or CHAP are Dq enabled .
Refer to the
.Em AUTHENTICATING INCOMING CONNECTIONS
@ -2893,16 +2909,16 @@ command if you wish to send LQR requests to the peer.
.It set mode Ar interactive|auto|ddial|background
This command allows you to change the
.Sq mode
of the specified link. This is normally only useful in multilink mode,
but may also be used in unilink mode.
of the specified link. This is normally only useful in multi-link mode,
but may also be used in uni-link mode.
.Pp
It is not possible to change a link that is
.Sq direct
or
.Sq dedicated .
.It set mrru Ar value
Setting this option enables Multilink PPP negotiations, also known as
Multilink Protocol or MP. There is no default MRRU (Maximum
Setting this option enables Multi-link PPP negotiations, also known as
Multi-link Protocol or MP. There is no default MRRU (Maximum
Reconstructed Receive Unit) value.
.Em PPP
protocol *must* be able to accept packets of at
@ -3004,11 +3020,11 @@ instructs
.Nm
to close any existing socket.
.Pp
If you wish to specify a unix domain socket,
If you wish to specify a local domain socket,
.Ar LocalName
must be specified as an absolute file name, otherwise it is assumed
to be the name or number of a TCP port. You may specify the octal umask that
should be used with unix domain sockets as a four character octal number
should be used with local domain sockets as a four character octal number
beginning with
.Sq 0 .
Refer to
@ -3023,7 +3039,7 @@ You must also specify the password that must be entered by the client
command above) when connecting to this socket. If the password is
specified as an empty string, no password is required for connecting clients.
.Pp
When specifying a unix domain socket, the first
When specifying a local domain socket, the first
.Dq %d
sequence found in the socket name will be replaced with the current
interface unit number. This is useful when you wish to use the same
@ -3248,7 +3264,7 @@ modes.
.It Pa /etc/services
Get port number if port number is using service name.
.It Pa /var/run/ppp-authname-class-value
In multilink mode, unix domain sockets are created using the peer
In multi-link mode, local domain sockets are created using the peer
authentication name
.Pq Sq authname ,
the peer endpoint discriminator class
@ -3299,4 +3315,4 @@ It was substantially modified during 1997 by Brian Somers
(just after the 2.2 release).
.Pp
Most of the code was rewritten by Brian Somers in early 1998 when
multilink ppp support was added.
multi-link ppp support was added.