d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
509a8ff67a
freebsd-skq/usr.sbin/ppp/ppp.8

6093 lines
149 KiB
Groff
Raw Normal View History

Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
.\"
.\" Copyright (c) 2001 Brian Somers <brian@Awfulhak.org>
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
$Id$ -> $FreeBSD$
1999-08-28 01:35:59 +00:00
.\" $FreeBSD$
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
.\"
Document that ppp handles pipe(2) descriptors specially in -direct mode. MFC after: 3 days
2009-08-25 07:52:09 +00:00
.Dd August 25, 2009
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Dt PPP 8
Index: ppp.8 =================================================================== RCS file: /home/ncvs/src/usr.sbin/ppp/ppp.8,v retrieving revision 1.233 diff -u -r1.233 ppp.8 --- ppp.8 2000/08/10 13:26:01 1.233 +++ ppp.8 2000/08/12 19:50:41 @@ -1,8 +1,8 @@ .\" $FreeBSD: src/usr.sbin/ppp/ppp.8,v 1.233 2000/08/10 13:26:01 brian Exp $ .Dd 20 September 1995 .nr XX \w'\fC00' -.Os FreeBSD .Dt PPP 8 +.Os .Sh NAME .Nm ppp .Nd Point to Point Protocol (a.k.a. user-ppp)
2000-08-13 22:03:42 +00:00
.Os
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh NAME
.Nm ppp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
.Nd Point to Point Protocol (a.k.a. user-ppp)
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh SYNOPSIS
.Nm
Add the -unit command line switch for specifying the tun device. Warn about -alias being depricated (but still allow it). Don't moan twice about failing to open any tun device. Fix a diagnostic and add the -quiet switch to the usage message.
1999-10-19 15:21:09 +00:00
.Op Fl Va mode
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Op Fl nat
.Op Fl quiet
Add the -unit command line switch for specifying the tun device. Warn about -alias being depricated (but still allow it). Don't moan twice about failing to open any tun device. Fix a diagnostic and add the -quiet switch to the usage message.
1999-10-19 15:21:09 +00:00
.Op Fl unit Ns Ar N
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op Ar system ...
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh DESCRIPTION
This is a user process
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
software package.
Don't refer to pppd(8).
2009-12-28 09:37:33 +00:00
Sometimes,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Em PPP
e.g. -> e.g., Obtained from: OpenBSD
2000-06-23 09:48:02 +00:00
is implemented as a part of the kernel (e.g., as managed by
Don't refer to pppd(8).
2009-12-28 09:37:33 +00:00
.Nm pppd )
Expand contractions.
2005-02-13 23:45:54 +00:00
and it is thus somewhat hard to debug and/or modify its behaviour.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
However, in this implementation
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Em PPP
is done as a user process with the help of the
A few more typos fixed and some general cleanup done.
1995-05-24 05:51:29 +00:00
tunnel device driver (tun).
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Pp
The
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Fl nat
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
flag does the equivalent of a
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Dq nat enable yes ,
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
enabling
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
network address translation features.
This allows
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to act as a NAT or masquerading engine for all machines on an internal
LAN.
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
Refer to
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Xr libalias 3
Cross reference the NETWORK ADDRESS TRANSLATION section when describing the -nat flag. Requested by: eivind
2002-01-23 21:11:33 +00:00
for details on the technical side of the NAT engine.
Refer to the
.Sx NETWORK ADDRESS TRANSLATION (PACKET ALIASING)
section of this manual page for details on how to configure NAT in
.Nm .
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Pp
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
The
.Fl quiet
flag tells
.Nm
to be silent at startup rather than displaying the mode and interface
to standard output.
.Pp
Add the -unit command line switch for specifying the tun device. Warn about -alias being depricated (but still allow it). Don't moan twice about failing to open any tun device. Fix a diagnostic and add the -quiet switch to the usage message.
1999-10-19 15:21:09 +00:00
The
.Fl unit
flag tells
.Nm
to only attempt to open
.Pa /dev/tun Ns Ar N .
Normally,
.Nm
will start with a value of 0 for
.Ar N ,
and keep trying to open a tunnel device by incrementing the value of
.Ar N
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
by one each time until it succeeds.
If it fails three times in a row
Add the -unit command line switch for specifying the tun device. Warn about -alias being depricated (but still allow it). Don't moan twice about failing to open any tun device. Fix a diagnostic and add the -quiet switch to the usage message.
1999-10-19 15:21:09 +00:00
because the device file is missing, it gives up.
.Pp
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
The following
.Va mode Ns No s
are understood by
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm :
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Bl -tag -width XXX -offset XXX
.It Fl auto
.Nm
opens the tun interface, configures it then goes into the background.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
The link is not brought up until outgoing data is detected on the tun
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
interface at which point
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
attempts to bring up the link.
Packets received (including the first one) while
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Nm
is trying to bring the link up will remain queued for a default of
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
2 minutes.
See the
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Dq set choked
command below.
.Pp
In
.Fl auto
mode, at least one
.Dq system
must be given on the command line (see below) and a
.Dq set ifaddr
must be done in the system profile that specifies a peer IP address to
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
use when configuring the interface.
Something like
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Dq 10.0.0.1/0
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is usually appropriate.
See the
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Dq pmdemand
system in
.Pa /usr/share/examples/ppp/ppp.conf.sample
for an example.
.It Fl background
Here,
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
attempts to establish a connection with the peer immediately.
If it succeeds,
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Nm
goes into the background and the parent process returns an exit code
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
of 0.
If it fails,
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Nm
exits with a non-zero result.
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It Fl foreground
In foreground mode,
.Nm
attempts to establish a connection with the peer immediately, but never
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
becomes a daemon.
The link is created in background mode.
This is useful if you wish to control
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
invocation from another process.
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.It Fl direct
Add a ``force-scripts'' option for using chat scripts with -direct and -dedicated links. Submitted by: Maksim Yevmenkin <myevmenk@exodus.net>
2003-03-26 02:03:08 +00:00
This is used for communicating over an already established connection,
usually when receiving incoming connections accepted by
.Xr getty 8 .
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Nm
ignores the
.Dq set device
line and uses descriptor 0 as the link.
Add a ``force-scripts'' option for using chat scripts with -direct and -dedicated links. Submitted by: Maksim Yevmenkin <myevmenk@exodus.net>
2003-03-26 02:03:08 +00:00
.Nm
will also ignore any configured chat scripts unless the
.Dq force-scripts
option has been enabled.
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Pp
If callback is configured,
.Nm
will use the
.Dq set device
information when dialing back.
Document that ppp handles pipe(2) descriptors specially in -direct mode. MFC after: 3 days
2009-08-25 07:52:09 +00:00
.Pp
When run in
.Fl direct
mode,
.Nm
will behave slightly differently if descriptor 0 was created by
.Xr pipe 2 .
As pipes are not bi-directional, ppp will redirect all writes to descriptor
1 (standard output), leaving only reads acting on descriptor 0.
No special action is taken if descriptor 0 was created by
.Xr socketpair 2 .
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.It Fl dedicated
This option is designed for machines connected with a dedicated
wire.
.Nm
Add a ``force-scripts'' option for using chat scripts with -direct and -dedicated links. Submitted by: Maksim Yevmenkin <myevmenk@exodus.net>
2003-03-26 02:03:08 +00:00
will always keep the device open and will ignore any configured
chat scripts unless the
.Dq force-scripts
Erase whitespace at EOL. Approved by: re (blanket)
2003-05-22 11:56:41 +00:00
option has been enabled.
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.It Fl ddial
This mode is equivalent to
.Fl auto
mode except that
.Nm
Expand contractions.
2005-02-13 23:45:54 +00:00
will bring the link back up any time it is dropped for any reason.
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.It Fl interactive
This is a no-op, and gives the same behaviour as if none of the above
modes have been specified.
.Nm
loads any sections specified on the command line then provides an
interactive prompt.
.El
.Pp
One or more configuration entries or systems
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(as specified in
.Pa /etc/ppp/ppp.conf )
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
may also be specified on the command line.
.Nm
will read the
.Dq default
system from
.Pa /etc/ppp/ppp.conf
at startup, followed by each of the systems specified on the command line.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh Major Features
.Bl -diag
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.It Provides an interactive user interface.
Do my best to translate this into english.. :-) Some parts were so incomprehensible that I had to excise them entirely, but I did my best with the material provided.
1995-05-21 17:32:35 +00:00
Using its command mode, the user can
easily enter commands to establish the connection with the remote end, check
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
the status of connection and close the connection.
All functions can also be optionally password protected for security.
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
.It Supports both manual and automatic dialing.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
Interactive mode has a
.Dq term
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command which enables you to talk to the device directly.
When you are connected to the remote peer and it starts to talk
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Em PPP ,
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
detects it and switches to packet mode automatically.
Once you have
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
determined the proper sequence for connecting with the remote host, you
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
can write a chat script to {define} the necessary dialing and login
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
procedure for later convenience.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It Supports on-demand dialup capability.
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
By using
.Fl auto
mode,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
will act as a daemon and wait for a packet to be sent over the
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
link.
When this happens, the daemon automatically dials and establishes the
New user Process PPP based on iij-ppp0.94beta2. o Supporting SYNC SIO device (But need a device driver) - add "set speed sync" o Fixing bug for Predictor-1 function. o Add new parameter that re-sent interval for set timeout commands. o Improving RTT (Round Trip Time) and reducing processor time. - Previous Timer service was using polling, and now using SIGALRM ;-) - A 0.94beta2 will not work correctly.... -- Follows are additinal feature not including 0.94beta2 o Support Proxy ARP - add "enable/disable proxy" commands o Marging common routine in CHAP/PAP. o Enhancing LCP/IPCP log information. o Support local Authfication connection on port 300x and tty. - You can set up pair of your "hostname -s" and password in ppp.secret. if either ppp.secret file nor your hostname line don't exist, It will notify a message and working as same as previous version.(Backword compatibility) - If you did set up them, It's allow connection but nothing to do except help and passwd command. - add "passwd yourpasswd" commands o Support afilter - keep Alive filter that a packet can send/receiving according to ifilter/ofilter but doesn't count it as preventing idle timer expires. - Same syntax of other filters. o Fixing bugs reported by current user for previous one. Thanks !! Reviewed by: Atsushi Murai (amurai@spec.co.jp)
1995-02-26 12:18:08 +00:00
connection.
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
In almost the same manner
.Fl ddial
mode (direct-dial mode) also automatically dials and establishes the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
connection.
However, it differs in that it will dial the remote site
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
any time it detects the link is down, even if there are no packets to be
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
sent.
This mode is useful for full-time connections where we worry less
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
about line charges and more about being connected full time.
A third
.Fl dedicated
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
mode is also available.
This mode is targeted at a dedicated link between two machines.
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
will never voluntarily quit from dedicated mode - you must send it the
.Dq quit all
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command via its diagnostic socket.
A
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Dv SIGHUP
will force an LCP renegotiation, and a
.Dv SIGTERM
will force it to exit.
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.It Supports client callback.
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
can use either the standard LCP callback protocol or the Microsoft
CallBack Control Protocol (ftp://ftp.microsoft.com/developr/rfc/cbcp.txt).
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.It Supports NAT or packet aliasing.
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
Packet aliasing (a.k.a.\& IP masquerading) allows computers on a
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
private, unregistered network to access the Internet.
The
The infamous IP aliasing code for ppp, modified to work as a runtime option (otherwise ppp's behavior remains unchanged) and documented by myself, Steve Sims, Nate Williams, Martin Renters and god-only-knows who else. :-) Submitted by: nate Obtained from: Charles Mott <cmott@srv.net>
1996-12-12 14:39:47 +00:00
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
host acts as a masquerading gateway.
IP addresses as well as TCP and
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
UDP port numbers are NAT'd for outgoing packets and de-NAT'd for
The infamous IP aliasing code for ppp, modified to work as a runtime option (otherwise ppp's behavior remains unchanged) and documented by myself, Steve Sims, Nate Williams, Martin Renters and god-only-knows who else. :-) Submitted by: nate Obtained from: Charles Mott <cmott@srv.net>
1996-12-12 14:39:47 +00:00
returning packets.
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
.It Supports background PPP connections.
In background mode, if
.Nm
successfully establishes the connection, it will become a daemon.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Otherwise, it will exit with an error.
This allows the setup of
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
scripts that wish to execute certain commands only if the connection
is successfully established.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It Supports server-side PPP connections.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
In direct mode,
Typo and formatting updates. PR: docs/8504 Approved by: Brian Somers Submitted by: Kazuo Horikawa <horikawa@jp.FreeBSD.org>
1998-12-04 19:39:05 +00:00
.Nm
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
acts as server which accepts incoming
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Em PPP
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
connections on stdin/stdout.
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It Supports PAP and CHAP (rfc 1994, 2433 and 2759) authentication.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
With PAP or CHAP, it is possible to skip the Unix style
.Xr login 1
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
procedure, and use the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
protocol for authentication instead.
If the peer requests Microsoft CHAP authentication and
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
is compiled with DES support, an appropriate MD4/DES response will be
made.
Mention our support of the authentication side of rfc2548
2002-05-21 10:54:07 +00:00
.It Supports RADIUS (rfc 2138 & 2548) authentication.
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
An extension to PAP and CHAP,
.Em \&R Ns No emote
.Em \&A Ns No ccess
.Em \&D Ns No ial
.Em \&I Ns No n
.Em \&U Ns No ser
.Em \&S Ns No ervice
allows authentication information to be stored in a central or
distributed database along with various per-user framed connection
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
characteristics.
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
If
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
.Xr libradius 3
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
is available at compile time,
.Nm
will use it to make
.Em RADIUS
requests when configured to do so.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It Supports Proxy Arp.
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.Nm
Correct some ntohl/htonl bogons in the netmask handling. This was pretty harmless as netmasks on a POINTOPOINT interface are pretty much ignored, but it looked funny. Mention the configured netmask in ``show ipcp''. Describe in more detail what a proxy arp entry is.
1999-03-03 23:00:41 +00:00
can be configured to make one or more proxy arp entries on behalf of
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
the peer.
This allows routing from the peer to the LAN without
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
configuring each machine on that LAN.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It Supports packet filtering.
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
User can {define} four kinds of filters: the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em in
filter for incoming packets, the
.Em out
filter for outgoing packets, the
.Em dial
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
filter to {define} a dialing trigger packet and the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em alive
filter for keeping a connection alive with the trigger packet.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It Tunnel driver supports bpf.
The user can use
.Xr tcpdump 1
to check the packet flow over the
.Em PPP
link.
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.It Supports PPP over TCP and PPP over UDP.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
If a device name is specified as
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Em host Ns No : Ns Em port Ns
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.Xo
.Op / Ns tcp|udp ,
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
will open a TCP or UDP connection for transporting data rather than using a
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
conventional serial device.
UDP connections force
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Nm
into synchronous mode.
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.It Supports PPP over Ethernet (rfc 2516).
If
.Nm
is given a device specification of the format
.No PPPoE: Ns Ar iface Ns Xo
.Op \&: Ns Ar provider Ns
.Xc
and if
.Xr netgraph 4
is available,
.Nm
will attempt talk
.Em PPP
over Ethernet to
.Ar provider
using the
.Ar iface
network interface.
Talk a little more about the differences between PPPoE on FreeBSD & OpenBSD.
2001-03-09 00:12:09 +00:00
.Pp
On systems that do not support
.Xr netgraph 4 ,
an external program such as
Xref the proper manual pages. PR: 60999 Submitted by: Marc Silver <marcs@draenor.org>
2004-01-12 16:10:38 +00:00
.Xr pppoed 8
Talk a little more about the differences between PPPoE on FreeBSD & OpenBSD.
2001-03-09 00:12:09 +00:00
may be used.
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.It "Supports IETF draft Predictor-1 (rfc 1978) and DEFLATE (rfc 1979) compression."
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
supports not only VJ-compression but also Predictor-1 and DEFLATE compression.
e.g. -> e.g., Obtained from: OpenBSD
2000-06-23 09:48:02 +00:00
Normally, a modem has built-in compression (e.g., v42.bis) and the system
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
may receive higher data rates from it as a result of such compression.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
While this is generally a good thing in most other situations, this
higher speed data imposes a penalty on the system by increasing the
number of serial interrupts the system has to process in talking to the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
modem and also increases latency.
Unlike VJ-compression, Predictor-1 and DEFLATE compression pre-compresses
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Em all
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
network traffic flowing through the link, thus reducing overheads to a
minimum.
Mention which rfc the DNS/NBNS IPCP extensions come from.
1999-07-29 14:37:26 +00:00
.It Supports Microsoft's IPCP extensions (rfc 1877).
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
Name Server Addresses and NetBIOS Name Server Addresses can be negotiated
with clients using the Microsoft
.Em PPP
Fix some typos Obtained from: OpenBSD
2000-03-14 01:47:13 +00:00
stack (i.e., Win95, WinNT)
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.It Supports Multi-link PPP (rfc 1990)
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
It is possible to configure
.Nm
to open more than one physical connection to the peer, combining the
bandwidth of all links for better throughput.
Add MPPE and MSChap v2 support (denied and disabled by default) Submitted by: Ustimenko Semen <semen@iclub.nsu.ru>
2000-10-30 00:15:04 +00:00
.It Supports MPPE (draft-ietf-pppext-mppe)
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
MPPE is Microsoft Point to Point Encryption scheme.
It is possible to configure
Add MPPE and MSChap v2 support (denied and disabled by default) Submitted by: Ustimenko Semen <semen@iclub.nsu.ru>
2000-10-30 00:15:04 +00:00
.Nm
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
to participate in Microsoft's Windows VPN.
Remove whitespace at EOL.
2001-07-15 08:06:20 +00:00
For now,
Add MPPE and MSChap v2 support (denied and disabled by default) Submitted by: Ustimenko Semen <semen@iclub.nsu.ru>
2000-10-30 00:15:04 +00:00
.Nm
can only get encryption keys from CHAP 81 authentication.
.Nm
must be compiled with DES for MPPE to operate.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It Supports IPV6CP (rfc 2023).
An IPv6 connection can be made in addition to or instead of the normal
IPv4 connection.
Add missing .El
1998-08-09 17:17:23 +00:00
.El
Install as group ``network'' Insist that uid == 0 for client ppp Disallow client sockets if no password is specified Don't exit on failure to open client socket for listening Allow specification of null local password Use reasonable size (smaller) ``vector''s in auth.c Fix "passwd ..." usage message Insist on "all" as arg to "quit" (if any) Drop client socket connection before Cleanup() when "quit all"
1997-09-04 00:38:22 +00:00
.Sh PERMISSIONS
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Install as group ``network'' Insist that uid == 0 for client ppp Disallow client sockets if no password is specified Don't exit on failure to open client socket for listening Allow specification of null local password Use reasonable size (smaller) ``vector''s in auth.c Fix "passwd ..." usage message Insist on "all" as arg to "quit" (if any) Drop client socket connection before Cleanup() when "quit all"
1997-09-04 00:38:22 +00:00
is installed as user
.Dv root
and group
.Dv network ,
with permissions
Add leading 0 in front of octal file permissions number. OK'ed by: Brian Somers <brian@freebsd.org> PR: docs/9843
1999-03-07 20:27:45 +00:00
.Dv 04554 .
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
By default,
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will not run if the invoking user id is not zero.
This may be overridden by using the
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Dq allow users
command in
.Pa /etc/ppp/ppp.conf .
Install as group ``network'' Insist that uid == 0 for client ppp Disallow client sockets if no password is specified Don't exit on failure to open client socket for listening Allow specification of null local password Use reasonable size (smaller) ``vector''s in auth.c Fix "passwd ..." usage message Insist on "all" as arg to "quit" (if any) Drop client socket connection before Cleanup() when "quit all"
1997-09-04 00:38:22 +00:00
When running as a normal user,
.Nm
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
switches to user id 0 in order to alter the system routing table, set up
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
system lock files and read the ppp configuration files.
All external commands (executed via the "shell" or "!bg" commands) are executed
Install as group ``network'' Insist that uid == 0 for client ppp Disallow client sockets if no password is specified Don't exit on failure to open client socket for listening Allow specification of null local password Use reasonable size (smaller) ``vector''s in auth.c Fix "passwd ..." usage message Insist on "all" as arg to "quit" (if any) Drop client socket connection before Cleanup() when "quit all"
1997-09-04 00:38:22 +00:00
as the user id that invoked
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
Refer to the
.Sq ID0
Expand contractions.
2005-02-13 23:45:54 +00:00
logging facility if you are interested in what exactly is done as user id
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
zero.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh GETTING STARTED
When you first run
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
you may need to deal with some initial configuration details.
.Bl -bullet
.It
Make sure that your system has a group named
.Dq network
in the
.Pa /etc/group
Fix some typos Obtained from: OpenBSD
2000-03-14 01:47:13 +00:00
file and that the group contains the names of all users expected to use
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Refer to the
.Xr group 5
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
manual page for details.
Each of these users must also be given access using the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq allow users
command in
.Pa /etc/ppp/ppp.conf .
.It
Create a log file.
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
uses
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Xr syslog 3
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to log information.
A common log file name is
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Pa /var/log/ppp.log .
To make output go to this file, put the following lines in the
.Pa /etc/syslog.conf
file:
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Bd -literal -offset indent
!ppp
*.*<TAB>/var/log/ppp.log
.Ed
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
It is possible to have more than one
.Em PPP
log file by creating a link to the
.Nm
executable:
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dl # cd /usr/sbin
.Dl # ln ppp ppp0
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
and using
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Bd -literal -offset indent
!ppp0
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
*.*<TAB>/var/log/ppp0.log
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Ed
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
in
.Pa /etc/syslog.conf .
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
Do not forget to send a
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dv HUP
signal to
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr syslogd 8
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
after altering
.Pa /etc/syslog.conf .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
Although not strictly relevant to
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
operation, you should configure your resolver so that it works correctly.
This can be done by configuring a local DNS
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(using
.Xr named 8 )
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or by adding the correct
Fix resolv.conf line hint: "name-server" -> "nameserver"
2000-08-31 11:13:20 +00:00
.Sq nameserver
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
lines to the file
.Pa /etc/resolv.conf .
Refer to the
.Xr resolv.conf 5
manual page for details.
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Alternatively, if the peer supports it,
.Nm
can be configured to ask the peer for the nameserver address(es) and to
update
.Pa /etc/resolv.conf
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
automatically.
Refer to the
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Dq enable dns
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
and
.Dq resolv
commands below for details.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.El
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Sh MANUAL DIALING
In the following examples, we assume that your machine name is
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Dv awfulhak .
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
when you invoke
.Nm
(see
Use ``Sx'' when xref'ing sections.
1999-03-18 21:53:56 +00:00
.Sx PERMISSIONS
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
above) with no arguments, you are presented with a prompt:
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
ppp ON awfulhak>
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
The
.Sq ON
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
part of your prompt should always be in upper case.
If it is in lower case, it means that you must supply a password using the
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Dq passwd
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
This only ever happens if you connect to a running version of
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Nm
and have not authenticated yourself using the correct password.
.Pp
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
You can start by specifying the device name and speed:
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
ppp ON awfulhak> set device /dev/cuau0
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
ppp ON awfulhak> set speed 38400
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Ed
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Normally, hardware flow control (CTS/RTS) is used.
However, under
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
certain circumstances (as may happen when you are connected directly
to certain PPP-capable terminal servers), this may result in
.Nm
hanging as soon as it tries to write data to your communications link
as it is waiting for the CTS (clear to send) signal - which will never
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
come.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
Thus, if you have a direct line and cannot seem to make a
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
connection, try turning CTS/RTS off with
.Dq set ctsrts off .
If you need to do this, check the
.Dq set accmap
Expand contractions.
2005-02-13 23:45:54 +00:00
description below too - you will probably need to
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Dq set accmap 000a0000 .
.Pp
Usually, parity is set to
.Dq none ,
and this is
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
default.
Parity is a rather archaic error checking mechanism that is no
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
longer used because modern modems do their own error checking, and most
Expand contractions.
2005-02-13 23:45:54 +00:00
link-layer protocols (that is what
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is) use much more reliable checking mechanisms.
Parity has a relatively
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
huge overhead (a 12.5% increase in traffic) and as a result, it is always
disabled
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(set to
.Dq none )
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
when
.Dv PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is opened.
However, some ISPs (Internet Service Providers) may use
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
specific parity settings at connection time (before
.Dv PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is opened).
Notably, Compuserve insist on even parity when logging in:
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Bd -literal -offset indent
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
ppp ON awfulhak> set parity even
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Ed
.Pp
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
You can now see what your current device settings look like:
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Bd -literal -offset indent
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
ppp ON awfulhak> show physical
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
Name: deflink
State: closed
Device: N/A
Link Type: interactive
Connect Count: 0
Queued Packets: 0
Phone Number: N/A
Defaults:
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
Device List: /dev/cuau0
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
Characteristics: 38400bps, cs8, even parity, CTS/RTS on
Connect time: 0 secs
0 octets in, 0 octets out
Overall 0 bytes/sec
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
ppp ON awfulhak>
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
The term command can now be used to talk directly to the device:
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
ppp ON awfulhak> term
at
OK
atdt123456
CONNECT
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
login: myispusername
Password: myisppassword
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
Protocol: ppp
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
When the peer starts to talk in
.Em PPP ,
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
detects this automatically and returns to command mode.
.Bd -literal -offset indent
Explain what the command line switches do and what the various prompts signify.
1998-11-08 13:06:19 +00:00
ppp ON awfulhak> # No link has been established
Ppp ON awfulhak> # We've connected & finished LCP
PPp ON awfulhak> # We've authenticated
PPP ON awfulhak> # We've agreed IP numbers
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Expand contractions.
2005-02-13 23:45:54 +00:00
If it does not, it is probable that the peer is waiting for your end to
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
start negotiating.
To force
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Explain what the command line switches do and what the various prompts signify.
1998-11-08 13:06:19 +00:00
to start sending
.Em PPP
configuration packets to the peer, use the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq ~p
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
command to drop out of terminal mode and enter packet mode.
.Pp
If you never even receive a login prompt, it is quite likely that the
peer wants to use PAP or CHAP authentication instead of using Unix-style
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
login/password authentication.
To set things up properly, drop back to
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
the prompt and set your authentication name and key, then reconnect:
.Bd -literal -offset indent
~.
ppp ON awfulhak> set authname myispusername
ppp ON awfulhak> set authkey myisppassword
ppp ON awfulhak> term
at
OK
atdt123456
CONNECT
.Ed
.Pp
You may need to tell ppp to initiate negotiations with the peer here too:
.Bd -literal -offset indent
~p
ppp ON awfulhak> # No link has been established
Ppp ON awfulhak> # We've connected & finished LCP
PPp ON awfulhak> # We've authenticated
PPP ON awfulhak> # We've agreed IP numbers
.Ed
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
You are now connected!
Note that
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sq PPP
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
in the prompt has changed to capital letters to indicate that you have
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
a peer connection.
If only some of the three Ps go uppercase, wait until
either everything is uppercase or lowercase.
If they revert to lowercase, it means that
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
could not successfully negotiate with the peer.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
A good first step for troubleshooting at this point would be to
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Bd -literal -offset indent
ppp ON awfulhak> set log local phase lcp ipcp
.Ed
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
and try again.
Refer to the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set log
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command description below for further details.
If things fail at this point,
it is quite important that you turn logging on and try again.
It is also
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
important that you note any prompt changes and report them to anyone trying
to help you.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
When the link is established, the show command can be used to see how
things are going:
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
PPP ON awfulhak> show physical
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
* Modem related information is shown here *
PPP ON awfulhak> show ccp
* CCP (compression) related information is shown here *
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
PPP ON awfulhak> show lcp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
* LCP (line control) related information is shown here *
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
PPP ON awfulhak> show ipcp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
* IPCP (IP) related information is shown here *
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
PPP ON awfulhak> show ipv6cp
* IPV6CP (IPv6) related information is shown here *
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
PPP ON awfulhak> show link
* Link (high level) related information is shown here *
PPP ON awfulhak> show bundle
* Logical (high level) connection related information is shown here *
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
At this point, your machine has a host route to the peer.
This means
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
that you can only make a connection with the host on the other side
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
of the link.
If you want to add a default route entry (telling your
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
machine to send all packets without another routing entry to the other
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
side of the
.Em PPP
link), enter the following command:
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
Make it clear that using "add ...." in ppp.conf when not in -auto mode isn't a good idea, and that the add should be done in ppp.linkup instead. Change "add 0 0 HISADDR" to "add default HISADDR". It's more intuitive.
1998-01-04 21:28:49 +00:00
PPP ON awfulhak> add default HISADDR
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
The string
.Sq HISADDR
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
represents the IP address of the connected peer.
If the
.Dq add
command fails due to an existing route, you can overwrite the existing
2 small typos.
2004-04-04 19:30:07 +00:00
route using:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Bd -literal -offset indent
PPP ON awfulhak> add! default HISADDR
.Ed
.Pp
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
This command can also be executed before actually making the connection.
If a new IP address is negotiated at connection time,
.Nm
will update your default route accordingly.
.Pp
2 small typos.
2004-04-04 19:30:07 +00:00
You can now use your network applications (ping, telnet, ftp, etc.)
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
in other windows or terminals on your machine.
If you wish to reuse the current terminal, you can put
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
into the background using your standard shell suspend and background
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
commands (usually
.Dq ^Z
followed by
.Dq bg ) .
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Refer to the
Use ``Sx'' when xref'ing sections.
1999-03-18 21:53:56 +00:00
.Sx PPP COMMAND LIST
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
section for details on all available commands.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh AUTOMATIC DIALING
Do my best to translate this into english.. :-) Some parts were so incomprehensible that I had to excise them entirely, but I did my best with the material provided.
1995-05-21 17:32:35 +00:00
To use automatic dialing, you must prepare some Dial and Login chat scripts.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
See the example definitions in
/etc/ppp/ppp.*.sample -> /usr/share/examples/ppp/ppp.*.sample
1999-02-11 16:34:15 +00:00
.Pa /usr/share/examples/ppp/ppp.conf.sample
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
(the format of
.Pa /etc/ppp/ppp.conf
is pretty simple).
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
Each line contains one comment, inclusion, label or command:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Bl -bullet
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
A line starting with a
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
.Pq Dq #
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
character is treated as a comment line.
Leading whitespace are ignored when identifying comment lines.
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
.It
An inclusion is a line beginning with the word
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
.Sq {!include} .
It must have one argument - the file to {include}.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
You may wish to
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
.Dq {!include} ~/.ppp.conf
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
for compatibility with older versions of
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
A label name starts in the first column and is followed by
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
a colon
.Pq Dq \&: .
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Do my best to translate this into english.. :-) Some parts were so incomprehensible that I had to excise them entirely, but I did my best with the material provided.
1995-05-21 17:32:35 +00:00
A command line must contain a space or tab in the first column.
Describe the special meaning of the $ and ~ characters, and the fact that you can get around it by double-quoting them. PR: 42762 Submitted by: AIDA Shinra <aida-s@jcom.home.ne.jp> Discussed with: brian
2004-12-16 16:59:19 +00:00
.It
A string starting with the
.Dq $
character is substituted with the value of the environment variable by
the same name.
Likewise, a string starting with the
.Dq ~
character is substituted with the full path to the home directory of
the user account by the same name, and the
.Dq ~
character by itself is substituted with the full path to the home directory
of the current user.
If you want to include a literal
.Dq $
or
.Dq ~
Scheduled mdoc(7) sweep.
2005-01-11 11:47:22 +00:00
character in a command or argument, enclose them in double quotes, e.g.,
Describe the special meaning of the $ and ~ characters, and the fact that you can get around it by double-quoting them. PR: 42762 Submitted by: AIDA Shinra <aida-s@jcom.home.ne.jp> Discussed with: brian
2004-12-16 16:59:19 +00:00
.Bd -literal -offset indent
set password "pa$ss~word"
.Ed
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
The
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
file should consist of at least a
.Dq default
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
section.
This section is always executed.
It should also contain
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
one or more sections, named according to their purpose, for example,
.Dq MyISP
would represent your ISP, and
.Dq ppp-in
would represent an incoming
.Nm
configuration.
You can now specify the destination label name when you invoke
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
Commands associated with the
.Dq default
label are executed, followed by those associated with the destination
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
label provided.
When
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
is started with no arguments, the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Dq default
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
section is still executed.
The load command can be used to manually load a section from the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
file:
.Bd -literal -offset indent
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
ppp ON awfulhak> load MyISP
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
Note, no action is taken by
.Nm
Expand contractions.
2005-02-13 23:45:54 +00:00
after a section is loaded, whether it is the result of passing a label on
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
the command line or using the
.Dq load
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
Only the commands specified for that label in the configuration
file are executed.
However, when invoking
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
.Nm
with the
.Fl background ,
.Fl ddial ,
or
.Fl dedicated
switches, the link mode tells
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to establish a connection.
Refer to the
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
.Dq set mode
command below for further details.
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Once the connection is made, the
.Sq ppp
portion of the prompt will change to
.Sq PPP :
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
# ppp MyISP
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
\&...
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
ppp ON awfulhak> dial
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
Ppp ON awfulhak>
PPp ON awfulhak>
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
PPP ON awfulhak>
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
The Ppp prompt indicates that
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
has entered the authentication phase.
The PPp prompt indicates that
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
has entered the network phase.
The PPP prompt indicates that
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Nm
has successfully negotiated a network layer protocol and is in
a usable state.
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
If the
.Pa /etc/ppp/ppp.linkup
file is available, its contents are executed
when the
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
connection is established.
See the provided
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq pmdemand
example in
/etc/ppp/ppp.*.sample -> /usr/share/examples/ppp/ppp.*.sample
1999-02-11 16:34:15 +00:00
.Pa /usr/share/examples/ppp/ppp.conf.sample
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
which runs a script in the background after the connection is established
(refer to the
.Dq shell
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
and
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Dq bg
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
commands below for a description of possible substitution strings).
Similarly, when a connection is closed, the contents of the
Add ppp.linkdown file to compliment ppp.linkup. Submitted by: Forgotten Passed on by: Terry Dwyer 61 8 9491 5161 <tdwyer@io.telstra.com.au> Also remove extraneous setuid(0) - it's only undone by the subsequent call to SelectSystem().
1997-06-13 02:07:32 +00:00
.Pa /etc/ppp/ppp.linkdown
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
file are executed.
Both of these files have the same format as
Add the "!include" syntax. Return 0 from "show" commands.
1997-11-09 17:51:27 +00:00
.Pa /etc/ppp/ppp.conf .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
In previous versions of
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
it was necessary to re-add routes such as the default route in the
.Pa ppp.linkup
file.
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
supports
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq sticky routes ,
where all routes that contain the
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dv HISADDR ,
.Dv MYADDR ,
.Dv HISADDR6
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dv MYADDR6
literals will automatically be updated when the values of these variables
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
change.
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
.Sh BACKGROUND DIALING
If you want to establish a connection using
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
non-interactively (such as from a
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr crontab 5
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
entry or an
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr at 1
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
job) you should use the
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
.Fl background
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
option.
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
When
.Fl background
is specified,
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
attempts to establish the connection immediately.
If multiple phone
numbers are specified, each phone number will be tried once.
If the attempt fails,
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
exits immediately with a non-zero exit code.
If it succeeds, then
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
becomes a daemon, and returns an exit status of zero to its caller.
The daemon exits automatically if the connection is dropped by the
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
remote system, or it receives a
.Dv TERM
signal.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh DIAL ON DEMAND
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
Demand dialing is enabled with the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Fl auto
Added my 'ddial' patches to user-PPP. The new mode tries it's darndest to keep the link up, so it re-dials whenever it detects the link go down. This is useful for 'dedicated' links who use PPP. It's been used for over a year w/out problems at different sites.
1996-12-03 21:38:52 +00:00
or
.Fl ddial
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
options.
You must also specify the destination label in
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Pa /etc/ppp/ppp.conf
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to use.
It must contain the
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq set ifaddr
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
command to {define} the remote peers IP address.
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
(refer to
/etc/ppp/ppp.*.sample -> /usr/share/examples/ppp/ppp.*.sample
1999-02-11 16:34:15 +00:00
.Pa /usr/share/examples/ppp/ppp.conf.sample )
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
# ppp -auto pmdemand
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
When
.Fl auto
Added my 'ddial' patches to user-PPP. The new mode tries it's darndest to keep the link up, so it re-dials whenever it detects the link go down. This is useful for 'dedicated' links who use PPP. It's been used for over a year w/out problems at different sites.
1996-12-03 21:38:52 +00:00
or
.Fl ddial
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
is specified,
.Nm
runs as a daemon but you can still configure or examine its
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
configuration by using the
.Dq set server
command in
.Pa /etc/ppp/ppp.conf ,
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(for example,
.Dq Li "set server +3000 mypasswd" )
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
and connecting to the diagnostic port as follows:
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
Do away with some literal text that is never switched off - I *think* these were groff bugs.
1999-03-19 09:00:08 +00:00
# pppctl 3000 (assuming tun0)
Refer a bit to pppctl. Suggested (far to subtly for his own good) by: joerg
1997-10-05 14:27:08 +00:00
Password:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
PPP ON awfulhak> show who
tcp (127.0.0.1:1028) *
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
The
.Dq show who
command lists users that are currently connected to
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
itself.
If the diagnostic socket is closed or changed to a different
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
socket, all connections are immediately dropped.
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
In
.Fl auto
mode, when an outgoing packet is detected,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
will perform the dialing action (chat script) and try to connect
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
with the peer.
In
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Fl ddial
mode, the dialing action is performed any time the line is found
to be down.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
If the connect fails, the default behaviour is to wait 30 seconds
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
and then attempt to connect when another outgoing packet is detected.
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
This behaviour can be changed using the
.Dq set redial
command:
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
.Pp
mdoc fixes.
2012-09-08 08:46:43 +00:00
.No set redial Ar secs Ns
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Oo + Ns Ar inc Ns
mdoc fixes.
2012-09-08 08:46:43 +00:00
.Oo - Ns Ar max Ns Oc Oc Ns
.Op . Ns Ar next
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Op Ar attempts
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Pp
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Bl -tag -width attempts -compact
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.It Ar secs
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
is the number of seconds to wait before attempting
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
to connect again.
If the argument is the literal string
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Sq Li random ,
When our dial timeout is ``random'', display its value correctly by invoking the timer to get the value before displaying the message. Don't assume that a value of 0 is ``random'' in ``show datalink''. Make the random value between 1 and DIAL_TIMEOUT rather than between 0 and DIAL_TIMEOUT-1
1999-02-25 12:00:04 +00:00
the delay period is a random value between 1 and 30 seconds inclusive.
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.It Ar inc
is the number of seconds that
.Ar secs
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
should be incremented each time a new dial attempt is made.
The timeout reverts to
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar secs
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
only after a successful connection is established.
The default value for
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar inc
is zero.
Be a bit more consistent with variable names.
1999-07-27 00:30:32 +00:00
.It Ar max
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
is the maximum number of times
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Nm
should increment
.Ar secs .
The default value for
Be a bit more consistent with variable names.
1999-07-27 00:30:32 +00:00
.Ar max
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
is 10.
.It Ar next
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
is the number of seconds to wait before attempting
to dial the next number in a list of numbers (see the
.Dq set phone
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command).
The default is 3 seconds.
Again, if the argument is the literal string
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Sq Li random ,
When our dial timeout is ``random'', display its value correctly by invoking the timer to get the value before displaying the message. Don't assume that a value of 0 is ``random'' in ``show datalink''. Make the random value between 1 and DIAL_TIMEOUT rather than between 0 and DIAL_TIMEOUT-1
1999-02-25 12:00:04 +00:00
the delay period is a random value between 1 and 30 seconds.
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.It Ar attempts
is the maximum number of times to try to connect for each outgoing packet
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
that triggers a dial.
The previous value is unchanged if this parameter is omitted.
If a value of zero is specified for
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar attempts ,
Allow the use of a "stopped" timeout via the "set stopped" directive. If the timeout occurs it will cause a "Down" event, hanging up the line if it's still up. This *isn't* part of the FSM diagram, but I consider it ok as a "higher level implementation specific timeout" as specified in the rfc ;-} Discussed briefly with: joerg
1997-08-17 20:45:50 +00:00
.Nm
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
will keep trying until a connection is made.
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.El
.Pp
various typo and minor punctuation changes. PR: 23111 Submitted by: Jimmy Olgeni <olgeni@uli.it>
2000-11-28 11:35:14 +00:00
So, for example:
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
.Bd -literal -offset indent
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
set redial 10.3 4
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
.Ed
.Pp
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
will attempt to connect 4 times for each outgoing packet that causes
a dial attempt with a 3 second delay between each number and a 10 second
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
delay after all numbers have been tried.
If multiple phone numbers
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
are specified, the total number of attempts is still 4 (it does not
attempt each number 4 times).
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Pp
Alternatively,
.Bd -literal -offset indent
set redial 10+10-5.3 20
.Ed
.Pp
tells
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to attempt to connect 20 times.
After the first attempt,
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
pauses for 10 seconds.
After the next attempt it pauses for 20 seconds
and so on until after the sixth attempt it pauses for 1 minute.
The next 14 pauses will also have a duration of one minute.
If
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Nm
connects, disconnects and fails to connect again, the timeout starts again
at 10 seconds.
.Pp
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
Modifying the dial delay is very useful when running
.Nm
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
in
.Fl auto
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
mode on both ends of the link.
If each end has the same timeout,
1. Add a settable redial timer and logging of the process id in a file. A settable redial timer helps to avoid the problem where both ends of a link want to dial at the same time and the line winds up busy for both ends. The process id is logged in /var/run/PPP.system where system is the name of the called system. When both ends of a link are running in demand dial mode, you need an easy way to get the pid of the ppp on the called end so it can be killed and re-started with -direct or pppd started to handle the incoming ppp session. 2. Add secret description for "set timeout" to man. Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: John Capo <jc@irbs.com>
1995-10-08 14:57:32 +00:00
both ends wind up calling each other at the same time if the link
drops and both ends have packets queued.
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
At some locations, the serial link may not be reliable, and carrier
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
may be lost at inappropriate times.
It is possible to have
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
.Nm
redial should carrier be unexpectedly lost during a session.
.Bd -literal -offset indent
set reconnect timeout ntries
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
This command tells
.Nm
to re-establish the connection
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
.Ar ntries
times on loss of carrier with a pause of
.Ar timeout
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
seconds before each try.
For example,
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
.Bd -literal -offset indent
set reconnect 3 5
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
tells
.Nm
that on an unexpected loss of carrier, it should wait
.Ar 3
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
seconds before attempting to reconnect.
This may happen up to
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
.Ar 5
times before
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
gives up.
The default value of ntries is zero (no reconnect).
Care should be taken with this option.
If the local timeout is slightly
Add a reconnect capability directing ppp to re-establish the connection after an unexpected loss of carrier: set reconnect timer ntries The man page warns against using this command when your timeout value is slightly more than the other sides :{} Suggested by: burton@bsampley.vip.best.com (Burton Sampley)
1997-04-21 01:02:02 +00:00
longer than the remote timeout, the reconnect feature will always be
triggered (up to the given number of times) after the remote side
times out and hangs up.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
NOTE: In this context, losing too many LQRs constitutes a loss of
Mega update to sort out bad implementations of reconnect & -background. o Fix reconnect anomolies. o Make reconnect apply to failed LQR hangups (& mention in man page). o Make reconnect effective in -background mode. o Listen on socket in -background mode. o Try all phone numbers in -background mode. o Insist on system arg in -background mode. o Make a control-connection close command exit in -background mode. o Output status message to stdout on exit of parent in -background mode. o Don't notify parent of success too soon. o Describe termination EX_* code. o Miscelaneous diagnostic corrections. o Remove redundant connect_time from modem.c. o Don't repeatedly DownConnection().
1997-05-19 02:00:16 +00:00
carrier and will trigger a reconnect.
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
If the
Make -background option attempt each phone number at most once. Make -background ignore redial. Output exit value to syslog with "PPP Terminated" message.
1997-04-13 00:54:45 +00:00
.Fl background
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
flag is specified, all phone numbers are dialed at most once until
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
a connection is made.
The next number redial period specified with the
Make the next number redial ability configurable. The "set redial pause [times]" command becomes "set redial end-pause[.next-pause] [times]" and next-pause defaults to 3 seconds. This keeps things backwards compatable. Suggested by: ache
1997-04-14 23:48:20 +00:00
.Dq set redial
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command is honoured, as is the reconnect tries value.
If your redial
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
value is less than the number of phone numbers specified, not all
the specified numbers will be tried.
Make -background option attempt each phone number at most once. Make -background ignore redial. Output exit value to syslog with "PPP Terminated" message.
1997-04-13 00:54:45 +00:00
To terminate the program, type
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Bd -literal -offset indent
PPP ON awfulhak> close
ppp ON awfulhak> quit all
.Ed
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Pp
A simple
.Dq quit
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
command will terminate the
.Xr pppctl 8
or
.Xr telnet 1
connection but not the
.Nm
program itself.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
You must use
.Dq quit all
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
to terminate
.Nm
as well.
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.Sh RECEIVING INCOMING PPP CONNECTIONS (Method 1)
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
To handle an incoming
.Em PPP
connection request, follow these steps:
.Bl -enum
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
.It
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
Make sure the modem and (optionally)
.Pa /etc/rc.serial
is configured correctly.
.Bl -bullet -compact
.It
Use Hardware Handshake (CTS/RTS) for flow control.
.It
Modem should be set to NO echo back (ATE0) and NO results string (ATQ1).
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Edit
.Pa /etc/ttys
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
to enable a
.Xr getty 8
on the port where the modem is attached.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
For example:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Fix some quotes and mention that it's usually necessary to train your modem to the correct speed when setting up an incoming getty.
2001-04-26 13:10:59 +00:00
.Dl ttyd1 Qo /usr/libexec/getty std.38400 Qc dialup on secure
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
Do not forget to send a
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dv HUP
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
signal to the
.Xr init 8
process to start the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Xr getty 8 :
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dl # kill -HUP 1
Fix some quotes and mention that it's usually necessary to train your modem to the correct speed when setting up an incoming getty.
2001-04-26 13:10:59 +00:00
.Pp
It is usually also necessary to train your modem to the same DTR speed
as the getty:
.Bd -literal -offset indent
# ppp
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
ppp ON awfulhak> set device /dev/cuau1
Fix some quotes and mention that it's usually necessary to train your modem to the correct speed when setting up an incoming getty.
2001-04-26 13:10:59 +00:00
ppp ON awfulhak> set speed 38400
ppp ON awfulhak> term
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
deflink: Entering terminal mode on /dev/cuau1
Fix some quotes and mention that it's usually necessary to train your modem to the correct speed when setting up an incoming getty.
2001-04-26 13:10:59 +00:00
Type `~?' for help
at
OK
at
OK
atz
OK
at
OK
~.
ppp ON awfulhak> quit
.Ed
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
Create a
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Pa /usr/local/bin/ppplogin
file with the following contents:
.Bd -literal -offset indent
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
#! /bin/sh
exec /usr/sbin/ppp -direct incoming
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
Direct mode
.Pq Fl direct
lets
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
work with stdin and stdout.
You can also use
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr pppctl 8
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
to connect to a configured diagnostic port, in the same manner as with
client-side
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Here, the
.Ar incoming
Mention the ``allow users'' command when describing how to set things up for incoming connections.
1998-06-18 01:24:29 +00:00
section must be set up in
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pa /etc/ppp/ppp.conf .
Mention the ``allow users'' command when describing how to set things up for incoming connections.
1998-06-18 01:24:29 +00:00
.Pp
Make sure that the
.Ar incoming
section contains the
.Dq allow users
command as appropriate.
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Prepare an account for the incoming user.
.Bd -literal
ppp:xxxx:66:66:PPP Login User:/home/ppp:/usr/local/bin/ppplogin
.Ed
.Pp
Refer to the manual entries for
.Xr adduser 8
and
.Xr vipw 8
for details.
.It
Support for IPCP Domain Name Server and NetBIOS Name Server negotiation
can be enabled using the
Suggest the use of ``accept dns'', not ``enable dns'' in server mode.
1998-06-21 11:14:50 +00:00
.Dq accept dns
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
and
.Dq set nbns
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
commands.
Refer to their descriptions below.
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.El
.Sh RECEIVING INCOMING PPP CONNECTIONS (Method 2)
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
This method differs in that we use
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
to authenticate the connection rather than
.Xr login 1 :
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.Bl -enum
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Configure your default section in
.Pa /etc/gettytab
with automatic ppp recognition by specifying the
.Dq pp
capability:
.Bd -literal
default:\\
:pp=/usr/local/bin/ppplogin:\\
.....
.Ed
.It
Configure your serial device(s), enable a
.Xr getty 8
and create
.Pa /usr/local/bin/ppplogin
as in the first three steps for method 1 above.
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Add either
.Dq enable chap
or
.Dq enable pap
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(or both)
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
to
.Pa /etc/ppp/ppp.conf
under the
.Sq incoming
label (or whatever label
.Pa ppplogin
uses).
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Create an entry in
.Pa /etc/ppp/ppp.secret
for each incoming user:
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.Bd -literal
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Pfred<TAB>xxxx
Pgeorge<TAB>yyyy
Add support for the Evil Microsoft ppp extentions. Yes, they did it on their own without even attempting to get concensus in the IETF, but there are also lots of Win95/NT boxes out there. CLoses PR#1494 Submitted-By: Peter Childs <pjchilds@imforei.apana.org.au>
1996-10-06 13:32:37 +00:00
.Ed
Mention the ``allow users'' command when describing how to set things up for incoming connections.
1998-06-18 01:24:29 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Now, as soon as
.Xr getty 8
detects a ppp connection (by recognising the HDLC frame headers), it runs
.Dq /usr/local/bin/ppplogin .
.Pp
It is
.Em VITAL
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
that either PAP or CHAP are enabled as above.
If they are not, you are
Add a missing ``a''.
2002-06-03 21:36:20 +00:00
allowing anybody to establish a ppp session with your machine
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em without
a password, opening yourself up to all sorts of potential attacks.
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Sh AUTHENTICATING INCOMING CONNECTIONS
Normally, the receiver of a connection requires that the peer
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
authenticates itself.
This may be done using
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Xr login 1 ,
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
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 you wish to use, add the command
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Sq enable chap
or
.Sq enable pap
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
to the relevant section of
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pa ppp.conf .
.Pp
You must then configure the
.Pa /etc/ppp/ppp.secret
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
file.
This file contains one line per possible client, each line
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
containing up to five fields:
Do away with some literal text that is never switched off - I *think* these were groff bugs.
1999-03-19 09:00:08 +00:00
.Pp
.Ar name Ar key Oo
.Ar hisaddr Op Ar label Op Ar callback-number
.Oc
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pp
The
.Ar name
and
.Ar key
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
specify the client username and password.
If
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Ar key
is
.Dq \&*
and PAP is being used,
.Nm
will look up the password database
.Pq Xr passwd 5
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
when authenticating.
If the client does not offer a suitable response based on any
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Ar name Ns No / Ns Ar key
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
combination in
.Pa ppp.secret ,
authentication fails.
.Pp
If authentication is successful,
.Ar hisaddr
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(if specified)
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is used when negotiating IP numbers.
See the
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Dq set ifaddr
command for details.
.Pp
If authentication is successful and
.Ar label
is specified, the current system label is changed to match the given
.Ar label .
This will change the subsequent parsing of the
.Pa ppp.linkup
and
.Pa ppp.linkdown
files.
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Pp
If authentication is successful and
.Ar callback-number
is specified and
.Dq set callback
has been used in
.Pa ppp.conf ,
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
the client will be called back on the given number.
If CBCP is being used,
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Ar callback-number
may also contain a list of numbers or a
.Dq \&* ,
as if passed to the
.Dq set cbcp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
The value will be used in
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
subsequent CBCP phase.
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Sh PPP OVER TCP and UDP (a.k.a Tunnelling)
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Instead of running
.Nm
over a serial link, it is possible to
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
use a TCP connection instead by specifying the host, port and protocol as the
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
device:
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Dl set device ui-gate:6669/tcp
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
Instead of opening a serial device,
.Nm
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
will open a TCP connection to the given machine on the given
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
socket.
It should be noted however that
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Nm
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
does not use the telnet protocol and will be unable to negotiate
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
with a telnet server.
You should set up a port for receiving this
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
connection on the receiving machine (ui-gate).
This is done by first updating
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Pa /etc/services
to name the service:
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Dl ppp-in 6669/tcp # Incoming PPP connections over TCP
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
and updating
.Pa /etc/inetd.conf
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
to tell
.Xr inetd 8
how to deal with incoming connections on that port:
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Dl ppp-in stream tcp nowait root /usr/sbin/ppp ppp -direct ppp-in
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
Do not forget to send a
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Dv HUP
signal to
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr inetd 8
Expand contractions.
2005-02-13 23:45:54 +00:00
after you have updated
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Pa /etc/inetd.conf .
Here, we use a label named
.Dq ppp-in .
The entry in
.Pa /etc/ppp/ppp.conf
on ui-gate (the receiver) should contain the following:
.Bd -literal -offset indent
ppp-in:
set timeout 0
set ifaddr 10.0.4.1 10.0.4.2
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
and the entry in
.Pa /etc/ppp/ppp.linkup
should contain:
.Bd -literal -offset indent
ppp-in:
add 10.0.1.0/24 HISADDR
.Ed
.Pp
Remove whitespace at EOL.
2001-07-15 08:06:20 +00:00
It is necessary to put the
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
.Dq add
command in
.Pa ppp.linkup
to ensure that the route is only added after
.Nm
has negotiated and assigned addresses to its interface.
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
You may also want to enable PAP or CHAP for security.
To enable PAP, add the following line:
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Bd -literal -offset indent
enable PAP
.Ed
.Pp
Expand contractions.
2005-02-13 23:45:54 +00:00
You will also need to create the following entry in
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Pa /etc/ppp/ppp.secret :
.Bd -literal -offset indent
MyAuthName MyAuthPasswd
.Ed
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
If
.Ar MyAuthPasswd
is a
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
.Dq * ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
the password is looked up in the
.Xr passwd 5
database.
.Pp
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
The entry in
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Pa /etc/ppp/ppp.conf
on awfulhak (the initiator) should contain the following:
.Bd -literal -offset indent
ui-gate:
set escape 0xff
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
set device ui-gate:ppp-in/tcp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
set dial
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
set timeout 30
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
set log Phase Chat Connect hdlc LCP IPCP IPV6CP CCP tun
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
set ifaddr 10.0.4.2 10.0.4.1
.Ed
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Pp
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
with the route setup in
.Pa /etc/ppp/ppp.linkup :
.Bd -literal -offset indent
ui-gate:
add 10.0.2.0/24 HISADDR
.Ed
.Pp
Expand contractions.
2005-02-13 23:45:54 +00:00
Again, if you are enabling PAP, you will also need this in the
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
.Pa /etc/ppp/ppp.conf
profile:
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Bd -literal -offset indent
set authname MyAuthName
set authkey MyAuthKey
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Expand contractions.
2005-02-13 23:45:54 +00:00
We are assigning the address of 10.0.4.1 to ui-gate, and the address
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
10.0.4.2 to awfulhak.
To open the connection, just type
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Dl awfulhak # ppp -background ui-gate
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
The result will be an additional "route" on awfulhak to the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
10.0.2.0/24 network via the TCP connection, and an additional
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
"route" on ui-gate to the 10.0.1.0/24 network.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
The networks are effectively bridged - the underlying TCP
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
connection may be across a public network (such as the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Internet), and the
.Em PPP
traffic is conceptually encapsulated
(although not packet by packet) inside the TCP stream between
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
the two gateways.
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
The major disadvantage of this mechanism is that there are two
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
"guaranteed delivery" mechanisms in place - the underlying TCP
stream and whatever protocol is used over the
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
link - probably TCP again.
If packets are lost, both levels will
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
get in each others way trying to negotiate sending of the missing
packet.
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Pp
To avoid this overhead, it is also possible to do all this using
UDP instead of TCP as the transport by simply changing the protocol
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
from "tcp" to "udp".
When using UDP as a transport,
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will operate in synchronous mode.
This is another gain as the incoming
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
data does not have to be rearranged into packets.
.Pp
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
Care should be taken when adding a default route through a tunneled
setup like this.
It is quite common for the default route
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(added in
.Pa /etc/ppp/ppp.linkup )
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
to end up routing the link's TCP connection through the tunnel,
effectively garrotting the connection.
To avoid this, make sure you add a static route for the benefit of
the link:
.Bd -literal -offset indent
ui-gate:
set escape 0xff
set device ui-gate:ppp-in/tcp
add ui-gate x.x.x.x
.....
.Ed
.Pp
where
.Dq x.x.x.x
is the IP number that your route to
.Dq ui-gate
would normally use.
.Pp
Spelling fixes for usr.sbin/
2011-12-30 10:58:14 +00:00
When routing your connection across a public network such as the Internet,
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
it is preferable to encrypt the data.
This can be done with the help of the MPPE protocol, although currently this
means that you will not be able to also compress the traffic as MPPE is
implemented as a compression layer (thank Microsoft for this).
To enable MPPE encryption, add the following lines to
.Pa /etc/ppp/ppp.conf
on the server:
.Bd -literal -offset indent
enable MSCHAPv2
disable deflate pred1
deny deflate pred1
.Ed
.Pp
Expand contractions.
2005-02-13 23:45:54 +00:00
ensuring that you have put the requisite entry in
Describe how to tunnel properly. Requested by: Greg Quinlan <greg@macquarrie.com.au>
2000-11-19 16:54:57 +00:00
.Pa /etc/ppp/ppp.secret
(MSCHAPv2 is challenge based, so
.Xr passwd 5
cannot be used)
.Pp
MSCHAPv2 and MPPE are accepted by default, so the client end should work
without any additional changes (although ensure you have
.Dq set authname
and
.Dq set authkey
in your profile).
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Sh NETWORK ADDRESS TRANSLATION (PACKET ALIASING)
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
The
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Fl nat
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
command line option enables network address translation (a.k.a.\& packet
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
aliasing).
This allows the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Nm
host to act as a masquerading gateway for other computers over
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
a local area network.
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
Outgoing IP packets are NAT'd so that they appear to come from the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Nm
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
host, and incoming packets are de-NAT'd so that they are routed
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
to the correct machine on the local area network.
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
NAT allows computers on private, unregistered subnets to have Internet
access, although they are invisible from the outside world.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
In general, correct
.Nm
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
operation should first be verified with network address translation disabled.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Then, the
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Fl nat
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
option should be switched on, and network applications (web browser,
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr telnet 1 ,
.Xr ftp 1 ,
.Xr ping 8 ,
.Xr traceroute 8 )
should be checked on the
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
host.
Finally, the same or similar applications should be checked on other
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
computers in the LAN.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
If network applications work correctly on the
.Nm
host, but not on other machines in the LAN, then the masquerading
software is working properly, but the host is either not forwarding
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
or possibly receiving IP packets.
Check that IP forwarding is enabled in
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Pa /etc/rc.conf
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
and that other machines have designated the
.Nm
host as the gateway for the LAN.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Sh PACKET FILTERING
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
This implementation supports packet filtering.
There are four kinds of
various typo and minor punctuation changes. PR: 23111 Submitted by: Jimmy Olgeni <olgeni@uli.it>
2000-11-28 11:35:14 +00:00
filters: the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em in
filter, the
.Em out
filter, the
.Em dial
filter and the
.Em alive
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
filter.
Here are the basics:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Bl -bullet
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
A filter definition has the following syntax:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
set filter
.Ar name
.Ar rule-no
.Ar action
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Op !\&
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Oo
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
.Op host
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar src_addr Ns Op / Ns Ar width
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Op Ar dst_addr Ns Op / Ns Ar width
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Oc
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Ar [ proto Op src Ar cmp port
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Op dst Ar cmp port
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Op estab
.Op syn
.Op finrst
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op timeout Ar secs ]
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bl -enum
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar Name
should be one of
.Sq in ,
.Sq out ,
.Sq dial
or
.Sq alive .
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar Rule-no
is a numeric value between
.Sq 0
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
and
Fix an off-by-one error and correct the man page WRT clearing filters. Submitted by: Peter Jeremy <peter.jeremy@alcatel.com.au> PR: 12437
1999-07-26 11:15:11 +00:00
.Sq 39
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
specifying the rule number.
Rules are specified in numeric order according to
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar rule-no ,
but only if rule
.Sq 0
is defined.
.It
.Ar Action
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
may be specified as
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq permit
or
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
.Sq deny ,
in which case, if a given packet matches the rule, the associated action
is taken immediately.
Fix an off-by-one error and correct the man page WRT clearing filters. Submitted by: Peter Jeremy <peter.jeremy@alcatel.com.au> PR: 12437
1999-07-26 11:15:11 +00:00
.Ar Action
can also be specified as
.Sq clear
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
to clear the action associated with that particular rule, or as a new
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
rule number greater than the current rule.
In this case, if a given
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
packet matches the current rule, the packet will next be matched against
the new rule number (rather than the next rule number).
.Pp
The
.Ar action
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
may optionally be followed with an exclamation mark
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Pq Dq !\& ,
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
telling
.Nm
to reverse the sense of the following match.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Op Ar src_addr Ns Op / Ns Ar width
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
and
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Op Ar dst_addr Ns Op / Ns Ar width
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
are the source and destination IP number specifications.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Op / Ns Ar width
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
is specified, it gives the number of relevant netmask bits,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
allowing the specification of an address range.
Mention that using MYADDR and HISADDR with ``set filter'' will result in the rules being updated any time MYADDR or HISADDR change.
1999-06-01 08:46:53 +00:00
.Pp
Either
.Ar src_addr
or
.Ar dst_addr
may be given the values
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dv MYADDR ,
.Dv HISADDR ,
.Dv MYADDR6
Mention that using MYADDR and HISADDR with ``set filter'' will result in the rules being updated any time MYADDR or HISADDR change.
1999-06-01 08:46:53 +00:00
or
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dv HISADDR6
Mention that using MYADDR and HISADDR with ``set filter'' will result in the rules being updated any time MYADDR or HISADDR change.
1999-06-01 08:46:53 +00:00
(refer to the description of the
.Dq bg
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command for a description of these values).
When these values are used,
the filters will be updated any time the values change.
This is similar to the behaviour of the
Mention that using MYADDR and HISADDR with ``set filter'' will result in the rules being updated any time MYADDR or HISADDR change.
1999-06-01 08:46:53 +00:00
.Dq add
command below.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar Proto
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
may be any protocol from
.Xr protocols 5 .
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar Cmp
is one of
.Sq \&lt ,
.Sq \&eq
or
.Sq \&gt ,
meaning less-than, equal and greater-than respectively.
.Ar Port
can be specified as a numeric port or by service name from
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Pa /etc/services .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It
The
.Sq estab ,
.Sq syn ,
and
.Sq finrst
flags are only allowed when
.Ar proto
is set to
.Sq tcp ,
and represent the TH_ACK, TH_SYN and TH_FIN or TH_RST TCP flags respectively.
Allow a ``timeout secs'' filter option to let specific packet types effect the idle timer in different ways. Submitted by: Stefan Esser <se@freebsd.org> With adjustments by me to document the option in the man page and to give the same semantics for outgoing traffic as incoming. I made the style more consistent in ip.c - this should really have been done as a separate commit.
2000-07-11 22:11:36 +00:00
.It
The timeout value adjusts the current idle timeout to at least
.Ar secs
seconds.
If a timeout is given in the alive filter as well as in the in/out
Some gratuitous whitespace changes.
2000-11-19 16:58:59 +00:00
filter, the in/out value is used.
If no timeout is given, the default timeout (set using
Allow a ``timeout secs'' filter option to let specific packet types effect the idle timer in different ways. Submitted by: Stefan Esser <se@freebsd.org> With adjustments by me to document the option in the man page and to give the same semantics for outgoing traffic as incoming. I made the style more consistent in ip.c - this should really have been done as a separate commit.
2000-07-11 22:11:36 +00:00
.Ic set timeout
and defaulting to 180 seconds) is used.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
Change the maximum number of filters from 20 to 40. Increase requested by: "Clement T. Cole" <clemc@echo.ccc.com>
1999-01-19 22:16:02 +00:00
Each filter can hold up to 40 rules, starting from rule 0.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
The entire rule set is not effective until rule 0 is defined,
Fix some typos Obtained from: OpenBSD
2000-03-14 01:47:13 +00:00
i.e., the default is to allow everything through.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
Allow a ``timeout secs'' filter option to let specific packet types effect the idle timer in different ways. Submitted by: Stefan Esser <se@freebsd.org> With adjustments by me to document the option in the man page and to give the same semantics for outgoing traffic as incoming. I made the style more consistent in ip.c - this should really have been done as a separate commit.
2000-07-11 22:11:36 +00:00
If no rule in a defined set of rules matches a packet, that packet will
be discarded (blocked).
If there are no rules in a given filter, the packet will be permitted.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It
Expand contractions.
2005-02-13 23:45:54 +00:00
It is possible to filter based on the payload of UDP frames where those
o Log the (payload/size) of all packet types, not just TCP packets o If the new ``filter-decapsulation'' is enabled, delve into UDP packets that contain 0xff 0x03 as the first two bytes, and if we recognise it as PROTO_IP, decapsulate it for the purpose of filter checking. If we recognise it as PROTO_<anything else> mention this for logging purposes only. This change is aimed at people running PPPoUDP where the UDP traffic is being sent over another PPP link. It's desireable to have the top level link connected all the time, but to have the bottom level link capable of decapsulating the traffic and comparing the payload against the filters, thus allowing ``set filter dial ...'' to work in tunnelled environments. The caveat here is that the top ppp cannot employ any compression layers without making the data unreadable for the bottom ppp. ``disable deflate pred1 vj'' and ``deny deflate pred1 vj'' is suggested.
2000-07-07 14:22:08 +00:00
frames contain a
.Em PROTO_IP
.Em PPP
Some gratuitous whitespace changes.
2000-11-19 16:58:59 +00:00
frame header.
See the
o Log the (payload/size) of all packet types, not just TCP packets o If the new ``filter-decapsulation'' is enabled, delve into UDP packets that contain 0xff 0x03 as the first two bytes, and if we recognise it as PROTO_IP, decapsulate it for the purpose of filter checking. If we recognise it as PROTO_<anything else> mention this for logging purposes only. This change is aimed at people running PPPoUDP where the UDP traffic is being sent over another PPP link. It's desireable to have the top level link connected all the time, but to have the bottom level link capable of decapsulating the traffic and comparing the payload against the filters, thus allowing ``set filter dial ...'' to work in tunnelled environments. The caveat here is that the top ppp cannot employ any compression layers without making the data unreadable for the bottom ppp. ``disable deflate pred1 vj'' and ``deny deflate pred1 vj'' is suggested.
2000-07-07 14:22:08 +00:00
.Ar filter-decapsulation
option below for further details.
.It
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
Use
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set filter Ar name No -1
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
to flush all rules.
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
See
/etc/ppp/ppp.*.sample -> /usr/share/examples/ppp/ppp.*.sample
1999-02-11 16:34:15 +00:00
.Pa /usr/share/examples/ppp/ppp.conf.sample .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sh SETTING THE IDLE TIMER
To check/set the idle timer, use the
.Dq show bundle
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
and
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set timeout
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
commands:
.Bd -literal -offset indent
ppp ON awfulhak> set timeout 600
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
The timeout period is measured in seconds, the default value for which
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is 180 seconds
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(or 3 min).
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
To disable the idle timer function, use the command
.Bd -literal -offset indent
ppp ON awfulhak> set timeout 0
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
In
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Fl ddial
and
Typo: The idle timer is ignored in -ddial and -dedicated mode, not in -ddial and -direct. Pointed out by: Chris Timmons <skynyrd@opus.cts.cwu.edu>
1999-01-06 00:08:15 +00:00
.Fl dedicated
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
modes, the idle timeout is ignored.
In
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Fl auto
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
mode, when the idle timeout causes the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Em PPP
session to be
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
closed, the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
program itself remains running.
Another trigger packet will cause it to attempt to re-establish the link.
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Sh PREDICTOR-1 and DEFLATE COMPRESSION
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
supports both Predictor type 1 and deflate compression.
By default,
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Nm
will attempt to use (or be willing to accept) both compression protocols
when the peer agrees
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(or requests them).
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
The deflate protocol is preferred by
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
Refer to the
.Dq disable
and
.Dq deny
commands if you wish to disable this functionality.
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
It is possible to use a different compression algorithm in each direction
by using only one of
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Dq disable deflate
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
and
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq deny deflate
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(assuming that the peer supports both algorithms).
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
By default, when negotiating DEFLATE,
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will use a window size of 15.
Refer to the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set deflate
command if you wish to change this behaviour.
.Pp
A special algorithm called DEFLATE24 is also available, and is disabled
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
and denied by default.
This is exactly the same as DEFLATE except that
it uses CCP ID 24 to negotiate.
This allows
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
to successfully negotiate DEFLATE with
.Nm pppd
version 2.3.*.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Sh CONTROLLING IP ADDRESS
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
For IPv4,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
uses IPCP to negotiate IP addresses.
Each side of the connection
Expand contractions.
2005-02-13 23:45:54 +00:00
specifies the IP address that it is willing to use, and if the requested
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
IP address is acceptable then
.Nm
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
returns an ACK to the requester.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Otherwise,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
Remove more single-space hard sentence breaks.
2000-03-02 14:54:02 +00:00
returns NAK to suggest that the peer use a different IP address.
When
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
both sides of the connection agree to accept the received request (and
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
send an ACK), IPCP is set to the open state and a network level connection
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
is established.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
To control this IPCP behaviour, this implementation has the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Dq set ifaddr
command for defining the local and remote IP address:
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Bd -ragged -offset indent
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.No set ifaddr Oo Ar src_addr Ns
.Op / Ns Ar \&nn
.Oo Ar dst_addr Ns Op / Ns Ar \&nn
.Oo Ar netmask
.Op Ar trigger_addr
.Oc
.Oc
.Oc
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
where,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sq src_addr
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
is the IP address that the local side is willing to use,
.Sq dst_addr
is the IP address which the remote side should use and
.Sq netmask
is the netmask that should be used.
.Sq Src_addr
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
defaults to the current
.Xr hostname 1 ,
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sq dst_addr
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
defaults to 0.0.0.0, and
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
.Sq netmask
defaults to whatever mask is appropriate for
.Sq src_addr .
It is only possible to make
1) Add multi-phone dialing/redialing, several phones separated by ':' 2) Improve on-line help subsystem 3) Make 'term' mode works even carrier dropped (old code close line forever here) 4) Make 'term' mode 8bit clean. 5) Improve manual page 6) #ifdef DEBUG diagnostic about missing optional files. 7) Don't put interactive dialing info to logfile
1996-03-08 09:03:09 +00:00
.Sq netmask
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
smaller than the default.
The usual value is 255.255.255.255, as
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
most kernels ignore the netmask of a POINTOPOINT interface.
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Some incorrect
.Em PPP
implementations require that the peer negotiates a specific IP
address instead of
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
.Sq src_addr .
If this is the case,
.Sq trigger_addr
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
may be used to specify this IP number.
This will not affect the
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
routing table unless the other side agrees with this proposed number.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Bd -literal -offset indent
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
set ifaddr 192.244.177.38 192.244.177.2 255.255.255.255 0.0.0.0
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
The above specification means:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Bl -bullet -compact
.It
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
I will first suggest that my IP address should be 0.0.0.0, but I
will only accept an address of 192.244.177.38.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
I strongly insist that the peer uses 192.244.177.2 as his own
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
address and will not permit the use of any IP address but 192.244.177.2.
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
When the peer requests another IP address, I will always suggest that
it uses 192.244.177.2.
1) Add multi-phone dialing/redialing, several phones separated by ':' 2) Improve on-line help subsystem 3) Make 'term' mode works even carrier dropped (old code close line forever here) 4) Make 'term' mode 8bit clean. 5) Improve manual page 6) #ifdef DEBUG diagnostic about missing optional files. 7) Don't put interactive dialing info to logfile
1996-03-08 09:03:09 +00:00
.It
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
The routing table entry will have a netmask of 0xffffffff.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
This is all fine when each side has a pre-determined IP address, however
it is often the case that one side is acting as a server which controls
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
all IP addresses and the other side should go along with it.
In order to allow more flexible behaviour, the
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
.Dq set ifaddr
command allows the user to specify IP addresses more loosely:
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pp
1) Add multi-phone dialing/redialing, several phones separated by ':' 2) Improve on-line help subsystem 3) Make 'term' mode works even carrier dropped (old code close line forever here) 4) Make 'term' mode 8bit clean. 5) Improve manual page 6) #ifdef DEBUG diagnostic about missing optional files. 7) Don't put interactive dialing info to logfile
1996-03-08 09:03:09 +00:00
.Dl set ifaddr 192.244.177.38/24 192.244.177.2/20
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pp
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
A number followed by a slash
.Pq Dq /
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
represents the number of bits significant in the IP address.
The above example means:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Bl -bullet -compact
.It
Expand contractions.
2005-02-13 23:45:54 +00:00
I would like to use 192.244.177.38 as my address if it is possible, but I will
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
also accept any IP address between 192.244.177.0 and 192.244.177.255.
For /usr/sbin/ppp, you must choose between running ppp in the background or connecting to a host immediately in the foreground. I would like to be able to run ppp from a script so that my script can be sure that it is connected to the 'net before it continues running: # Dial up the internet. ppp -background myprovider || exit 1 do-some-net-command # Hang up the modem. kill -HUP `cat /var/run/ppp.tun0.pid` Another problem is that the current ppp calls its process id file `/var/run/PPP.server', which may conflict if you have more than one IP tunnel interface available. Closes PR#1469 Submitted by: Gord Matzigkeit <gord@enci.ucalgary.ca>
1996-12-22 17:29:33 +00:00
.It
Expand contractions.
2005-02-13 23:45:54 +00:00
I would like to make him use 192.244.177.2 as his own address, but I will also
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
permit him to use any IP address between 192.244.176.0 and
New user Process PPP based on iij-ppp0.94beta2. o Supporting SYNC SIO device (But need a device driver) - add "set speed sync" o Fixing bug for Predictor-1 function. o Add new parameter that re-sent interval for set timeout commands. o Improving RTT (Round Trip Time) and reducing processor time. - Previous Timer service was using polling, and now using SIGALRM ;-) - A 0.94beta2 will not work correctly.... -- Follows are additinal feature not including 0.94beta2 o Support Proxy ARP - add "enable/disable proxy" commands o Marging common routine in CHAP/PAP. o Enhancing LCP/IPCP log information. o Support local Authfication connection on port 300x and tty. - You can set up pair of your "hostname -s" and password in ppp.secret. if either ppp.secret file nor your hostname line don't exist, It will notify a message and working as same as previous version.(Backword compatibility) - If you did set up them, It's allow connection but nothing to do except help and passwd command. - add "passwd yourpasswd" commands o Support afilter - keep Alive filter that a packet can send/receiving according to ifilter/ofilter but doesn't count it as preventing idle timer expires. - Same syntax of other filters. o Fixing bugs reported by current user for previous one. Thanks !! Reviewed by: Atsushi Murai (amurai@spec.co.jp)
1995-02-26 12:18:08 +00:00
192.244.191.255.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
As you may have already noticed, 192.244.177.2 is equivalent to saying
New user Process PPP based on iij-ppp0.94beta2. o Supporting SYNC SIO device (But need a device driver) - add "set speed sync" o Fixing bug for Predictor-1 function. o Add new parameter that re-sent interval for set timeout commands. o Improving RTT (Round Trip Time) and reducing processor time. - Previous Timer service was using polling, and now using SIGALRM ;-) - A 0.94beta2 will not work correctly.... -- Follows are additinal feature not including 0.94beta2 o Support Proxy ARP - add "enable/disable proxy" commands o Marging common routine in CHAP/PAP. o Enhancing LCP/IPCP log information. o Support local Authfication connection on port 300x and tty. - You can set up pair of your "hostname -s" and password in ppp.secret. if either ppp.secret file nor your hostname line don't exist, It will notify a message and working as same as previous version.(Backword compatibility) - If you did set up them, It's allow connection but nothing to do except help and passwd command. - add "passwd yourpasswd" commands o Support afilter - keep Alive filter that a packet can send/receiving according to ifilter/ofilter but doesn't count it as preventing idle timer expires. - Same syntax of other filters. o Fixing bugs reported by current user for previous one. Thanks !! Reviewed by: Atsushi Murai (amurai@spec.co.jp)
1995-02-26 12:18:08 +00:00
192.244.177.2/32.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
As an exception, 0 is equivalent to 0.0.0.0/0, meaning that I have no
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
preferred IP address and will obey the remote peers selection.
When using zero, no routing table entries will be made until a connection
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
is established.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Expand contractions.
2005-02-13 23:45:54 +00:00
192.244.177.2/0 means that I will accept/permit any IP address but I will
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
suggest that 192.244.177.2 be used first.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Pp
When negotiating IPv6 addresses, no control is given to the user.
IPV6CP negotiation is fully automatic.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Sh CONNECTING WITH YOUR INTERNET SERVICE PROVIDER
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
The following steps should be taken when connecting to your ISP:
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Bl -enum
.It
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Describe your providers phone number(s) in the dial script using the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Dq set phone
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
This command allows you to set multiple phone numbers for
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
dialing and redialing separated by either a pipe
.Pq Dq \&|
or a colon
.Pq Dq \&: :
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Bd -ragged -offset indent
mdoc fixes.
2012-09-08 08:46:43 +00:00
.No set phone Ar telno Ns
.Oo \&| Ns Ar backupnumber Oc Ns ... Ns Oo : Ns Ar nextnumber Oc Ns ...
Allow specification of fallback phone numbers to be used only if the dial script fails. PR: 4262
1997-08-17 20:38:45 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Spelling police.
1997-08-19 11:27:00 +00:00
Numbers after the first in a pipe-separated list are only used if the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
previous number was used in a failed dial or login script.
Numbers
Phone the number after the ``|'' whether the dial OR login script fails. Catch a small typo in the man page.
1997-08-23 23:14:24 +00:00
separated by a colon are used sequentially, irrespective of what happened
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
as a result of using the previous number.
For example:
Allow specification of fallback phone numbers to be used only if the dial script fails. PR: 4262
1997-08-17 20:38:45 +00:00
.Bd -literal -offset indent
set phone "1234567|2345678:3456789|4567890"
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Ed
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Here, the 1234567 number is attempted.
If the dial or login script fails,
Phone the number after the ``|'' whether the dial OR login script fails. Catch a small typo in the man page.
1997-08-23 23:14:24 +00:00
the 2345678 number is used next time, but *only* if the dial or login script
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
fails.
On the dial after this, the 3456789 number is used.
The 4567890
number is only used if the dial or login script using the 3456789 fails.
If the login script of the 2345678 number fails, the next number is still the
3456789 number.
As many pipes and colons can be used as are necessary
Phone the number after the ``|'' whether the dial OR login script fails. Catch a small typo in the man page.
1997-08-23 23:14:24 +00:00
(although a given site would usually prefer to use either the pipe or the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
colon, but not both).
The next number redial timeout is used between all numbers.
When the end of the list is reached, the normal redial period is
Phone the number after the ``|'' whether the dial OR login script fails. Catch a small typo in the man page.
1997-08-23 23:14:24 +00:00
used before starting at the beginning again.
Allow specification of fallback phone numbers to be used only if the dial script fails. PR: 4262
1997-08-17 20:38:45 +00:00
The selected phone number is substituted for the \\\\T string in the
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Dq set dial
command (see below).
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
Set up your redial requirements using
.Dq set redial .
For example, if you have a bad telephone line or your provider is
usually engaged (not so common these days), you may want to specify
the following:
.Bd -literal -offset indent
set redial 10 4
.Ed
.Pp
This says that up to 4 phone calls should be attempted with a pause of 10
seconds before dialing the first number again.
.It
Describe your login procedure using the
.Dq set dial
and
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Dq set login
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
commands.
The
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Dq set dial
command is used to talk to your modem and establish a link with your
ISP, for example:
.Bd -literal -offset indent
Wrap long lines Submitted by: Greg Lehey <grog@lemis.com>
1997-12-16 00:32:35 +00:00
set dial "ABORT BUSY ABORT NO\\\\sCARRIER TIMEOUT 4 \\"\\" \e
ATZ OK-ATZ-OK ATDT\\\\T TIMEOUT 60 CONNECT"
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Ed
.Pp
This modem "chat" string means:
.Bl -bullet
.It
Abort if the string "BUSY" or "NO CARRIER" are received.
.It
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
Set the timeout to 4 seconds.
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.It
Expect nothing.
.It
Send ATZ.
.It
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Expect OK.
Expand contractions.
2005-02-13 23:45:54 +00:00
If that is not received within the 4 second timeout, send ATZ
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
and expect OK.
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.It
Send ATDTxxxxxxx where xxxxxxx is the next number in the phone list from
above.
.It
Set the timeout to 60.
.It
Wait for the CONNECT string.
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Once the connection is established, the login script is executed.
This script is written in the same style as the dial script, but care should
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
be taken to avoid having your password logged:
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Bd -literal -offset indent
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
set authkey MySecret
Wrap long lines Submitted by: Greg Lehey <grog@lemis.com>
1997-12-16 00:32:35 +00:00
set login "TIMEOUT 15 login:-\\\\r-login: awfulhak \e
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
word: \\\\P ocol: PPP HELLO"
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Ed
.Pp
This login "chat" string means:
.Bl -bullet
.It
Set the timeout to 15 seconds.
.It
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Expect "login:".
Expand contractions.
2005-02-13 23:45:54 +00:00
If it is not received, send a carriage return and expect
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
"login:" again.
.It
Send "awfulhak"
.It
Expect "word:" (the tail end of a "Password:" prompt).
.It
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
Send whatever our current
.Ar authkey
value is set to.
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.It
Expect "ocol:" (the tail end of a "Protocol:" prompt).
.It
Send "PPP".
.It
Expect "HELLO".
.El
.Pp
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
The
.Dq set authkey
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command is logged specially.
When
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
.Ar command
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
or
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
.Ar chat
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
logging is enabled, the actual password is not logged;
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Sq ********
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
is logged instead.
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Login scripts vary greatly between ISPs.
Expand contractions.
2005-02-13 23:45:54 +00:00
If you are setting one up for the first time,
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Em ENABLE CHAT LOGGING
so that you can see if your script is behaving as you expect.
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.It
Use
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dq set device
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
and
Cosmetic: Remove unused variables and build on OpenBSD.
1997-09-10 02:20:35 +00:00
.Dq set speed
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
to specify your serial line and speed, for example:
.Bd -literal -offset indent
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
set device /dev/cuau0
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
set speed 115200
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Ed
.Pp
Catch up with PHK's sio(4) cuaa->cuad rework [sys/dev/sio/sio.c rev. 1.456]. PR: 73879 Submitted by: Steve Kargl <sgk@troutmask.apl.washington.edu>
2004-11-19 03:56:47 +00:00
Cuad0 is the first serial port on
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
.Fx .
Expand contractions.
2005-02-13 23:45:54 +00:00
If you are running
Cosmetic: Remove unused variables and build on OpenBSD.
1997-09-10 02:20:35 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
on
.Ox ,
cua00 is the first.
A speed of 115200 should be specified
if you have a modem capable of bit rates of 28800 or more.
In general, the serial speed should be about four times the modem speed.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
Use the
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Dq set ifaddr
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
command to {define} the IP address.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Bl -bullet
.It
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
If you know what IP address your provider uses, then use it as the remote
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
address (dst_addr), otherwise choose something like 10.0.0.2/0 (see below).
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
If your provider has assigned a particular IP address to you, then use
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
it as your address (src_addr).
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
If your provider assigns your address dynamically, choose a suitably
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
unobtrusive and unspecific IP number as your address.
10.0.0.1/0 would be appropriate.
The bit after the / specifies how many bits of the
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
address you consider to be important, so if you wanted to insist on
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
something in the class C network 1.2.3.0, you could specify 1.2.3.1/24.
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
.It
If you find that your ISP accepts the first IP number that you suggest,
specify third and forth arguments of
.Dq 0.0.0.0 .
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This will force your ISP to assign a number.
(The third argument will
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
be ignored as it is less restrictive than the default mask for your
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
.Sq src_addr ) .
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Pp
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
An example for a connection where you do not know your IP number or your
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
ISPs IP number would be:
.Bd -literal -offset indent
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
set ifaddr 10.0.0.1/0 10.0.0.2/0 0.0.0.0 0.0.0.0
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.It
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
In most cases, your ISP will also be your default router.
If this is the case, add the line
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Bd -literal -offset indent
Make it clear that using "add ...." in ppp.conf when not in -auto mode isn't a good idea, and that the add should be done in ppp.linkup instead. Change "add 0 0 HISADDR" to "add default HISADDR". It's more intuitive.
1998-01-04 21:28:49 +00:00
add default HISADDR
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Ed
.Pp
to
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Pa /etc/ppp/ppp.conf
(or to
.Pa /etc/ppp/ppp.linkup
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
for setups that do not use
mdoc(7) police: markup nit, removed whitespace at EOL.
2001-08-16 08:26:04 +00:00
.Fl auto
mode).
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
.Pp
This tells
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
to add a default route to whatever the peer address is
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(10.0.0.2 in this example).
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
This route is
.Sq sticky ,
meaning that should the value of
.Dv HISADDR
change, the route will be updated accordingly.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
If your provider requests that you use PAP/CHAP authentication methods, add
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
the next lines to your
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
file:
.Bd -literal -offset indent
set authname MyName
set authkey MyPassword
.Ed
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Pp
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Both are accepted by default, so
.Nm
will provide whatever your ISP requires.
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Pp
It should be noted that a login script is rarely (if ever) required
when PAP or CHAP are in use.
.It
Ask your ISP to authenticate your nameserver address(es) with the line
.Bd -literal -offset indent
enable dns
.Ed
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Pp
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
Do
.Em NOT
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
do this if you are running a local DNS unless you also either use
Move a comment to make things a bit more readable. Suggested by: sheldonh Forgotten by: me
2000-03-16 16:28:27 +00:00
.Dq resolv readonly
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
or have
.Dq resolv restore
in
Move a comment to make things a bit more readable. Suggested by: sheldonh Forgotten by: me
2000-03-16 16:28:27 +00:00
.Pa /etc/ppp/ppp.linkdown ,
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
as
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Nm
will simply circumvent its use by entering some nameserver lines in
.Pa /etc/resolv.conf .
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
Please refer to
/etc/ppp/ppp.*.sample -> /usr/share/examples/ppp/ppp.*.sample
1999-02-11 16:34:15 +00:00
.Pa /usr/share/examples/ppp/ppp.conf.sample
Only wait for the redial timeout when the last phone number in the list has been dialed. Alternate number dialing has no "pause". Suggested by: joerg Document this behaviour. Document that the number of dial attempts applies to the number of phone calls rather than the number of times each number is dialed. Add a missing .El. Give a decent description of how to connect to an ISP.
1997-04-12 22:58:41 +00:00
and
/etc/ppp/ppp.*.sample -> /usr/share/examples/ppp/ppp.*.sample
1999-02-11 16:34:15 +00:00
.Pa /usr/share/examples/ppp/ppp.linkup.sample
A few more hard-sentence breaks.
2000-06-13 10:03:28 +00:00
for some real examples.
The pmdemand label should be appropriate for most ISPs.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Sh LOGGING FACILITY
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
is able to generate the following log info either via
.Xr syslog 3
or directly to the screen:
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
.Pp
.Bl -tag -width XXXXXXXXX -offset XXX -compact
Add ``all'' logging. Submitted by: eivind
2000-10-30 00:15:35 +00:00
.It Li All
Enable all logging facilities.
This generates a lot of log.
The most common use of 'all' is as a basis, where you remove some facilities
after enabling 'all' ('debug' and 'timer' are usually best disabled.)
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
.It Li Async
Dump async level packet in hex.
.It Li CBCP
Generate CBCP (CallBack Control Protocol) logs.
.It Li CCP
Generate a CCP packet trace.
.It Li Chat
Generate
.Sq dial ,
Introduce ``set logout''; another chat script. This is in preparation for the abstraction of ``set dial'' and ``set hangup''.
1999-10-25 13:49:44 +00:00
.Sq login ,
.Sq logout
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
and
.Sq hangup
chat script trace logs.
.It Li Command
Log commands executed either from the command line or any of the configuration
files.
.It Li Connect
Log Chat lines containing the string "CONNECT".
.It Li Debug
Log debug information.
Add ``set log dns'' to log DNS QUERY packets. This is invaluable for dial-on-demand connections... In ppp.linkup: set log -dns -tcp/ip and in ppp.linkdown set log +dns +tcp/ip giving a much better account of why the link came up.
2000-03-14 01:46:49 +00:00
.It Li DNS
Log DNS QUERY packets.
Add LogFILTER logging to log packets allowed by the dial filter and dropped by any filter. Submitted by: Mark Hannon <markhannon@one.net.au> with some small tweaks by me.
2000-08-28 23:24:52 +00:00
.It Li Filter
Log packets permitted by the dial filter and denied by any filter.
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
.It Li HDLC
Dump HDLC packet in hex.
.It Li ID0
Log all function calls specifically made as user id 0.
.It Li IPCP
Generate an IPCP packet trace.
.It Li LCP
Generate an LCP packet trace.
.It Li LQM
Generate LQR reports.
.It Li Phase
Phase transition log output.
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.It Li Physical
Dump physical level packet in hex.
Support a ``set rad_alive N'' command to enable periodic RADIUS accounting information being sent to the RADIUS server. Logging of RADIUS accounting information moves to a ``set log [+-]radius'' level, along with the RADIUS alive info, and the version number is bumped to 3.2 to reflect this. Mostly submitted by: alx@sm.ukrtel.net (back in January) MFC after: 3 weeks
2004-07-17 01:07:53 +00:00
.It Li Radius
Dump RADIUS information.
RADIUS information resulting from the link coming up or down is logged at
.Dq Phase
level unless
.Dq Radius
logging is enabled.
This log level is most useful for monitoring RADIUS alive information.
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.It Li Sync
Dump sync level packet in hex.
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
.It Li TCP/IP
Dump all TCP/IP packets.
.It Li Timer
Log timer manipulation.
.It Li TUN
Include the tun device on each log line.
.It Li Warning
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Output to the terminal device.
If there is currently no terminal,
Correct some formatting errors (one is a groff bug) Noted & partially submitted by: Peter Jeremy <peter.jeremy@auss2.alcatel.com.au> PR: 9432
1999-01-11 15:05:39 +00:00
output is sent to the log file using syslogs
.Dv LOG_WARNING .
.It Li Error
Output to both the terminal device
and the log file using syslogs
.Dv LOG_ERROR .
.It Li Alert
Output to the log file using
.Dv LOG_ALERT .
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
The
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq set log
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command allows you to set the logging output level.
Multiple levels can be specified on a single command line.
The default is equivalent to
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set log Phase .
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
It is also possible to log directly to the screen.
The syntax is the same except that the word
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Dq local
should immediately follow
.Dq set log .
The default is
.Dq set log local
Fix some typos Obtained from: OpenBSD
2000-03-14 01:47:13 +00:00
(i.e., only the un-maskable warning, error and alert output).
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
If The first argument to
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Dq set log Op local
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
begins with a
.Sq +
or a
.Sq -
character, the current log levels are
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
not cleared, for example:
.Bd -literal -offset indent
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
PPP ON awfulhak> set log phase
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
PPP ON awfulhak> show log
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Log: Phase Warning Error Alert
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
Local: Warning Error Alert
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
PPP ON awfulhak> set log +tcp/ip -warning
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
PPP ON awfulhak> set log local +command
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
PPP ON awfulhak> show log
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Log: Phase TCP/IP Warning Error Alert
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
Local: Command Warning Error Alert
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Ed
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Pp
Log messages of level Warning, Error and Alert are not controllable
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
using
Introduce [local] to "set log [local] ...". This spits logging out to the screen in terminal mode - should be good for installation problem diagnosis.
1997-11-04 01:17:05 +00:00
.Dq set log Op local .
.Pp
The
.Ar Warning
level is special in that it will not be logged if it can be displayed
locally.
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
.Sh SIGNAL HANDLING
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
deals with the following signals:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width "USR2"
Make HUP cause an exit (as it used to), and make INT cause a hangup - not exiting for -ddial & -auto. HUP must exit because init sends this at system shutdown time (why, I don't know), and we don't want to end up redialing after the HUP (due to another dfilter packet). Pointed out by and discussed with: ache
1997-07-01 21:31:28 +00:00
.It INT
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
Receipt of this signal causes the termination of the current connection
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
(if any).
This will cause
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
.Nm
to exit unless it is in
.Fl auto
or
.Fl ddial
Make HUP cause an exit (as it used to), and make INT cause a hangup - not exiting for -ddial & -auto. HUP must exit because init sends this at system shutdown time (why, I don't know), and we don't want to end up redialing after the HUP (due to another dfilter packet). Pointed out by and discussed with: ache
1997-07-01 21:31:28 +00:00
mode.
.It HUP, TERM & QUIT
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
These signals tell
.Nm
to exit.
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
.It USR1
This signal, tells
.Nm
to re-open any existing server socket, dropping all existing diagnostic
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
connections.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
Sockets that could not previously be opened will be retried.
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
.It USR2
This signal, tells
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
to close any existing server socket, dropping all existing diagnostic
connections.
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
.Dv SIGUSR1
can still be used to re-open the socket.
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
.El
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Sh MULTI-LINK PPP
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
If you wish to use more than one physical link to connect to a
.Em PPP
peer, that peer must also understand the
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Em MULTI-LINK PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
protocol.
Refer to RFC 1990 for specification details.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
The peer is identified using a combination of his
.Dq endpoint discriminator
and his
.Dq authentication id .
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Either or both of these may be specified.
It is recommended that
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
at least one is specified, otherwise there is no way of ensuring that
all links are actually connected to the same peer program, and some
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
confusing lock-ups may result.
Locally, these identification variables are specified using the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set enddisc
and
.Dq set authname
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
commands.
The
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq authname
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(and
.Sq authkey )
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
must be agreed in advance with the peer.
.Pp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
Multi-link capabilities are enabled using the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set mrru
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command (set maximum reconstructed receive unit).
Once multi-link is enabled,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
will attempt to negotiate a multi-link connection with the peer.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
By default, only one
.Sq link
is available
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(called
.Sq deflink ) .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
To create more links, the
.Dq clone
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command is used.
This command will clone existing links, where all
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
characteristics are the same except:
.Bl -enum
.It
The new link has its own name as specified on the
.Dq clone
command line.
.It
The new link is an
.Sq interactive
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
link.
Its mode may subsequently be changed using the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set mode
command.
.It
The new link is in a
.Sq closed
state.
.El
.Pp
A summary of all available links can be seen using the
.Dq show links
command.
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Once a new link has been created, command usage varies.
All link specific commands must be prefixed with the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq link Ar name
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command, specifying on which link the command is to be applied.
When only a single link is available,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
is smart enough not to require the
.Dq link Ar name
prefix.
.Pp
Some commands can still be used without specifying a link - resulting
in an operation at the
.Sq bundle
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
level.
For example, once two or more links are available, the command
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq show ccp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
will show CCP configuration and statistics at the multi-link level, and
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq link deflink show ccp
will show the same information at the
.Dq deflink
link level.
.Pp
Armed with this information, the following configuration might be used:
.Bd -literal -offset indent
mp:
set timeout 0
set log phase chat
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
set device /dev/cuau0 /dev/cuau1 /dev/cuau2
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
set phone "123456789"
set dial "ABORT BUSY ABORT NO\\sCARRIER TIMEOUT 5 \\"\\" ATZ \e
OK-AT-OK \\\\dATDT\\\\T TIMEOUT 45 CONNECT"
set login
Add some comments to two examples and extend a ``set ifaddr''.
2001-03-28 00:23:30 +00:00
set ifaddr 10.0.0.1/0 10.0.0.2/0 0.0.0.0 0.0.0.0
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
set authname ppp
set authkey ppppassword
set mrru 1500
Add some comments to two examples and extend a ``set ifaddr''.
2001-03-28 00:23:30 +00:00
clone 1,2,3 # Create 3 new links - duplicates of the default
link deflink remove # Delete the default link (called ``deflink'')
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ed
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Note how all cloning is done at the end of the configuration.
Usually, the link will be configured first, then cloned.
If you wish all links
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
to be up all the time, you can add the following line to the end of your
configuration.
.Bd -literal -offset indent
link 1,2,3 set mode ddial
.Ed
.Pp
If you want the links to dial on demand, this command could be used:
.Bd -literal -offset indent
link * set mode auto
.Ed
.Pp
Links may be tied to specific names by removing the
.Dq set device
line above, and specifying the following after the
.Dq clone
command:
.Bd -literal -offset indent
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
link 1 set device /dev/cuau0
link 2 set device /dev/cuau1
link 3 set device /dev/cuau2
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ed
.Pp
Use the
.Dq help
command to see which commands require context (using the
.Dq link
command), which have optional
context and which should not have any context.
.Pp
When
.Nm
has negotiated
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Em MULTI-LINK
mode with the peer, it creates a local domain socket in the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pa /var/run
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
directory.
This socket is used to pass link information (including
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
the actual link file descriptor) between different
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
invocations.
This facilitates
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
ability to be run from a
.Xr getty 8
or directly from
.Pa /etc/gettydefs
(using the
.Sq pp=
capability), without needing to have initial control of the serial
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
line.
Once
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
negotiates multi-link mode, it will pass its open link to any
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
already running process.
If there is no already running process,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will act as the master, creating the socket and listening for new
connections.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Sh PPP COMMAND LIST
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This section lists the available commands and their effect.
They are usable either from an interactive
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Nm
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
session, from a configuration file or from a
.Xr pppctl 8
or
.Xr telnet 1
session.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It accept|deny|enable|disable Ar option....
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
These directives tell
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
how to negotiate the initial connection with the peer.
Each
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq option
has a default of either accept or deny and enable or disable.
.Dq Accept
means that the option will be ACK'd if the peer asks for it.
.Dq Deny
means that the option will be NAK'd if the peer asks for it.
.Dq Enable
means that the option will be requested by us.
.Dq Disable
means that the option will not be requested by us.
.Pp
.Dq Option
may be one of the following:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.It acfcomp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
ACFComp stands for Address and Control Field Compression.
Non LCP packets will usually have an address
Mention ``show mp''. Describe ACFComp correctly.
1999-05-02 08:52:50 +00:00
field of 0xff (the All-Stations address) and a control field of
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
0x03 (the Unnumbered Information command).
If this option is
Mention ``show mp''. Describe ACFComp correctly.
1999-05-02 08:52:50 +00:00
negotiated, these two bytes are simply not sent, thus minimising
traffic.
.Pp
See
.Pa rfc1662
for details.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It chap Ns Op \&05
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled and Accepted.
CHAP stands for Challenge Handshake Authentication Protocol.
Only one of CHAP and PAP (below) may be negotiated.
With CHAP, the authenticator sends a "challenge" message to its peer.
The peer uses a one-way hash function to encrypt the
challenge and sends the result back.
The authenticator does the same, and compares the results.
The advantage of this mechanism is that no
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
passwords are sent across the connection.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
A challenge is made when the connection is first made.
Subsequent challenges may occur.
If you want to have your peer authenticate itself, you must
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Dq enable chap .
in
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf ,
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
and have an entry in
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.secret
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
for the peer.
.Pp
When using CHAP as the client, you need only specify
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq AuthName
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
and
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq AuthKey
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
in
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf .
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
CHAP is accepted by default.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Some
.Em PPP
implementations use "MS-CHAP" rather than MD5 when encrypting the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
challenge.
MS-CHAP is a combination of MD4 and DES.
If
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Nm
was built on a machine with DES libraries available, it will respond
to MS-CHAP authentication requests, but will never request them.
Abstract the CCP layer a level. Add DEFLATE support.
1997-12-03 10:23:54 +00:00
.It deflate
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
This option decides if deflate
Abstract the CCP layer a level. Add DEFLATE support.
1997-12-03 10:23:54 +00:00
compression will be used by the Compression Control Protocol (CCP).
This is the same algorithm as used by the
.Xr gzip 1
program.
Fix the CCP Type field value for DEFLATE. (I *really* meant to do this *before* committing the deflate changes in the first place - oops). Pppd is horribly broken in this respect - refer to the ppp man page for details. Ppp *WON'T* negotiate deflate with pppd by default - you must ``enable'' and ``accept'' ``pppd-deflate'' in your config. While I'm in there, update the cftypes in ccp.c so that we recognise some more protocols (we don't actually do anything with them - just send a REJ).
1997-12-03 23:28:02 +00:00
Note: There is a problem negotiating
.Ar deflate
capabilities with
Don't refer to pppd(8).
2009-12-28 09:37:33 +00:00
.Nm pppd
Fix the CCP Type field value for DEFLATE. (I *really* meant to do this *before* committing the deflate changes in the first place - oops). Pppd is horribly broken in this respect - refer to the ppp man page for details. Ppp *WON'T* negotiate deflate with pppd by default - you must ``enable'' and ``accept'' ``pppd-deflate'' in your config. While I'm in there, update the cftypes in ccp.c so that we recognise some more protocols (we don't actually do anything with them - just send a REJ).
1997-12-03 23:28:02 +00:00
- a
.Em PPP
implementation available under many operating systems.
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm pppd
Fix the CCP Type field value for DEFLATE. (I *really* meant to do this *before* committing the deflate changes in the first place - oops). Pppd is horribly broken in this respect - refer to the ppp man page for details. Ppp *WON'T* negotiate deflate with pppd by default - you must ``enable'' and ``accept'' ``pppd-deflate'' in your config. While I'm in there, update the cftypes in ccp.c so that we recognise some more protocols (we don't actually do anything with them - just send a REJ).
1997-12-03 23:28:02 +00:00
(version 2.3.1) incorrectly attempts to negotiate
.Ar deflate
compression using type
.Em 24
as the CCP configuration type rather than type
.Em 26
as specified in
.Pa rfc1979 .
Type
.Ar 24
is actually specified as
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Dq PPP Magna-link Variable Resource Compression
Fix the CCP Type field value for DEFLATE. (I *really* meant to do this *before* committing the deflate changes in the first place - oops). Pppd is horribly broken in this respect - refer to the ppp man page for details. Ppp *WON'T* negotiate deflate with pppd by default - you must ``enable'' and ``accept'' ``pppd-deflate'' in your config. While I'm in there, update the cftypes in ccp.c so that we recognise some more protocols (we don't actually do anything with them - just send a REJ).
1997-12-03 23:28:02 +00:00
in
mdoc(7) police: Removed redundant .Ns calls.
2002-08-13 16:07:28 +00:00
.Pa rfc1975 !
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Fix the CCP Type field value for DEFLATE. (I *really* meant to do this *before* committing the deflate changes in the first place - oops). Pppd is horribly broken in this respect - refer to the ppp man page for details. Ppp *WON'T* negotiate deflate with pppd by default - you must ``enable'' and ``accept'' ``pppd-deflate'' in your config. While I'm in there, update the cftypes in ccp.c so that we recognise some more protocols (we don't actually do anything with them - just send a REJ).
1997-12-03 23:28:02 +00:00
is capable of negotiating with
.Nm pppd ,
but only if
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq deflate24
Fix the CCP Type field value for DEFLATE. (I *really* meant to do this *before* committing the deflate changes in the first place - oops). Pppd is horribly broken in this respect - refer to the ppp man page for details. Ppp *WON'T* negotiate deflate with pppd by default - you must ``enable'' and ``accept'' ``pppd-deflate'' in your config. While I'm in there, update the cftypes in ccp.c so that we recognise some more protocols (we don't actually do anything with them - just send a REJ).
1997-12-03 23:28:02 +00:00
is
.Ar enable Ns No d
and
.Ar accept Ns No ed .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It deflate24
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled and Denied.
This is a variance of the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar deflate
option, allowing negotiation with the
Don't refer to pppd(8).
2009-12-28 09:37:33 +00:00
.Nm pppd
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
program.
Refer to the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar deflate
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
section above for details.
It is disabled by default as it violates
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pa rfc1975 .
.It dns
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled and Denied.
This option allows DNS negotiation.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
If
.Dq enable Ns No d,
.Nm
will request that the peer confirms the entries in
.Pa /etc/resolv.conf .
If the peer NAKs our request (suggesting new IP numbers),
.Pa /etc/resolv.conf
is updated and another request is sent to confirm the new entries.
.Pp
If
.Dq accept Ns No ed,
.Nm
will answer any DNS queries requested by the peer rather than rejecting
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
them.
The answer is taken from
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pa /etc/resolv.conf
unless the
.Dq set dns
command is used as an override.
Allow our endpoint discriminator to be enabled, disabled, accepted and denied. This is necessary for some MP implementations that get confused if you accept their endpoint discriminator but reject their MRRU.
1999-06-09 16:54:04 +00:00
.It enddisc
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
This option allows control over whether we
negotiate an endpoint discriminator.
We only send our discriminator if
Allow our endpoint discriminator to be enabled, disabled, accepted and denied. This is necessary for some MP implementations that get confused if you accept their endpoint discriminator but reject their MRRU.
1999-06-09 16:54:04 +00:00
.Dq set enddisc
is used and
.Ar enddisc
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is enabled.
We reject the peers discriminator if
Allow our endpoint discriminator to be enabled, disabled, accepted and denied. This is necessary for some MP implementations that get confused if you accept their endpoint discriminator but reject their MRRU.
1999-06-09 16:54:04 +00:00
.Ar enddisc
is denied.
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
.It LANMan|chap80lm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled and Accepted.
The use of this authentication protocol
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
is discouraged as it partially violates the authentication protocol by
implementing two different mechanisms (LANMan & NT) under the guise of
a single CHAP type (0x80).
.Dq LANMan
uses a simple DES encryption mechanism and is the least secure of the
CHAP alternatives (although is still more secure than PAP).
.Pp
Refer to the
.Dq MSChap
description below for more details.
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.It lqr
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled and Accepted.
This option decides if Link Quality Requests will be sent or accepted.
LQR is a protocol that allows
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.Nm
to determine that the link is down without relying on the modems
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
carrier detect.
When LQR is enabled,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
sends the
.Em QUALPROTO
option (see
.Dq set lqrperiod
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
below) as part of the LCP request.
If the peer agrees, both sides will
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
exchange LQR packets at the agreed frequency, allowing detailed link
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
quality monitoring by enabling LQM logging.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
If the peer does not agree, and if the
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
.Dq echo
option is enabled,
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
.Nm
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
will send
.Em LCP ECHO
requests instead.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
These packets pass no information of interest, but they
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em MUST
be replied to by the peer.
.Pp
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
Whether using
.Em LQR
or
.Em LCP ECHO ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will abruptly drop the connection if 5 unacknowledged packets have been
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
sent rather than sending a 6th.
A message is logged at the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em PHASE
level, and any appropriate
.Dq reconnect
values are honoured as if the peer were responsible for dropping the
connection.
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
.Pp
Refer to the
.Dq enable echo
command description for differences in behaviour prior to
.Nm
version 3.4.2.
Add MPPE and MSChap v2 support (denied and disabled by default) Submitted by: Ustimenko Semen <semen@iclub.nsu.ru>
2000-10-30 00:15:04 +00:00
.It mppe
Correct the documented default behaviour of mschap, mschap81 and MPPE. Pointed out by: Mark Knight <markk@knigma.org>
2000-12-15 01:09:38 +00:00
Default: Enabled and Accepted.
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
This is Microsoft Point to Point Encryption scheme.
Remove whitespace at EOL.
2001-07-15 08:06:20 +00:00
MPPE key size can be
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
40-, 56- and 128-bits.
Refer to
Add MPPE and MSChap v2 support (denied and disabled by default) Submitted by: Ustimenko Semen <semen@iclub.nsu.ru>
2000-10-30 00:15:04 +00:00
.Dq set mppe
command.
.It MSChapV2|chap81
Correct the documented default behaviour of mschap, mschap81 and MPPE. Pointed out by: Mark Knight <markk@knigma.org>
2000-12-15 01:09:38 +00:00
Default: Disabled and Accepted.
Add MPPE and MSChap v2 support (denied and disabled by default) Submitted by: Ustimenko Semen <semen@iclub.nsu.ru>
2000-10-30 00:15:04 +00:00
It is very similar to standard CHAP (type 0x05)
except that it issues challenges of a fixed 16 bytes in length and uses a
combination of MD4, SHA-1 and DES to encrypt the challenge rather than using the
standard MD5 mechanism.
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
.It MSChap|chap80nt
Add a missing dot.
2000-12-15 07:34:01 +00:00
Default: Disabled and Accepted.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
The use of this authentication protocol
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
is discouraged as it partially violates the authentication protocol by
implementing two different mechanisms (LANMan & NT) under the guise of
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
a single CHAP type (0x80).
It is very similar to standard CHAP (type 0x05)
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
except that it issues challenges of a fixed 8 bytes in length and uses a
combination of MD4 and DES to encrypt the challenge rather than using the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
standard MD5 mechanism.
CHAP type 0x80 for LANMan is also supported - see
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
.Dq enable LANMan
for details.
.Pp
Because both
.Dq LANMan
and
.Dq NT
use CHAP type 0x80, when acting as authenticator with both
.Dq enable Ns No d ,
.Nm
will rechallenge the peer up to three times if it responds using the wrong
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
one of the two protocols.
This gives the peer a chance to attempt using both protocols.
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
.Pp
Conversely, when
.Nm
acts as the authenticatee with both protocols
.Dq accept Ns No ed ,
the protocols are used alternately in response to challenges.
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Note: If only LANMan is enabled,
Don't refer to pppd(8).
2009-12-28 09:37:33 +00:00
.Nm pppd
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
(version 2.3.5) misbehaves when acting as authenticatee.
It provides both
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
the NT and the LANMan answers, but also suggests that only the NT answer
should be used.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It pap
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled and Accepted.
PAP stands for Password Authentication Protocol.
Only one of PAP and CHAP (above) may be negotiated.
With PAP, the ID and Password are sent repeatedly to the peer until
authentication is acknowledged or the connection is terminated.
This is a rather poor security mechanism.
It is only performed when the connection is first established.
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
If you want to have your peer authenticate itself, you must
.Dq enable pap .
in
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf ,
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
and have an entry in
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.secret
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
for the peer (although see the
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq passwdauth
Fully support both NT and LANMan CHAP type 0x80 as both authenticator and authenticatee.
1999-02-18 00:52:15 +00:00
and
.Dq set radius
options below).
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Pp
When using PAP as the client, you need only specify
.Dq AuthName
and
.Dq AuthKey
in
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.conf .
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
PAP is accepted by default.
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.It pred1
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
This option decides if Predictor 1
Abstract the CCP layer a level. Add DEFLATE support.
1997-12-03 10:23:54 +00:00
compression will be used by the Compression Control Protocol (CCP).
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It protocomp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
This option is used to negotiate
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
PFC (Protocol Field Compression), a mechanism where the protocol
field number is reduced to one octet rather than two.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It shortseq
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
This option determines if
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will request and accept requests for short
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(12 bit)
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
sequence numbers when negotiating multi-link mode.
This is only applicable if our MRRU is set (thus enabling multi-link).
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.It vjcomp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled and Accepted.
This option determines if Van Jacobson header compression will be used.
Don't allow accept/deny when it's not appropriate. Log PAP/CHAP users in utmp & wtmp, allowing it to be avoided with "disable utmp"
1997-09-22 23:59:16 +00:00
.El
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.Pp
Don't allow accept/deny when it's not appropriate. Log PAP/CHAP users in utmp & wtmp, allowing it to be avoided with "disable utmp"
1997-09-22 23:59:16 +00:00
The following options are not actually negotiated with the peer.
Therefore, accepting or denying them makes no sense.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
.It echo
Default: Disabled.
When this option is enabled,
.Nm
will send
.Em LCP ECHO
requests to the peer at the frequency defined by
.Dq echoperiod .
Note,
.Em LQR
requests will supersede
.Em LCP ECHO
requests if enabled and negotiated.
See
.Dq set lqrperiod
below for details.
.Pp
Prior to
.Nm
version 3.4.2,
.Dq echo
was considered enabled if lqr was enabled and negotiated, otherwise it was
considered disabled.
For the same behaviour, it is now necessary to
.Dq enable lqr echo
rather than just
.Dq enable lqr .
o Log the (payload/size) of all packet types, not just TCP packets o If the new ``filter-decapsulation'' is enabled, delve into UDP packets that contain 0xff 0x03 as the first two bytes, and if we recognise it as PROTO_IP, decapsulate it for the purpose of filter checking. If we recognise it as PROTO_<anything else> mention this for logging purposes only. This change is aimed at people running PPPoUDP where the UDP traffic is being sent over another PPP link. It's desireable to have the top level link connected all the time, but to have the bottom level link capable of decapsulating the traffic and comparing the payload against the filters, thus allowing ``set filter dial ...'' to work in tunnelled environments. The caveat here is that the top ppp cannot employ any compression layers without making the data unreadable for the bottom ppp. ``disable deflate pred1 vj'' and ``deny deflate pred1 vj'' is suggested.
2000-07-07 14:22:08 +00:00
.It filter-decapsulation
Default: Disabled.
When this option is enabled,
.Nm
will examine UDP frames to see if they actually contain a
.Em PPP
Some gratuitous whitespace changes.
2000-11-19 16:58:59 +00:00
frame as their payload.
If this is the case, all filters will operate on the payload rather
than the actual packet.
o Log the (payload/size) of all packet types, not just TCP packets o If the new ``filter-decapsulation'' is enabled, delve into UDP packets that contain 0xff 0x03 as the first two bytes, and if we recognise it as PROTO_IP, decapsulate it for the purpose of filter checking. If we recognise it as PROTO_<anything else> mention this for logging purposes only. This change is aimed at people running PPPoUDP where the UDP traffic is being sent over another PPP link. It's desireable to have the top level link connected all the time, but to have the bottom level link capable of decapsulating the traffic and comparing the payload against the filters, thus allowing ``set filter dial ...'' to work in tunnelled environments. The caveat here is that the top ppp cannot employ any compression layers without making the data unreadable for the bottom ppp. ``disable deflate pred1 vj'' and ``deny deflate pred1 vj'' is suggested.
2000-07-07 14:22:08 +00:00
.Pp
This is useful if you want to send PPPoUDP traffic over a
.Em PPP
link, but want that link to do smart things with the real data rather than
the UDP wrapper.
.Pp
The UDP frame payload must not be compressed in any way, otherwise
.Nm
Some gratuitous whitespace changes.
2000-11-19 16:58:59 +00:00
will not be able to interpret it.
Expand contractions.
2005-02-13 23:45:54 +00:00
It is therefore recommended that you
o Log the (payload/size) of all packet types, not just TCP packets o If the new ``filter-decapsulation'' is enabled, delve into UDP packets that contain 0xff 0x03 as the first two bytes, and if we recognise it as PROTO_IP, decapsulate it for the purpose of filter checking. If we recognise it as PROTO_<anything else> mention this for logging purposes only. This change is aimed at people running PPPoUDP where the UDP traffic is being sent over another PPP link. It's desireable to have the top level link connected all the time, but to have the bottom level link capable of decapsulating the traffic and comparing the payload against the filters, thus allowing ``set filter dial ...'' to work in tunnelled environments. The caveat here is that the top ppp cannot employ any compression layers without making the data unreadable for the bottom ppp. ``disable deflate pred1 vj'' and ``deny deflate pred1 vj'' is suggested.
2000-07-07 14:22:08 +00:00
.Ic disable vj pred1 deflate
and
.Ic deny vj pred1 deflate
in the configuration for the
.Nm
invocation with the udp link.
Add a ``force-scripts'' option for using chat scripts with -direct and -dedicated links. Submitted by: Maksim Yevmenkin <myevmenk@exodus.net>
2003-03-26 02:03:08 +00:00
.It force-scripts
Default: Disabled.
Forces execution of the configured chat scripts in
Erase whitespace at EOL. Approved by: re (blanket)
2003-05-22 11:56:41 +00:00
.Dv direct
Add a ``force-scripts'' option for using chat scripts with -direct and -dedicated links. Submitted by: Maksim Yevmenkin <myevmenk@exodus.net>
2003-03-26 02:03:08 +00:00
and
Erase whitespace at EOL. Approved by: re (blanket)
2003-05-22 11:56:41 +00:00
.Dv dedicated
Add a ``force-scripts'' option for using chat scripts with -direct and -dedicated links. Submitted by: Maksim Yevmenkin <myevmenk@exodus.net>
2003-03-26 02:03:08 +00:00
modes.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It idcheck
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled.
When
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
exchanges low-level LCP, CCP and IPCP configuration traffic, the
.Em Identifier
field of any replies is expected to be the same as that of the request.
By default,
.Nm
drops any reply packets that do not contain the expected identifier
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
field, reporting the fact at the respective log level.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar idcheck
is disabled,
.Nm
will ignore the identifier field.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It iface-alias
Default: Enabled if
.Fl nat
is specified.
This option simply tells
.Nm
to add new interface addresses to the interface rather than replacing them.
The option can only be enabled if network address translation is enabled
.Pq Dq nat enable yes .
.Pp
With this option enabled,
.Nm
mdoc(7) police: markup nit, removed whitespace at EOL.
2001-08-16 08:26:04 +00:00
will pass traffic for old interface addresses through the NAT
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
engine
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
(see
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
.Xr libalias 3 ) ,
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
resulting in the ability (in
.Fl auto
mode) to properly connect the process that caused the PPP link to
come up in the first place.
.Pp
Disabling NAT with
.Dq nat enable no
will also disable
.Sq iface-alias .
.It ipcp
Default: Enabled.
This option allows
.Nm
to attempt to negotiate IP control protocol capabilities and if
successful to exchange IP datagrams with the peer.
.It ipv6cp
Default: Enabled.
This option allows
.Nm
to attempt to negotiate IPv6 control protocol capabilities and if
successful to exchange IPv6 datagrams with the peer.
Introduce the ``keep-session'' option. Refer to the man page for details. This allows MP over non-tty devices where the original ppp process must not exit (such as sshd-spawned ppp sessions).
1999-06-02 00:46:55 +00:00
.It keep-session
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled.
When
Introduce the ``keep-session'' option. Refer to the man page for details. This allows MP over non-tty devices where the original ppp process must not exit (such as sshd-spawned ppp sessions).
1999-06-02 00:46:55 +00:00
.Nm
runs as a Multi-link server, a different
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
instance initially receives each connection.
After determining that
Introduce the ``keep-session'' option. Refer to the man page for details. This allows MP over non-tty devices where the original ppp process must not exit (such as sshd-spawned ppp sessions).
1999-06-02 00:46:55 +00:00
the link belongs to an already existing bundle (controlled by another
.Nm
invocation),
.Nm
will transfer the link to that process.
.Pp
If the link is a tty device or if this option is enabled,
.Nm
will not exit, but will change its process name to
.Dq session owner
and wait for the controlling
.Nm
to finish with the link and deliver a signal back to the idle process.
This prevents the confusion that results from
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
Introduce the ``keep-session'' option. Refer to the man page for details. This allows MP over non-tty devices where the original ppp process must not exit (such as sshd-spawned ppp sessions).
1999-06-02 00:46:55 +00:00
parent considering the link resource available again.
.Pp
For tty devices that have entries in
.Pa /etc/ttys ,
this is necessary to prevent another
.Xr getty 8
from being started, and for program links such as
.Xr sshd 8 ,
it prevents
.Xr sshd 8
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
from exiting due to the death of its child.
As
Introduce the ``keep-session'' option. Refer to the man page for details. This allows MP over non-tty devices where the original ppp process must not exit (such as sshd-spawned ppp sessions).
1999-06-02 00:46:55 +00:00
.Nm
cannot determine its parents requirements (except for the tty case), this
option must be enabled manually depending on the circumstances.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It loopback
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled.
When
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar loopback
is enabled,
.Nm
will automatically loop back packets being sent
out with a destination address equal to that of the
Abstract the CCP layer a level. Add DEFLATE support.
1997-12-03 10:23:54 +00:00
.Em PPP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
interface.
If disabled,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will send the packet, probably resulting in an ICMP redirect from
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
the other end.
It is convenient to have this option enabled when
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
the interface is also the default route as it avoids the necessity
of a loopback route.
Send NAS-IP-Address as well as NAS-Identifier Add ``disable NAS-IP-Address'' and ``disable NAS-Identifier'' options to support pre-rfc2865 RADIUS servers. This pushes our enable/disable items over the 32 bit limit, so reoganise things to allow a bunch more options. Go to version 3.4.1 so that any compatability problems can be identified.
2004-11-29 17:11:15 +00:00
.It NAS-IP-Address
Default: Enabled.
This option controls whether
.Nm
sends the
.Dq NAS-IP-Address
attribute to the RADIUS server when RADIUS is in use
.Pq see Dq set radius .
.Pp
Note, at least one of
.Dq NAS-IP-Address
and
.Dq NAS-Identifier
must be enabled.
.Pp
Versions of
.Nm
prior to version 3.4.1 did not send the
.Dq NAS-IP-Address
Fix a typo Obtained from: OpenBSD
2005-09-22 11:18:30 +00:00
attribute as it was reported to break the Radiator RADIUS server.
Send NAS-IP-Address as well as NAS-Identifier Add ``disable NAS-IP-Address'' and ``disable NAS-Identifier'' options to support pre-rfc2865 RADIUS servers. This pushes our enable/disable items over the 32 bit limit, so reoganise things to allow a bunch more options. Go to version 3.4.1 so that any compatability problems can be identified.
2004-11-29 17:11:15 +00:00
As the latest rfc (2865) no longer hints that only one of
.Dq NAS-IP-Address
and
.Dq NAS-Identifier
should be sent (as rfc 2138 did),
.Nm
now sends both and leaves it up to the administrator that chooses to use
bad RADIUS implementations to
.Dq disable NAS-IP-Address .
.It NAS-Identifier
Default: Enabled.
This option controls whether
.Nm
sends the
.Dq NAS-Identifier
attribute to the RADIUS server when RADIUS is in use
.Pq see Dq set radius .
.Pp
Note, at least one of
.Dq NAS-IP-Address
and
.Dq NAS-Identifier
must be enabled.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It passwdauth
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled.
Enabling this option will tell the PAP authentication
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
code to use the password database (see
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr passwd 5 )
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
to authenticate the caller if they cannot be found in the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Pa /etc/ppp/ppp.secret
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
file.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pa /etc/ppp/ppp.secret
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is always checked first.
If you wish to use passwords from
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.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 .
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.It proxy
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Disabled.
Enabling this option will tell
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to proxy ARP for the peer.
This means that
Correct some ntohl/htonl bogons in the netmask handling. This was pretty harmless as netmasks on a POINTOPOINT interface are pretty much ignored, but it looked funny. Mention the configured netmask in ``show ipcp''. Describe in more detail what a proxy arp entry is.
1999-03-03 23:00:41 +00:00
.Nm
will make an entry in the ARP table using
.Dv HISADDR
and the
.Dv MAC
address of the local network in which
.Dv HISADDR
A few more hard-sentence breaks.
2000-06-13 10:03:28 +00:00
appears.
This allows other machines connecteed to the LAN to talk to
the peer as if the peer itself was connected to the LAN.
The proxy entry cannot be made unless
Correct some ntohl/htonl bogons in the netmask handling. This was pretty harmless as netmasks on a POINTOPOINT interface are pretty much ignored, but it looked funny. Mention the configured netmask in ``show ipcp''. Describe in more detail what a proxy arp entry is.
1999-03-03 23:00:41 +00:00
.Dv HISADDR
is an address from a LAN.
Add ``enable proxyall'' support. This adds proxy ARP entries for every machine on every class C or smaller subnet that we route to. Add ``set {send,recv}pipe'' for controlling our socket buffer sizes. Mention the IP number with the problem in a few error messages. All submitted by: Craig Leres <leres@ee.lbl.gov> Modified slightly by: me
1998-10-26 19:07:39 +00:00
.It proxyall
A few more hard-sentence breaks.
2000-06-13 10:03:28 +00:00
Default: Disabled.
Enabling this will tell
Add ``enable proxyall'' support. This adds proxy ARP entries for every machine on every class C or smaller subnet that we route to. Add ``set {send,recv}pipe'' for controlling our socket buffer sizes. Mention the IP number with the problem in a few error messages. All submitted by: Craig Leres <leres@ee.lbl.gov> Modified slightly by: me
1998-10-26 19:07:39 +00:00
.Nm
to add proxy arp entries for every IP address in all class C or
smaller subnets routed via the tun interface.
Correct some ntohl/htonl bogons in the netmask handling. This was pretty harmless as netmasks on a POINTOPOINT interface are pretty much ignored, but it looked funny. Mention the configured netmask in ``show ipcp''. Describe in more detail what a proxy arp entry is.
1999-03-03 23:00:41 +00:00
.Pp
Proxy arp entries are only made for sticky routes that are added
using the
.Dq add
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
No proxy arp entries are made for the interface address itself
Correct some ntohl/htonl bogons in the netmask handling. This was pretty harmless as netmasks on a POINTOPOINT interface are pretty much ignored, but it looked funny. Mention the configured netmask in ``show ipcp''. Describe in more detail what a proxy arp entry is.
1999-03-03 23:00:41 +00:00
(as created by the
.Dq set ifaddr
command).
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It sroutes
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled.
When the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq add
command is used with the
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dv HISADDR ,
.Dv MYADDR ,
.Dv HISADDR6
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dv MYADDR6
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
values, entries are stored in the
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Sq sticky route
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
list.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
Each time these variables change, this list is re-applied to the routing table.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Disabling this option will prevent the re-application of sticky routes,
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
although the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq stick route
list will still be maintained.
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It Oo tcp Oc Ns No mssfixup
Add ``enable/disable tcpmssfixup'', defaulting to enabled. Suggested by: julian Hijacked from: ru (ports/net/tcpmssd)
2000-11-28 13:18:35 +00:00
Default: Enabled.
This option tells
.Nm
TCPMSS adjusts all TCP SYN packets, not just outgoing ones. Pointed out by: ru
2001-07-16 17:02:10 +00:00
to adjust TCP SYN packets so that the maximum receive segment
Add ``enable/disable tcpmssfixup'', defaulting to enabled. Suggested by: julian Hijacked from: ru (ports/net/tcpmssd)
2000-11-28 13:18:35 +00:00
size is not greater than the amount allowed by the interface MTU.
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.It throughput
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled.
This option tells
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
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 relevant
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.Em PPP
layer shuts down, and is also available using the
.Dq show
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
Throughput statistics are available at the
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
.Dq IPCP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
and
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
.Dq physical
Add throughput logging (disabled by default). Use "enable throughput" to see modem & IPCP throughput. Removed an extraneous prompt()
1997-11-18 14:52:08 +00:00
levels.
Don't allow accept/deny when it's not appropriate. Log PAP/CHAP users in utmp & wtmp, allowing it to be avoided with "disable utmp"
1997-09-22 23:59:16 +00:00
.It utmp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Default: Enabled.
Normally, when a user is authenticated using PAP or CHAP, and when
Don't allow accept/deny when it's not appropriate. Log PAP/CHAP users in utmp & wtmp, allowing it to be avoided with "disable utmp"
1997-09-22 23:59:16 +00:00
.Nm
is running in
.Fl direct
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
mode, an entry is made in the utmp and wtmp files for that user.
Disabling this option will tell
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
not to make any utmp or wtmp entries.
This is usually only necessary if
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
you require the user to both login and authenticate themselves.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It add Ns Xo
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op !\&
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar dest Ns Op / Ns Ar nn
.Op Ar mask
.Op Ar gateway
.Xc
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Ar Dest
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is the destination IP address.
The netmask is specified either as a number of bits with
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar /nn
or as an IP number using
.Ar mask .
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Ar 0 0
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or simply
.Ar 0
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
with no mask refers to the default route.
It is also possible to use the literal name
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Sq default
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
instead of
.Ar 0 .
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Ar Gateway
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
is the next hop gateway to get to the given
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Ar dest
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
machine/network.
Refer to the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Xr route 8
command for further details.
.Pp
It is possible to use the symbolic names
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Sq MYADDR ,
.Sq HISADDR ,
.Sq MYADDR6
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Sq HISADDR6
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
as the destination, and
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Sq HISADDR
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
or
.Sq HISADDR6
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
as the
.Ar gateway .
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Sq MYADDR
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
is replaced with the interface IP address,
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Sq HISADDR
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
is replaced with the interface IP destination (peer) address,
.Sq MYADDR6
is replaced with the interface IPv6 address, and
.Sq HISADDR6
is replaced with the interface IPv6 destination address,
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
.Pp
If the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Ar add!\&
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
command is used
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(note the trailing
.Dq !\& ) ,
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
then if the route already exists, it will be updated as with the
.Sq route change
command (see
.Xr route 8
for further details).
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Routes that contain the
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq HISADDR ,
.Dq MYADDR ,
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dq HISADDR6 ,
.Dq MYADDR6 ,
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq DNS0 ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq DNS1
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
constants are considered
.Sq sticky .
They are stored in a list (use
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dq show ncp
to see the list), and each time the value of one of these variables
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
changes, the appropriate routing table entries are updated.
This facility may be disabled using
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq disable sroutes .
.It allow Ar command Op Ar args
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
This command controls access to
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
and its configuration files.
It is possible to allow user-level access,
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
depending on the configuration file label and on the mode that
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is being run in.
For example, you may wish to configure
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Nm
so that only user
.Sq fred
may access label
.Sq fredlabel
in
.Fl background
mode.
.Pp
User id 0 is immune to these commands.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It allow user Ns Xo
.Op s
.Ar logname Ns No ...
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
By default, only user id 0 is allowed access to
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
If this command is used, all of the listed users are allowed access to
the section in which the
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Dq allow users
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command is found.
The
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Sq default
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
section is always checked first (even though it is only ever automatically
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
loaded at startup).
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Dq allow users
Permit multiple ``allow user'' lines in any given section This avoids line length limits when large numbers of users are allowed access to ppp.
2000-07-12 23:13:52 +00:00
commands are cumulative in a given section, but users allowed in any given
Expand contractions.
2005-02-13 23:45:54 +00:00
section override users allowed in the default section, so it is possible to
Permit multiple ``allow user'' lines in any given section This avoids line length limits when large numbers of users are allowed access to ppp.
2000-07-12 23:13:52 +00:00
allow users access to everything except a given label by specifying default
users in the
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Sq default
section, and then specifying a new user list for that label.
.Pp
If user
.Sq *
is specified, access is allowed to all users.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It allow mode Ns Xo
.Op s
.Ar mode Ns No ...
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
By default, access using any
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
mode is possible.
If this command is used, it restricts the access
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar modes
allowed to load the label under which this command is specified.
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
Again, as with the
.Dq allow users
command, each
.Dq allow modes
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
command overrides any previous settings, and the
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.Sq default
section is always checked first.
.Pp
Possible modes are:
.Sq interactive ,
.Sq auto ,
.Sq direct ,
.Sq dedicated ,
.Sq ddial ,
.Sq background
and
.Sq * .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
When running in multi-link mode, a section can be loaded if it allows
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em any
of the currently existing line modes.
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat Ar command Op Ar args
This command allows the control of the network address translation (also
known as masquerading or IP aliasing) facilities that are built into
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
NAT is done on the external interface only, and is unlikely to make sense
if used with the
.Fl direct
flag.
.Pp
If nat is enabled on your system (it may be omitted at compile time),
Don't claim that the alias library isn't loaded until used.
1998-08-29 23:02:43 +00:00
the following commands are possible:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat enable yes|no
This command either switches network address translation on or turns it off.
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
The
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Fl nat
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
command line flag is synonymous with
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.Dq nat enable yes .
.It nat addr Op Ar addr_local addr_alias
Support proxying & transparent proxying curtesy of libalias(3). Order the alias command descriptions. Order the SEE ALSO entries.
1999-03-07 15:02:38 +00:00
This command allows data for
.Ar addr_alias
to be redirected to
.Ar addr_local .
It is useful if you own a small number of real IP numbers that
you wish to map to specific machines behind your gateway.
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat deny_incoming yes|no
Be a bit more precise about what ``nat deny_incoming yes'' does.
2000-11-16 21:50:50 +00:00
If set to yes, this command will refuse all incoming packets where an
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
aliasing link does not already exist.
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
Refer to the
Be a bit more precise about what ``nat deny_incoming yes'' does.
2000-11-16 21:50:50 +00:00
.Sx CONCEPTUAL BACKGROUND
section of
.Xr libalias 3
for a description of what an
.Dq aliasing link
is.
.Pp
mdoc(7) police: markup nit, removed whitespace at EOL.
2001-08-16 08:26:04 +00:00
It should be noted under what circumstances an aliasing link is
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
created by
.Xr libalias 3 .
Be a bit more precise about what ``nat deny_incoming yes'' does.
2000-11-16 21:50:50 +00:00
It may be necessary to further protect your network from outside
connections using the
.Dq set filter
or
.Dq nat target
commands.
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat help|?
This command gives a summary of available nat commands.
.It nat log yes|no
This option causes various NAT statistics and information to
Support proxying & transparent proxying curtesy of libalias(3). Order the alias command descriptions. Order the SEE ALSO entries.
1999-03-07 15:02:38 +00:00
be logged to the file
.Pa /var/log/alias.log .
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat port Ar proto Ar targetIP Ns Xo
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
.No : Ns Ar targetPort Ns
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
.Oo
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
.No - Ns Ar targetPort
.Oc Ar aliasPort Ns
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
.Oo
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
.No - Ns Ar aliasPort
.Oc Oo Ar remoteIP : Ns
.Ar remotePort Ns
.Oo
.No - Ns Ar remotePort
mdoc fixes.
2012-09-08 08:46:43 +00:00
.Oc
Fix for NetBSD where .Oc Oc .Xc doesn't seem to work....
2001-01-22 11:35:00 +00:00
.Oc
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Xc
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
This command causes incoming
.Ar proto
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
connections to
.Ar aliasPort
to be redirected to
.Ar targetPort
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
on
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar targetIP .
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
.Ar proto
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
is either
.Dq tcp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
or
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
.Dq udp .
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
A range of port numbers may be specified as shown above.
The ranges must be of the same size.
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
.Pp
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
If
.Ar remoteIP
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
is specified, only data coming from that IP number is redirected.
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
.Ar remotePort
must either be
.Dq 0
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(indicating any source port)
Allow a remote IP and port range specification in the ``alias port'' command.
1999-06-10 00:17:27 +00:00
or a range of ports the same size as the other ranges.
.Pp
Allow port ranges in ``alias port''.
1999-03-25 23:36:25 +00:00
This option is useful if you wish to run things like Internet phone on
machines behind your gateway, but is limited in that connections to only
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
one interior machine per source machine and target port are possible.
Stay (backwards-)compatible with OpenBSD's groff
2001-07-09 00:13:49 +00:00
.It nat proto Ar proto localIP Oo
.Ar publicIP Op Ar remoteIP
.Oc
Add a ``nat proto'' command -- similar to natd(8)'s -redirect_proto switch. MFC after: 3 weeks
2001-07-09 00:07:56 +00:00
This command tells
.Nm
to redirect packets of protocol type
.Ar proto
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(see
.Xr protocols 5 )
Fix a typo Submitted by: dirk
2002-03-25 14:14:31 +00:00
to the internal address
Add a ``nat proto'' command -- similar to natd(8)'s -redirect_proto switch. MFC after: 3 weeks
2001-07-09 00:07:56 +00:00
.Ar localIP .
.Pp
If
.Ar publicIP
is specified, only packets destined for that address are matched,
otherwise the default alias address is used.
.Pp
If
.Ar remoteIP
is specified, only packets matching that source address are matched,
.Pp
This command is useful for redirecting tunnel endpoints to an internal machine,
for example:
.Pp
.Dl nat proto ipencap 10.0.0.1
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It "nat proxy cmd" Ar arg Ns No ...
Support proxying & transparent proxying curtesy of libalias(3). Order the alias command descriptions. Order the SEE ALSO entries.
1999-03-07 15:02:38 +00:00
This command tells
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to proxy certain connections, redirecting them to a given server.
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
Refer to the description of
Support proxying & transparent proxying curtesy of libalias(3). Order the alias command descriptions. Order the SEE ALSO entries.
1999-03-07 15:02:38 +00:00
.Fn PacketAliasProxyRule
in
.Xr libalias 3
for details of the available commands.
Add a ``nat punch_fw'' command for punching FTP and IRC DCC holes through the firewall.
2001-08-02 10:16:32 +00:00
.It nat punch_fw Op Ar base count
This command tells
.Nm
to punch holes in the firewall for FTP or IRC DCC connections.
This is done dynamically by installing termporary firewall rules which
allow a particular connection (and only that connection) to go through
the firewall.
The rules are removed once the corresponding connection terminates.
.Pp
A maximum of
.Ar count
rules starting from rule number
.Ar base
will be used for punching firewall holes.
The range will be cleared when the
.Dq nat punch_fw
command is run.
.Pp
If no arguments are given, firewall punching is disabled.
Add Cisco Skinny Station protocol support to libalias, natd, and ppp. Skinny is the protocol used by Cisco IP phones to talk to Cisco Call Managers. With this code, one can use a Cisco IP phone behind a FreeBSD NAT gateway. Currently, having the Call Manager behind the NAT gateway is not supported. More information on enabling Skinny support in libalias, natd, and ppp can be found in those applications' manpages. PR: 55843 Reviewed by: ru Approved by: ru MFC after: 30 days
2003-09-23 07:41:55 +00:00
.It nat skinny_port Op Ar port
This command tells
.Nm
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
which TCP port is used by the Skinny Station protocol.
Skinny is used by
Add Cisco Skinny Station protocol support to libalias, natd, and ppp. Skinny is the protocol used by Cisco IP phones to talk to Cisco Call Managers. With this code, one can use a Cisco IP phone behind a FreeBSD NAT gateway. Currently, having the Call Manager behind the NAT gateway is not supported. More information on enabling Skinny support in libalias, natd, and ppp can be found in those applications' manpages. PR: 55843 Reviewed by: ru Approved by: ru MFC after: 30 days
2003-09-23 07:41:55 +00:00
Cisco IP phones to communicate with Cisco Call Managers to setup voice
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
over IP calls.
The typical port used by Skinny is 2000.
Add Cisco Skinny Station protocol support to libalias, natd, and ppp. Skinny is the protocol used by Cisco IP phones to talk to Cisco Call Managers. With this code, one can use a Cisco IP phone behind a FreeBSD NAT gateway. Currently, having the Call Manager behind the NAT gateway is not supported. More information on enabling Skinny support in libalias, natd, and ppp can be found in those applications' manpages. PR: 55843 Reviewed by: ru Approved by: ru MFC after: 30 days
2003-09-23 07:41:55 +00:00
.Pp
If no argument is given, skinny aliasing is disabled.
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat same_ports yes|no
When enabled, this command will tell the network address translation engine to
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
attempt to avoid changing the port number on outgoing packets.
This is useful
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
if you want to support protocols such as RPC and LPD which require
connections to come from a well known port.
Add the ``nat target'' command.
2000-03-31 14:26:23 +00:00
.It nat target Op Ar address
A few more hard-sentence breaks.
2000-06-13 10:03:28 +00:00
Set the given target address or clear it if no address is given.
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
The target address is used by libalias to specify how to NAT incoming packets
by default.
Mention that the default is to let external traffic route to the internal network when NAT is enabled. Allow ``set target MYADDR'' to stop packets at the gateway.
2000-05-11 07:55:44 +00:00
If a target address is not set or if
.Dq default
is given, packets are not altered and are allowed to route to the internal
network.
Use INADDR_NONE with PacketAliasSetTarget() if no args are given to ``nat target'', and suggest the use of ``nat target default'' as an interesting possibility.
2000-03-31 20:42:24 +00:00
.Pp
The target address may be set to
Mention that the default is to let external traffic route to the internal network when NAT is enabled. Allow ``set target MYADDR'' to stop packets at the gateway.
2000-05-11 07:55:44 +00:00
.Dq MYADDR ,
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
in which case libalias will redirect all packets to the interface address.
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat use_sockets yes|no
When enabled, this option tells the network address translation engine to
create a socket so that it can guarantee a correct incoming ftp data or
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
IRC connection.
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
.It nat unregistered_only yes|no
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Only alter outgoing packets with an unregistered source address.
According to RFC 1918, unregistered source addresses
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
are 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16.
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
These commands are also discussed in the file
Add BSD style copyrights (with permission from Charles Mott where appropriate) Deprecate -alias further (after a repo-copy)
2001-06-04 14:38:29 +00:00
.Pa README.nat
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
which comes with the source distribution.
.Pp
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It Oo !\& Oc Ns Xo
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No bg Ar command
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
The given
.Ar command
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
is executed in the background with the following words replaced:
Add variable substitutions for SOCKNAME, IPOCTETSIN, IPOCTETSOUT, IPPACKETSIN, IPPACKETSOUT, IPV6OCTETSIN, IPV6OCTETSOUT, IPV6PACKETSIN, IPV6PACKETSOUT, OCTETSIN, OCTETSOUT, PACKETSIN, PACKETSOUT and SOCKNAME.
2002-04-17 12:38:59 +00:00
.Bl -tag -width COMPILATIONDATE
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.It Li AUTHNAME
This is replaced with the local
.Ar authname
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
value.
See the
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.Dq set authname
command below.
Describe the new VERSION and COMPILATIONDATE macros and mention that the ``ident'' command will expand macros.
2000-07-19 10:14:00 +00:00
.It Li COMPILATIONDATE
Remove __DATE__ so that compiling the same source produces the same binary (for non-static binaries at least).
2006-09-06 06:33:39 +00:00
In previous software revisions, this was replaced with the date on which
Describe the new VERSION and COMPILATIONDATE macros and mention that the ``ident'' command will expand macros.
2000-07-19 10:14:00 +00:00
.Nm
was compiled.
Remove __DATE__ so that compiling the same source produces the same binary (for non-static binaries at least).
2006-09-06 06:33:39 +00:00
This is no longer supported as it breaks the ability to recompile the same
code to produce an exact duplicate of a previous compilation.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li DNS0 & DNS1
Describe the new VERSION and COMPILATIONDATE macros and mention that the ``ident'' command will expand macros.
2000-07-19 10:14:00 +00:00
These are replaced with the primary and secondary nameserver IP numbers.
If nameservers are negotiated by IPCP, the values of these macros will change.
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.It Li ENDDISC
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This is replaced with the local endpoint discriminator value.
See the
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.Dq set enddisc
command below.
.It Li HISADDR
This is replaced with the peers IP number.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It Li HISADDR6
This is replaced with the peers IPv6 number.
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.It Li INTERFACE
Expand contractions.
2005-02-13 23:45:54 +00:00
This is replaced with the name of the interface that is in use.
Add variable substitutions for SOCKNAME, IPOCTETSIN, IPOCTETSOUT, IPPACKETSIN, IPPACKETSOUT, IPV6OCTETSIN, IPV6OCTETSOUT, IPV6PACKETSIN, IPV6PACKETSOUT, OCTETSIN, OCTETSOUT, PACKETSIN, PACKETSOUT and SOCKNAME.
2002-04-17 12:38:59 +00:00
.It Li IPOCTETSIN
This is replaced with the number of IP bytes received since the connection
was established.
.It Li IPOCTETSOUT
This is replaced with the number of IP bytes sent since the connection
was established.
.It Li IPPACKETSIN
This is replaced with the number of IP packets received since the connection
was established.
.It Li IPPACKETSOUT
This is replaced with the number of IP packets sent since the connection
was established.
.It Li IPV6OCTETSIN
This is replaced with the number of IPv6 bytes received since the connection
was established.
.It Li IPV6OCTETSOUT
This is replaced with the number of IPv6 bytes sent since the connection
was established.
.It Li IPV6PACKETSIN
This is replaced with the number of IPv6 packets received since the connection
was established.
.It Li IPV6PACKETSOUT
This is replaced with the number of IPv6 packets sent since the connection
was established.
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.It Li LABEL
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This is replaced with the last label name used.
A label may be specified on the
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.Nm
command line, via the
.Dq load
or
.Dq dial
commands and in the
.Pa ppp.secret
file.
.It Li MYADDR
This is replaced with the IP number assigned to the local interface.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It Li MYADDR6
This is replaced with the IPv6 number assigned to the local interface.
Add variable substitutions for SOCKNAME, IPOCTETSIN, IPOCTETSOUT, IPPACKETSIN, IPPACKETSOUT, IPV6OCTETSIN, IPV6OCTETSOUT, IPV6PACKETSIN, IPV6PACKETSOUT, OCTETSIN, OCTETSOUT, PACKETSIN, PACKETSOUT and SOCKNAME.
2002-04-17 12:38:59 +00:00
.It Li OCTETSIN
This is replaced with the number of bytes received since the connection
was established.
.It Li OCTETSOUT
This is replaced with the number of bytes sent since the connection
was established.
.It Li PACKETSIN
This is replaced with the number of packets received since the connection
was established.
.It Li PACKETSOUT
This is replaced with the number of packets sent since the connection
was established.
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.It Li PEER_ENDDISC
This is replaced with the value of the peers endpoint discriminator.
Add ``PROCESSID'' as a constant expanded when running commands.
1998-10-27 22:53:19 +00:00
.It Li PROCESSID
This is replaced with the current process id.
Add variable substitutions for SOCKNAME, IPOCTETSIN, IPOCTETSOUT, IPPACKETSIN, IPPACKETSOUT, IPV6OCTETSIN, IPV6OCTETSOUT, IPV6PACKETSIN, IPV6PACKETSOUT, OCTETSIN, OCTETSOUT, PACKETSIN, PACKETSOUT and SOCKNAME.
2002-04-17 12:38:59 +00:00
.It Li SOCKNAME
This is replaced with the name of the diagnostic socket.
Document that an UPTIME variable is now available
2001-11-22 01:44:23 +00:00
.It Li UPTIME
This is replaced with the bundle uptime in HH:MM:SS format.
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.It Li USER
This is replaced with the username that has been authenticated with PAP or
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
CHAP.
Normally, this variable is assigned only in -direct mode.
This value is available irrespective of whether utmp logging is enabled.
Add variable substitutions for SOCKNAME, IPOCTETSIN, IPOCTETSOUT, IPPACKETSIN, IPPACKETSOUT, IPV6OCTETSIN, IPV6OCTETSOUT, IPV6PACKETSIN, IPV6PACKETSOUT, OCTETSIN, OCTETSOUT, PACKETSIN, PACKETSOUT and SOCKNAME.
2002-04-17 12:38:59 +00:00
.It Li VERSION
This is replaced with the current version number of
.Nm .
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.El
.Pp
Add ``set proctitle'' for changing argv[0]. All substitutions are done in the same way as command execution. For example, ``set proctitle USER INTERFACE PROCESSID'' would be useful in a -direct profile for identifying who's connected.
1998-10-27 22:53:22 +00:00
These substitutions are also done by the
Add a ``log'' command for logging specific information. Add an ``UPTIME'' variable to indicate the bundle uptime. It's now possible to put something like this in ppp.linkdown for a server setup: MYADDR: log Session closing: User USER, address HISADDR, up UPTIME Fixed some memory leakage with commands that expand words. Made some functions static. Fixed a diagnostic bug (iface add .... SIOCDIFADDR)
2001-11-03 21:45:32 +00:00
.Dq set proctitle ,
.Dq ident
and
.Dq log
commands.
Add ``set proctitle'' for changing argv[0]. All substitutions are done in the same way as command execution. For example, ``set proctitle USER INTERFACE PROCESSID'' would be useful in a -direct profile for identifying who's connected.
1998-10-27 22:53:22 +00:00
.Pp
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
If you wish to pause
Introduce the "bg" command. It's pretty much the same as "shell", but it's in the background.
1997-08-18 20:15:10 +00:00
.Nm
while the command executes, use the
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.Dq shell
Introduce the "bg" command. It's pretty much the same as "shell", but it's in the background.
1997-08-18 20:15:10 +00:00
command instead.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It clear physical|ipcp|ipv6 Op current|overall|peak...
Add the ``clear'' function. Mostly submitted by: "Stephane E. Potvin" <sepotvin@videotron.ca>
1998-06-12 20:12:26 +00:00
Clear the specified throughput values at either the
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.Dq physical ,
Add the ``clear'' function. Mostly submitted by: "Stephane E. Potvin" <sepotvin@videotron.ca>
1998-06-12 20:12:26 +00:00
.Dq ipcp
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
or
.Dq ipv6cp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
level.
If
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
.Dq physical
Add the ``clear'' function. Mostly submitted by: "Stephane E. Potvin" <sepotvin@videotron.ca>
1998-06-12 20:12:26 +00:00
is specified, context must be given (see the
.Dq link
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command below).
If no second argument is given, all values are cleared.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It clone Ar name Ns Xo
.Op \&, Ns Ar name Ns
.No ...
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Clone the specified link, creating one or more new links according to the
.Ar name
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
argument(s).
This command must be used from the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq link
Expand contractions.
2005-02-13 23:45:54 +00:00
command below unless you have only got a single link (in which case that
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
link becomes the default).
Links may be removed using the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq remove
command below.
.Pp
The default link name is
.Dq deflink .
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.It close Op lcp|ccp Ns Op !\&
Make `close lcp' just close the LCP layer and not hangup. This is useful for slirp users that wish to get their shell back after the ppp session. `close' with no args still hangs up as expected. Required by: jmz
1998-06-15 19:05:27 +00:00
If no arguments are given, the relevant protocol layers will be brought
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
down and the link will be closed.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq lcp
Make `close lcp' just close the LCP layer and not hangup. This is useful for slirp users that wish to get their shell back after the ppp session. `close' with no args still hangs up as expected. Required by: jmz
1998-06-15 19:05:27 +00:00
is specified, the LCP layer is brought down, but
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will not bring the link offline.
It is subsequently possible to use
Make `close lcp' just close the LCP layer and not hangup. This is useful for slirp users that wish to get their shell back after the ppp session. `close' with no args still hangs up as expected. Required by: jmz
1998-06-15 19:05:27 +00:00
.Dq term
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(see below)
Make `close lcp' just close the LCP layer and not hangup. This is useful for slirp users that wish to get their shell back after the ppp session. `close' with no args still hangs up as expected. Required by: jmz
1998-06-15 19:05:27 +00:00
to talk to the peer machine if, for example, something like
.Dq slirp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is being used.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq ccp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is specified, only the relevant compression layer is closed.
If the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !\&
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
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
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
further CCP negotiation.
In any event, this command does not disconnect the user from
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
or exit
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
See the
.Dq quit
command below.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It delete Ns Xo
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op !\&
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar dest
.Xc
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
This command deletes the route with the given
.Ar dest
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
IP address.
If
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Ar dest
is specified as
.Sq ALL ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
all non-direct entries in the routing table for the current interface,
and all
.Sq sticky route
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
entries are deleted.
If
Only allow one arg to `delete' - the mask & gateway aren't necessary. Delete AF_LINK routes as well as AF_INET. Allow the word `default' as the arg to `delete' or in place of the first two args (dest & netmask) to `add'. Accept INTERFACE as the third arg to `add'. You can now say `add default interface' to create a default route through the tun interface. It's reported that subsequent bind()s will bind to a broadcast address and not to the address currently assigned to the tun device - this is the first step towards supporting that first connection that was around from before the dynamic IP negotiation....
1997-12-07 04:09:15 +00:00
.Ar dest
is specified as
.Sq default ,
the default route is deleted.
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
.Pp
If the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Ar delete!\&
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
command is used
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(note the trailing
.Dq !\& ) ,
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
.Nm
will not complain if the route does not already exist.
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It dial|call Oo Ar label Oc Ns Xo
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
.No ...
.Xc
This command is the equivalent of
.Dq load label
followed by
.Dq open ,
and is provided for backwards compatibility.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It down Op Ar lcp|ccp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
Bring the relevant layer down ungracefully, as if the underlying layer
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
had become unavailable.
Expand contractions.
2005-02-13 23:45:54 +00:00
It is not considered polite to use this command on
a Finite State Machine that is in the OPEN state.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
If no arguments are
Don't bring the modem offline or hangup when ``down lcp'' is done. Instead, behave like ``close lcp''.
1998-06-16 19:40:28 +00:00
supplied, the entire link is closed (or if no context is given, all links
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
are terminated).
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq lcp
Don't bring the modem offline or hangup when ``down lcp'' is done. Instead, behave like ``close lcp''.
1998-06-16 19:40:28 +00:00
is specified, the
.Em LCP
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
layer is terminated but the device is not brought offline and the link
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is not closed.
If
Don't bring the modem offline or hangup when ``down lcp'' is done. Instead, behave like ``close lcp''.
1998-06-16 19:40:28 +00:00
.Sq ccp
is specified, only the relevant compression layer(s) are terminated.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It help|? Op Ar command
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Show a list of available commands.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar command
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
is specified, show the usage string for that command.
Support link identification from rfc1570 Two new commands are available; ``ident'' and ``sendident''.
2000-07-19 02:10:35 +00:00
.It ident Op Ar text Ns No ...
Identify the link to the peer using
.Ar text .
If
.Ar text
Describe the new VERSION and COMPILATIONDATE macros and mention that the ``ident'' command will expand macros.
2000-07-19 10:14:00 +00:00
is empty, link identification is disabled.
It is possible to use any of the words described for the
.Ic bg
command above.
Refer to the
Support link identification from rfc1570 Two new commands are available; ``ident'' and ``sendident''.
2000-07-19 02:10:35 +00:00
.Ic sendident
command for details of when
.Nm
identifies itself to the peer.
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.It iface Ar command Op args
This command is used to control the interface used by
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Ar Command
may be one of the following:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It iface add Ns Xo
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op !\&
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar addr Ns Op / Ns Ar bits
.Op Ar peer
.Xc
.It iface add Ns Xo
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op !\&
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar addr
.Ar mask
.Ar peer
.Xc
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
Add the given
.Ar addr mask peer
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
combination to the interface.
Instead of specifying
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Ar mask ,
.Ar /bits
can be used
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(with no space between it and
.Ar addr ) .
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
If the given address already exists, the command fails unless the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !\&
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
is used - in which case the previous interface address entry is overwritten
with the new one, allowing a change of netmask or peer address.
Fix the interface alias code. Previously, I was expecting something like tun0: flags=blah 10.0.0.1 -> 10.0.0.100 10.0.0.2 -> 10.0.0.100 10.0.0.3 -> 10.0.0.100 to DTRT, despite the SIOCAIFADDR for each new alias returning -1 & EEXIST while adding the alias anyway. In real life, once we have the second alias with the same destination, nothing will route any more ! Also, because I was ignoring EEXIST, the dynamic IP assignment code was assigning duplicate addresses ('cos it was being lied to by iface_inAdd()). Now we have tun0: flags=blah 10.0.0.1 -> 255.255.255.255 10.0.0.2 -> 10.0.0.100 10.0.0.3 -> 255.255.255.255 This works - stuff bound to 10.1 & 10.3 will be considered alive by the kernel, and when they route back to the tun device, the packets get aliased to 10.2 and go out to 10.100 (as with the original plan). We still see the EEXIST in SIOCAIFADDR, but ignore it when our destination is 255.255.255.255, assuming that the alias *was* actually added. Additionally, ``iface add'' may now optionally be given only the interface address. The mask & destination default to 255.255.255.255.
1998-10-26 19:07:36 +00:00
.Pp
If only
.Ar addr
is specified,
.Ar bits
defaults to
.Dq 32
and
.Ar peer
defaults to
.Dq 255.255.255.255 .
This address (the broadcast address) is the only duplicate peer address that
.Nm
allows.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It iface clear Op INET | INET6
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
If this command is used while
.Nm
Don't delete the primary interface address when ``iface clean'' is used in auto mode while there are no active links.
1998-11-05 21:59:48 +00:00
is in the OPENED state or while in
.Fl auto
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
mode, all addresses except for the NCP negotiated address are deleted
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
from the interface.
If
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Nm
Don't delete the primary interface address when ``iface clean'' is used in auto mode while there are no active links.
1998-11-05 21:59:48 +00:00
is not in the OPENED state and is not in
.Fl auto
mode, all interface addresses are deleted.
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Pp
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
If the INET or INET6 arguments are used, only addresses for that address
family are cleared.
.Pp
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It iface delete Ns Xo
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Op !\& Ns
.No |rm Ns Op !\&
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar addr
.Xc
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
This command deletes the given
.Ar addr
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
from the interface.
If the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !\&
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
is used, no error is given if the address is not currently assigned to
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
the interface (and no deletion takes place).
Add "iface name" and "iface description" commands. PR: 151400 Submitted by: Aragon Gouveia - aragon at phat dot za dot net with minor fixes MFC after: 3 weeks
2011-02-07 11:18:18 +00:00
.It iface name Ar name
Renames the interface to
.Ar name .
.It iface description Ar description
Sets the interface description to
.Ar description .
Useful if you have many interfaces on your system.
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.It iface show
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Shows the current state and current addresses for the interface.
It is much the same as running
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Dq ifconfig INTERFACE .
.It iface help Op Ar sub-command
This command, when invoked without
.Ar sub-command ,
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
will show a list of possible
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Dq iface
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
sub-commands and a brief synopsis for each.
When invoked with
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Ar sub-command ,
only the synopsis for the given sub-command is shown.
.El
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It Oo data Oc Ns Xo
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No link
mdoc fixes.
2012-09-08 08:46:43 +00:00
.Ar name Ns Oo , Ns Ar name Oc Ns ... Ar command Op Ar args
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
This command may prefix any other command if the user wishes to
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
specify which link the command should affect.
This is only applicable after multiple links have been created in Multi-link
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
mode using the
.Dq clone
command.
.Pp
.Ar Name
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
specifies the name of an existing link.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar name
is a comma separated list,
.Ar command
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is executed on each link.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar name
is
.Dq * ,
.Ar command
is executed on all links.
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It load Oo Ar label Oc Ns Xo
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No ...
.Xc
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
Load the given
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
.Ar label Ns No (s)
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
from the
.Pa ppp.conf
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
file.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar label
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
is not given, the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar default
label is used.
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
.Pp
Unless the
.Ar label
section uses the
.Dq set mode ,
.Dq open
or
.Dq dial
commands,
.Nm
will not attempt to make an immediate connection.
Fix usage for the log command
2001-11-23 11:07:43 +00:00
.It log Ar word Ns No ...
Add a ``log'' command for logging specific information. Add an ``UPTIME'' variable to indicate the bundle uptime. It's now possible to put something like this in ppp.linkdown for a server setup: MYADDR: log Session closing: User USER, address HISADDR, up UPTIME Fixed some memory leakage with commands that expand words. Made some functions static. Fixed a diagnostic bug (iface add .... SIOCDIFADDR)
2001-11-03 21:45:32 +00:00
Send the given word(s) to the log file with the prefix
.Dq LOG: .
Word substitutions are done as explained under the
.Dq !bg
command above.
Always dial immediately on ``open'', ``dial'' and ``call''. We don't need a ``!''.
1998-07-31 19:50:24 +00:00
.It open Op lcp|ccp|ipcp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
This is the opposite of the
.Dq close
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
All closed links are immediately brought up apart from second and subsequent
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
.Ar demand-dial
links - these will come up based on the
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
.Dq set autoload
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
command that has been used.
Add ``ipcp'' as an optional argument to ``open'', and make open capable of re-negotiatiating the various layers. It is now possible to change various link options and then re-open the relevant layer, making the changes effective - for example, switching off VJ compression or starting ECHO LQRs on-the-fly.
1998-06-25 22:33:31 +00:00
.Pp
If the
.Dq lcp
Make the ``load'', ``dial'' and ``open'' commands a big clearer. Requested by: Michael Heitmeier <MICHAEL_HEITMEIER@HP-Germany-om12.om.hp.com>
1999-06-08 11:57:59 +00:00
argument is used while the LCP layer is already open, LCP will be
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
renegotiated.
This allows various LCP options to be changed, after which
Add ``ipcp'' as an optional argument to ``open'', and make open capable of re-negotiatiating the various layers. It is now possible to change various link options and then re-open the relevant layer, making the changes effective - for example, switching off VJ compression or starting ECHO LQRs on-the-fly.
1998-06-25 22:33:31 +00:00
.Dq open lcp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
can be used to put them into effect.
After renegotiating LCP,
Add ``ipcp'' as an optional argument to ``open'', and make open capable of re-negotiatiating the various layers. It is now possible to change various link options and then re-open the relevant layer, making the changes effective - for example, switching off VJ compression or starting ECHO LQRs on-the-fly.
1998-06-25 22:33:31 +00:00
any agreed authentication will also take place.
.Pp
If the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq ccp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
argument is used, the relevant compression layer is opened.
Again, if it is already open, it will be renegotiated.
Add ``ipcp'' as an optional argument to ``open'', and make open capable of re-negotiatiating the various layers. It is now possible to change various link options and then re-open the relevant layer, making the changes effective - for example, switching off VJ compression or starting ECHO LQRs on-the-fly.
1998-06-25 22:33:31 +00:00
.Pp
If the
.Dq ipcp
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
argument is used, the link will be brought up as normal, but if
IPCP is already open, it will be renegotiated and the network
interface will be reconfigured.
.Pp
Add ``ipcp'' as an optional argument to ``open'', and make open capable of re-negotiatiating the various layers. It is now possible to change various link options and then re-open the relevant layer, making the changes effective - for example, switching off VJ compression or starting ECHO LQRs on-the-fly.
1998-06-25 22:33:31 +00:00
It is probably not good practice to re-open the PPP state machines
Expand contractions.
2005-02-13 23:45:54 +00:00
like this as it is possible that the peer will not behave correctly.
Add ``ipcp'' as an optional argument to ``open'', and make open capable of re-negotiatiating the various layers. It is now possible to change various link options and then re-open the relevant layer, making the changes effective - for example, switching off VJ compression or starting ECHO LQRs on-the-fly.
1998-06-25 22:33:31 +00:00
It
.Em is
however useful as a way of forcing the CCP or VJ dictionaries to be reset.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It passwd Ar pass
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
Specify the password required for access to the full
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command set.
This password is required when connecting to the diagnostic port (see the
Don't log the actual password when command-logging "passwd xxxx".
1997-12-18 00:28:36 +00:00
.Dq set server
command).
.Ar Pass
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is specified on the
Don't log the actual password when command-logging "passwd xxxx".
1997-12-18 00:28:36 +00:00
.Dq set server
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command line.
The value of
Don't log the actual password when command-logging "passwd xxxx".
1997-12-18 00:28:36 +00:00
.Ar pass
is not logged when
.Ar command
logging is active, instead, the literal string
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq ********
Don't log the actual password when command-logging "passwd xxxx".
1997-12-18 00:28:36 +00:00
is logged.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It quit|bye Op all
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
If
.Dq quit
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is executed from the controlling connection or from a command file,
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
ppp will exit after closing all connections.
Otherwise, if the user
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is connected to a diagnostic socket, the connection is simply dropped.
.Pp
If the
Typo and formatting updates. PR: docs/8504 Approved by: Brian Somers Submitted by: Kazuo Horikawa <horikawa@jp.FreeBSD.org>
1998-12-04 19:39:05 +00:00
.Ar all
argument is given,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will exit despite the source of the command after closing all existing
connections.
.It remove|rm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This command removes the given link.
It is only really useful in multi-link mode.
A link must be in the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dv CLOSED
state before it is removed.
.It rename|mv Ar name
This command renames the given link to
.Ar name .
It will fail if
.Ar name
is already used by another link.
.Pp
The default link name is
.Sq deflink .
Renaming it to
.Sq modem ,
A number of places in the source tree still reference cuad.* after sio(4) was deprecated by uart(4). s/cuad/cuau/g/ PR: docs/171533 Reviewed by: imp Approved by: cperciva (implicit) MFC after: 3 weeks
2012-12-08 22:16:36 +00:00
.Sq cuau0
Finish the security improvements: o Add "allow" command: "allow users a b c" gives access to users a, b and c. "allow modes auto" gives those users access to auto mode only. "allow users *" and "allow modes *" are accepted. No users and all modes are allowed by default. UID 0 can do anything. o Set the current label with the "load" and "dial" commands so that the call to ppp.linkdown makes sense. o Up the verison number. o Don't OR MODE_AUTO for -background and -ddial. o Don't OR MODE_INTER when we get a diagnostic connection. o Allow up to 40 args per line (was 20). o "set ifaddr" only changes the interface in AUTO mode (with other modes, it happens after IPCP negotiation). o Sort command descriptions in the man page. o Support -dedicated mode where we just talk ppp forever (no login etc).
1997-11-11 22:58:14 +00:00
or
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq USR
may make the log file more readable.
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.It resolv Ar command
This command controls
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
manipulation of the
.Xr resolv.conf 5
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
file.
When
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Nm
starts up, it loads the contents of this file into memory and retains this
image for future use.
.Ar command
is one of the following:
.Bl -tag -width readonly
.It Em readonly
Treat
.Pa /etc/resolv.conf
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
as read only.
If
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq dns
is enabled,
.Nm
will still attempt to negotiate nameservers with the peer, making the results
available via the
.Dv DNS0
and
.Dv DNS1
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
macros.
This is the opposite of the
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq resolv writable
command.
.It Em reload
Reload
.Pa /etc/resolv.conf
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
into memory.
This may be necessary if for example a DHCP client overwrote
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Pa /etc/resolv.conf .
.It Em restore
Replace
.Pa /etc/resolv.conf
with the version originally read at startup or with the last
.Dq resolv reload
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
This is sometimes a useful command to put in the
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Pa /etc/ppp/ppp.linkdown
file.
.It Em rewrite
Rewrite the
.Pa /etc/resolv.conf
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
file.
This command will work even if the
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq resolv readonly
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command has been used.
It may be useful as a command in the
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Pa /etc/ppp/ppp.linkup
file if you wish to defer updating
.Pa /etc/resolv.conf
until after other commands have finished.
.It Em writable
Allow
.Nm
to update
.Pa /etc/resolv.conf
if
.Dq dns
is enabled and
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
successfully negotiates a DNS.
This is the opposite of the
Add the ``resolv'' command for telling ppp how to deal with resolv.conf. You can now ``resolv restore'' in ppp.linkdown ! Add DNS0 and DNS1 macros.
2000-03-14 01:47:27 +00:00
.Dq resolv readonly
command.
.El
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It save
This option is not (yet) implemented.
Support link identification from rfc1570 Two new commands are available; ``ident'' and ``sendident''.
2000-07-19 02:10:35 +00:00
.It sendident
This command tells
.Nm
Some gratuitous whitespace changes.
2000-11-19 16:58:59 +00:00
to identify itself to the peer.
The link must be in LCP state or higher.
Support link identification from rfc1570 Two new commands are available; ``ident'' and ``sendident''.
2000-07-19 02:10:35 +00:00
If no identity has been set (via the
.Ic ident
command),
.Ic sendident
will fail.
.Pp
When an identity has been set,
.Nm
will automatically identify itself when it sends or receives a configure
reject, when negotiation fails or when LCP reaches the opened state.
.Pp
Received identification packets are logged to the LCP log (see
.Ic set log
for details) and are never responded to.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set Ns Xo
Eliminate mdocNG warnings caused by misplaced or extraneous macro calls.
2001-02-28 17:38:53 +00:00
.Op up
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar var value
.Xc
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This option allows the setting of any of the following variables:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set accmap Ar hex-value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
ACCMap stands for Asynchronous Control Character Map.
This is always
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
negotiated with the peer, and defaults to a value of 00000000 in hex.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This protocol is required to defeat hardware that depends on passing
certain characters from end to end (such as XON/XOFF etc).
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
For the XON/XOFF scenario, use
.Dq set accmap 000a0000 .
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It set Oo auth Oc Ns Xo
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No key Ar value
.Xc
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
This sets the authentication key (or password) used in client mode
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
PAP or CHAP negotiation to the given value.
It also specifies the
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
password to be used in the dial or login scripts in place of the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Sq \eP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
sequence, preventing the actual password from being logged.
If
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
.Ar command
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
or
.Ar chat
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
logging is in effect,
.Ar value
is logged as
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Sq ********
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
for security reasons.
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
.Pp
If the first character of
.Ar value
various typo and minor punctuation changes. PR: 23111 Submitted by: Jimmy Olgeni <olgeni@uli.it>
2000-11-28 11:35:14 +00:00
is an exclamation mark
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Pq Dq !\& ,
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
.Nm
treats the remainder of the string as a program that must be executed
to determine the
.Dq authname
and
.Dq authkey
values.
.Pp
Allow leading ``!'' characters in authkeys and chat scripts to be doubled up to mean a single literaly ``!''.
2000-08-09 19:29:50 +00:00
If the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !\&
Allow leading ``!'' characters in authkeys and chat scripts to be doubled up to mean a single literaly ``!''.
2000-08-09 19:29:50 +00:00
is doubled up
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(to
.Dq !! ) ,
Allow leading ``!'' characters in authkeys and chat scripts to be doubled up to mean a single literaly ``!''.
2000-08-09 19:29:50 +00:00
it is treated as a single literal
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Dq !\& ,
Allow leading ``!'' characters in authkeys and chat scripts to be doubled up to mean a single literaly ``!''.
2000-08-09 19:29:50 +00:00
otherwise, ignoring the
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Dq !\& ,
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
.Ar value
is parsed as a program to execute in the same was as the
.Dq !bg
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command above, substituting special names in the same manner.
Once executed,
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
.Nm
will feed the program three lines of input, each terminated by a newline
character:
.Bl -bullet
.It
The host name as sent in the CHAP challenge.
.It
The challenge string as sent in the CHAP challenge.
.It
The locally defined
.Dq authname .
.El
.Pp
Two lines of output are expected:
.Bl -bullet
.It
The
.Dq authname
to be sent with the CHAP response.
.It
The
.Dq authkey ,
which is encrypted with the challenge and request id, the answer being sent
in the CHAP response packet.
.El
.Pp
When configuring
.Nm
Expand contractions.
2005-02-13 23:45:54 +00:00
in this manner, it is expected that the host challenge is a series of ASCII
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
digits or characters.
An encryption device or Secure ID card is usually
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
required to calculate the secret appropriate for the given challenge.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set authname Ar id
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
This sets the authentication id used in client mode PAP or CHAP negotiation.
Mention what ``set authname'' does in -direct mode.
1998-08-25 17:48:55 +00:00
.Pp
If used in
.Fl direct
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
mode with CHAP enabled,
Mention what ``set authname'' does in -direct mode.
1998-08-25 17:48:55 +00:00
.Ar id
When resending chap challenges, resend the same challenge each time rather than making up a new one. Increase the authname/authkey max sizes to 100 characters. Allow ``authkey'' specifications beginning with ``!''. When a challenge is received, the text following the ``!'' is executed as a program (expanding stuff in the same way that ``sh'' and ``!bg'' do). The program is passed the peer name, peer challenge and local ``authname'' on standard input and is expected to output the name/key combination that should be used to build the CHAP response. This provides support for Secure ID cards (guess what I was given at work recently!) using CHAP. Examples will follow.
1999-02-11 10:14:08 +00:00
is used in the initial authentication challenge and should normally be set to
Mention what ``set authname'' does in -direct mode.
1998-08-25 17:48:55 +00:00
the local machine name.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set autoload Xo
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
.Ar min-percent max-percent period
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Xc
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
These settings apply only in multi-link mode and default to zero, zero and
five respectively.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
When more than one
.Ar demand-dial
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(also known as
.Fl auto )
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
mode link is available, only the first link is made active when
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
first reads data from the tun device.
The next
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar demand-dial
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
link will be opened only when the current bundle throughput is at least
.Ar max-percent
percent of the total bundle bandwidth for
.Ar period
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
seconds.
When the current bundle throughput decreases to
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
.Ar min-percent
percent or less of the total bundle bandwidth for
.Ar period
seconds, a
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar demand-dial
Expand contractions.
2005-02-13 23:45:54 +00:00
link will be brought down as long as it is not the last active link.
Maintain input and output throughput averages and choose the highest of the two when calculating the MP throughput average for the ``set autoload'' implementation. This makes more sense as all links I know of are full-duplex. This also means that people may need to adjust their autoload settings as 100% bandwidth is now the theoretical maximum rather than 200% (but of course, halfing the current settings is probably not the correct answer either!). This involves a ppp version bump as we need to pass an extra throughput array through the MP local domain socket.
2000-08-15 10:25:42 +00:00
.Pp
Bundle throughput is measured as the maximum of inbound and outbound
traffic.
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
.Pp
The default values cause
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar demand-dial
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
links to simply come up one at a time.
.Pp
Certain devices cannot determine their physical bandwidth, so it
is sometimes necessary to use the
.Dq set bandwidth
command (described below) to make
.Dq set autoload
work correctly.
.It set bandwidth Ar value
This command sets the connection bandwidth in bits per second.
.Ar value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
must be greater than zero.
It is currently only used by the
o Obsolete the undocumented ``set weight'' command. o If we're using RADIUS and the RADIUS mtu is less than our peers mru/mrru, reduce our mtu to this value for NetBSD too. o Make struct throughput's sample period dynamic and tweak the ppp version number to reflect the extra stuff being passed through the local domain socket as a result (MP mode). o Measure the current throughput based on the number of samples actually taken rather than on the full sample period. o Keep the throughput statisics persistent while being passed to another ppp invocation through the local domain socket. o When showing throughput statistics after the timer has stopped, use the stopped time for overall calculations, not the current time. Also show the stopped time and how long the current throughput has been sampled for. o Use time() consistently in throughput.c o Tighten up the ``show bundle'' output. o Introduce the ``set bandwidth'' command. o Rewrite the ``set autoload'' command. It now takes three arguments and works based on a rolling bundle throughput average compared against the theoretical bundle bandwidth over a given period (read: it's now functional).
1999-08-05 10:32:16 +00:00
.Dq set autoload
command above.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set callback Ar option Ns No ...
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
If no arguments are given, callback is disabled, otherwise,
.Nm
will request (or in
Stress that ``none'' must be specified on the `set callback' line if callback is to be optional. Requested by: Andrzej Tobola <san@koziolek.lublin.top.pl>
1998-10-27 22:53:18 +00:00
.Fl direct
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
mode, will accept) one of the given
.Ar option Ns No s .
In client mode, if an
.Ar option
is NAK'd
.Nm
will request a different
.Ar option ,
until no options remain at which point
.Nm
will terminate negotiations (unless
.Dq none
is one of the specified
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Ar option ) .
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
In server mode,
Stress that ``none'' must be specified on the `set callback' line if callback is to be optional. Requested by: Andrzej Tobola <san@koziolek.lublin.top.pl>
1998-10-27 22:53:18 +00:00
.Nm
will accept any of the given protocols - but the client
.Em must
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
request one of them.
Preprocess ppp.8.m4 into ppp.8, taking into account any compile time options used to build ppp. Currently, this is a no-op and only handles LOCALNAT and LOCALRAD cases. This will be used for the upcoming ipv6 changes, and allows a shared man page between OpenBSD and FreeBSD.
2001-08-11 18:27:14 +00:00
If you wish callback to be optional, you must {include}
Stress that ``none'' must be specified on the `set callback' line if callback is to be optional. Requested by: Andrzej Tobola <san@koziolek.lublin.top.pl>
1998-10-27 22:53:18 +00:00
.Ar none
as an option.
.Pp
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
The
.Ar option Ns No s
are as follows (in this order of preference):
.Bl -tag requires -width too Obtained from: OpenBSD
2000-01-07 03:11:42 +00:00
.Bl -tag -width Ds
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.It auth
The callee is expected to decide the callback number based on
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
authentication.
If
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Nm
is the callee, the number should be specified as the fifth field of
the peers entry in
.Pa /etc/ppp/ppp.secret .
.It cbcp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Microsoft's callback control protocol is used.
See
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Dq set cbcp
below.
If we've negotiated CBCP and have also specified ``none'' as a possible callback option, and the server sends us CBCP_NONUM, proceed directly to the network phase rather than insisting on our configured CBCP option. Mostly submitted by: kkphang <phang@dgate.po.my>
1999-07-27 13:47:59 +00:00
.Pp
If you wish to negotiate
.Ar cbcp
in client mode but also wish to allow the server to request no callback at
CBCP negotiation time, you must specify both
.Ar cbcp
and
.Ar none
as callback options.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It E.164 *| Ns Xo
.Ar number Ns Op , Ns Ar number Ns
.No ...
.Xc
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
The caller specifies the
.Ar number .
If
.Nm
is the callee,
.Ar number
Spelling police
1999-04-23 13:45:50 +00:00
should be either a comma separated list of allowable numbers or a
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Dq \&* ,
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
meaning any number is permitted.
If
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.Nm
is the caller, only a single number should be specified.
.Pp
Note, this option is very unsafe when used with a
.Dq \&*
as a malicious caller can tell
.Nm
to call any (possibly international) number without first authenticating
themselves.
.It none
If the peer does not wish to do callback at all,
.Nm
will accept the fact and continue without callback rather than terminating
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
the connection.
This is required (in addition to one or more other callback
If we've negotiated CBCP and have also specified ``none'' as a possible callback option, and the server sends us CBCP_NONUM, proceed directly to the network phase rather than insisting on our configured CBCP option. Mostly submitted by: kkphang <phang@dgate.po.my>
1999-07-27 13:47:59 +00:00
options) if you wish callback to be optional.
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
.El
.Pp
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.It set cbcp Oo
.No *| Ns Ar number Ns Oo
.No , Ns Ar number Ns ...\& Oc
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Op Ar delay Op Ar retry
.Oc
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
If no arguments are given, CBCP (Microsoft's CallBack Control Protocol)
o Support callback types NONE, E.164, AUTH and CBCP. (see the new ``set callback'' and ``set cbcp'' commands) o Add a ``cbcp'' log level and mbuf type. o Don't dump core when \T is given in ``set login'' or ``set hangup''. o Allow ``*'' and blanks as placeholders in ppp.secret and allow a fifth field for specifying auth/cbcp dialback parameters. o Remove a few extraneous #includes o Define the default number of REQs (restart counter) in defs.h rather than hardcoding ``5'' all over the place. o Fix a few man page inconsistencies.
1998-08-07 18:42:51 +00:00
is disabled - ie, configuring CBCP in the
.Dq set callback
command will result in
.Nm
requesting no callback in the CBCP phase.
Otherwise,
.Nm
attempts to use the given phone
.Ar number Ns No (s).
.Pp
In server mode
.Pq Fl direct ,
.Nm
will insist that the client uses one of these numbers, unless
.Dq \&*
is used in which case the client is expected to specify the number.
.Pp
In client mode,
.Nm
will attempt to use one of the given numbers (whichever it finds to
be agreeable with the peer), or if
.Dq \&*
is specified,
.Nm
will expect the peer to specify the number.
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
.It set cd Oo
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.No off| Ns Ar seconds Ns Op !\&
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
.Oc
Wait by default for one second after the login script is complete before checking carrier. If it's there, the device supports carrier. If it's not it doesn't. Add the ``set cd'' command for deciding how soon to check for carrier, and for deciding if carrier is REQUIRED. The default has changed: Pre 2.0 versions of ppp waited for 1 second. Version 2 didn't wait, but this causes problems with some (few?) modems that don't assert carrier immediately on reporting CONNECT. The one second delay is back now and can be removed with ``set cd 0''. Bump the ppp version number in case this needs to be changed again....
1999-02-16 00:16:56 +00:00
Normally,
.Nm
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
checks for the existence of carrier depending on the type of device
that has been opened:
.Bl -tag -width XXX -offset XXX
.It Terminal Devices
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Carrier is checked one second after the login script is complete.
Expand contractions.
2005-02-13 23:45:54 +00:00
If it is not set,
Wait by default for one second after the login script is complete before checking carrier. If it's there, the device supports carrier. If it's not it doesn't. Add the ``set cd'' command for deciding how soon to check for carrier, and for deciding if carrier is REQUIRED. The default has changed: Pre 2.0 versions of ppp waited for 1 second. Version 2 didn't wait, but this causes problems with some (few?) modems that don't assert carrier immediately on reporting CONNECT. The one second delay is back now and can be removed with ``set cd 0''. Bump the ppp version number in case this needs to be changed again....
1999-02-16 00:16:56 +00:00
.Nm
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
assumes that this is because the device does not support carrier (which
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
is true for most
.Dq laplink
NULL-modem cables), logs the fact and stops checking
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
for carrier.
.Pp
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
As ptys do not support the TIOCMGET ioctl, the tty device will switch all
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
carrier detection off when it detects that the device is a pty.
.It PPPoE (netgraph) Devices
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Carrier is checked once per second for 5 seconds.
Expand contractions.
2005-02-13 23:45:54 +00:00
If it is not set after
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
the fifth second, the connection attempt is considered to have failed and
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
the device is closed.
Carrier is always required for PPPoE devices.
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
.El
.Pp
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
All other device types do not support carrier.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Setting a carrier value will
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
result in a warning when the device is opened.
.Pp
Some modems take more than one second after connecting to assert the carrier
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
signal.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
If this delay is not increased, this will result in
ppps -> ppp's; suggested by sheldonh .Nm ppp -> .Nm; overlooked by me Microsofts -> Microsoft's; OpenBSD
2000-03-14 20:04:32 +00:00
.Nm Ns No 's
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
inability to detect when the link is dropped, as
.Nm
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
assumes that the device is not asserting carrier.
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
.Pp
The
.Dq set cd
command overrides the default carrier behaviour.
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
.Ar seconds
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
specifies the maximum number of seconds that
Wait by default for one second after the login script is complete before checking carrier. If it's there, the device supports carrier. If it's not it doesn't. Add the ``set cd'' command for deciding how soon to check for carrier, and for deciding if carrier is REQUIRED. The default has changed: Pre 2.0 versions of ppp waited for 1 second. Version 2 didn't wait, but this causes problems with some (few?) modems that don't assert carrier immediately on reporting CONNECT. The one second delay is back now and can be removed with ``set cd 0''. Bump the ppp version number in case this needs to be changed again....
1999-02-16 00:16:56 +00:00
.Nm
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
should wait after the dial script has finished before deciding if
carrier is available or not.
.Pp
Support ``set cd off'' to tell ppp not to even look for carrier on the device.
1999-09-26 23:02:18 +00:00
If
.Dq off
is specified,
.Nm
will not check for carrier on the device, otherwise
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
.Nm
will not proceed to the login script until either carrier is detected
or until
.Ar seconds
Change ``set cd'' so that its default value is device specific. The default is still 1 second for ttys, but is now 6 seconds for i4b (ISDN) devices and 5 seconds for ethernet (PPPoE) devices.
1999-11-26 22:44:33 +00:00
has elapsed, at which point
.Nm
assumes that the device will not set carrier.
.Pp
If no arguments are given, carrier settings will go back to their default
values.
Wait by default for one second after the login script is complete before checking carrier. If it's there, the device supports carrier. If it's not it doesn't. Add the ``set cd'' command for deciding how soon to check for carrier, and for deciding if carrier is REQUIRED. The default has changed: Pre 2.0 versions of ppp waited for 1 second. Version 2 didn't wait, but this causes problems with some (few?) modems that don't assert carrier immediately on reporting CONNECT. The one second delay is back now and can be removed with ``set cd 0''. Bump the ppp version number in case this needs to be changed again....
1999-02-16 00:16:56 +00:00
.Pp
If
.Ar seconds
various typo and minor punctuation changes. PR: 23111 Submitted by: Jimmy Olgeni <olgeni@uli.it>
2000-11-28 11:35:14 +00:00
is followed immediately by an exclamation mark
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Pq Dq !\& ,
Wait by default for one second after the login script is complete before checking carrier. If it's there, the device supports carrier. If it's not it doesn't. Add the ``set cd'' command for deciding how soon to check for carrier, and for deciding if carrier is REQUIRED. The default has changed: Pre 2.0 versions of ppp waited for 1 second. Version 2 didn't wait, but this causes problems with some (few?) modems that don't assert carrier immediately on reporting CONNECT. The one second delay is back now and can be removed with ``set cd 0''. Bump the ppp version number in case this needs to be changed again....
1999-02-16 00:16:56 +00:00
.Nm
will
.Em require
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
carrier.
If carrier is not detected after
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
.Ar seconds
seconds, the link will be disconnected.
If we've got a full output buffer queue and cannot send anything for two mintues (see ``set choked'' and ``show bundle''), nuke the ip, mp and link level buffer queues. This should fix problems where ``ppp -auto'' seems to stop responding after failing to connect to the peer a few times.
1998-08-25 17:48:43 +00:00
.It set choked Op Ar timeout
This sets the number of seconds that
.Nm
will keep a choked output queue before dropping all pending output packets.
If
.Ar timeout
is less than or equal to zero or if
.Ar timeout
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
is not specified, it is set to the default value of
If we've got a full output buffer queue and cannot send anything for two mintues (see ``set choked'' and ``show bundle''), nuke the ip, mp and link level buffer queues. This should fix problems where ``ppp -auto'' seems to stop responding after failing to connect to the peer a few times.
1998-08-25 17:48:43 +00:00
.Em 120 seconds .
.Pp
A choked output queue occurs when
.Nm
has read a certain number of packets from the local network for transmission,
but cannot send the data due to link failure (the peer is busy etc.).
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will not read packets indefinitely.
Instead, it reads up to
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
.Em 30
If we've got a full output buffer queue and cannot send anything for two mintues (see ``set choked'' and ``show bundle''), nuke the ip, mp and link level buffer queues. This should fix problems where ``ppp -auto'' seems to stop responding after failing to connect to the peer a few times.
1998-08-25 17:48:43 +00:00
packets (or
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
.Em 30 No +
If we've got a full output buffer queue and cannot send anything for two mintues (see ``set choked'' and ``show bundle''), nuke the ip, mp and link level buffer queues. This should fix problems where ``ppp -auto'' seems to stop responding after failing to connect to the peer a few times.
1998-08-25 17:48:43 +00:00
.Em nlinks No *
.Em 2
packets in multi-link mode), then stops reading the network interface
until either
.Ar timeout
seconds have passed or at least one packet has been sent.
.Pp
If
.Ar timeout
seconds pass, all pending output packets are dropped.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set ctsrts|crtscts on|off
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This sets hardware flow control.
Hardware flow control is
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar on
by default.
.It set deflate Ar out-winsize Op Ar in-winsize
This sets the DEFLATE algorithms default outgoing and incoming window
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
sizes.
Both
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar out-winsize
and
.Ar in-winsize
must be values between
.Em 8
and
.Em 15 .
If
.Ar in-winsize
is specified,
.Nm
will insist that this window size is used and will not accept any other
values from the peer.
.It set dns Op Ar primary Op Ar secondary
This command specifies DNS overrides for the
.Dq accept dns
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command.
Refer to the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq accept
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command description above for details.
This command does not affect the IP numbers requested using
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq enable dns .
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set device|line Xo
.Ar value Ns No ...
.Xc
Allow multiple (comma seperated) devices on the "set device" line. Submitted by: Derek Inksetter <derek@saidev.com>
1997-12-21 03:16:19 +00:00
This sets the device(s) to which
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Nm
will talk to the given
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Dq value .
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
.Pp
Remove ISDN4BSD (I4B) from HEAD as it is not MPSAFE and parts relied on the now removed NET_NEEDS_GIANT. Most of I4B has been disconnected from the build since July 2007 in HEAD/RELENG_7. This is what was removed: - configuration in /etc/isdn - examples - man pages - kernel configuration - sys/i4b (drivers, layers, include files) - user space tools - i4b support from ppp - further documentation Discussed with: rwatson, re
2008-05-26 10:40:09 +00:00
All serial device names are expected to begin with
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Pa /dev/ .
Remove ISDN4BSD (I4B) from HEAD as it is not MPSAFE and parts relied on the now removed NET_NEEDS_GIANT. Most of I4B has been disconnected from the build since July 2007 in HEAD/RELENG_7. This is what was removed: - configuration in /etc/isdn - examples - man pages - kernel configuration - sys/i4b (drivers, layers, include files) - user space tools - i4b support from ppp - further documentation Discussed with: rwatson, re
2008-05-26 10:40:09 +00:00
Serial devices are usually called
Call serial devices ``cuaXX'' instead of ``cuaaX'' (in line with OpenBSD conventions).
2000-01-07 03:11:56 +00:00
.Pa cuaXX .
Add ISDN support via isdnd & i4b. This requires version 0.81.1 of the i4b code - namely support of the I4B_VR_REQ ioctl via the i4brbchX device. Ppp controls the phone number, but idle timers and SYNC/RAW decisions are still made by isdnd (in isdnd.rc). This involves a new datalink state machine phase. The ``wait for carrier'' phase happens after dialing but before logging in. The whole dial state should really be abstracted so that each device type can deal with it in its own way (thinking about PPPoE) - but that'll have to wait. The ``set cd'' symantics remain the same for tty devices, but we now delay until we either get CD or timeout waiting (at which time we drop the link if we require CD). For i4b devices we always insist on carrier. Thanks to hm@ for his help, and especially for pointing out that I *don't* need to re-implement isdnd (that was a huge waste of time !) :-]
1999-08-06 20:04:08 +00:00
.Pp
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
If
.Dq value
does not begin with
.Pa /dev/ ,
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
it must either begin with an exclamation mark
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Pq Dq !\& ,
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
be of the format
.No PPPoE: Ns Ar iface Ns Xo
.Op \&: Ns Ar provider Ns
.Xc
Talk a little more about the differences between PPPoE on FreeBSD & OpenBSD.
2001-03-09 00:12:09 +00:00
(on
.Xr netgraph 4
enabled systems), or be of the format
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Sm off
.Ar host : port Op /tcp|udp .
.Sm on
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
If it begins with an exclamation mark, the rest of the device name is
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
treated as a program name, and that program is executed when the device
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is opened.
Standard input, output and error are fed back to
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
and are read and written as if they were a regular device.
.Pp
If a
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.No PPPoE: Ns Ar iface Ns Xo
.Op \&: Ns Ar provider Ns
.Xc
specification is given,
.Nm
will attempt to create a
.Em PPP
over Ethernet connection using the given
.Ar iface
Mention that pppoe requires netgraph(4) and without it, an external pppoe program must be used (such as pppoe(8) on OpenBSD).
2000-08-10 13:26:01 +00:00
interface by using
.Xr netgraph 4 .
If
.Xr netgraph 4
is not available,
.Nm
Talk a little more about the differences between PPPoE on FreeBSD & OpenBSD.
2001-03-09 00:12:09 +00:00
will attempt to load it using
Mention that pppoe requires netgraph(4) and without it, an external pppoe program must be used (such as pppoe(8) on OpenBSD).
2000-08-10 13:26:01 +00:00
.Xr kldload 2 .
If this fails, an external program must be used such as the
Xref the proper manual pages. PR: 60999 Submitted by: Marc Silver <marcs@draenor.org>
2004-01-12 16:10:38 +00:00
.Xr pppoed 8
mdoc(7) police: s/OpenBSD/.Ox/ where appropriate.
2001-08-13 16:43:02 +00:00
program available under
.Ox .
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
The given
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.Ar provider
Make the meaning of the provider part of the PPPoE device spec clearer.
1999-11-13 16:18:27 +00:00
is passed as the service name in the PPPoE Discovery Initiation (PADI)
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
packet.
If no provider is given, an empty value will be used.
Document NGM_PPPOE_ACNAME handling.
2002-02-20 15:53:47 +00:00
.Pp
When a PPPoE connection is established,
.Nm
will place the name of the Access Concentrator in the environment variable
mdoc(7) police: .Va -> .Ev.
2002-03-15 17:03:05 +00:00
.Ev ACNAME .
Document NGM_PPPOE_ACNAME handling.
2002-02-20 15:53:47 +00:00
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Refer to
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.Xr netgraph 4
and
Correct cross-references: ng_bpf.8 --> ng_bpf.4 ng_ether.8 --> ng_ether.4 ng_iface.8 --> ng_iface.4 ng_pppoe.8 --> ng_pppoe.4 ng_socket.8 --> ng_socket.4 ng_tty.8 --> ng_tty.4 ng_{type}.4 --> /dev/null MFC after: 1 week
2001-06-05 12:40:03 +00:00
.Xr ng_pppoe 4
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
for further details.
.Pp
If a
.Ar host Ns No : Ns Ar port Ns Oo
.No /tcp|udp
.Oc
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
specification is given,
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Nm
will attempt to connect to the given
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.Ar host
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
on the given
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.Ar port .
If a
.Dq /tcp
or
.Dq /udp
suffix is not provided, the default is
.Dq /tcp .
Refer to the section on
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Em PPP OVER TCP and UDP
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
above for further details.
.Pp
If multiple
Allow multiple (comma seperated) devices on the "set device" line. Submitted by: Derek Inksetter <derek@saidev.com>
1997-12-21 03:16:19 +00:00
.Dq values
are specified,
.Nm
will attempt to open each one in turn until it succeeds or runs out of
devices.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set dial Ar chat-script
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This specifies the chat script that will be used to dial the other
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
side.
See also the
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
.Dq set login
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command below.
Refer to
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Xr chat 8
and to the example configuration files for details of the chat script
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
format.
It is possible to specify some special
.Sq values
in your chat script as follows:
mdoc(7) police: replace two -unfilled displays with -tag lists. This works only because of bugs in current implementation: the first .It after ``.Bd -unfilled'' re-enables filling mode and does not restore (disable) it back afterwards.
2001-02-07 16:02:21 +00:00
.Bl -tag -width 2n
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \ec
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
When used as the last character in a
.Sq send
string, this indicates that a newline should not be appended.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \ed
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
When the chat script encounters this sequence, it delays two seconds.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \ep
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
When the chat script encounters this sequence, it delays for one quarter of
a second.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \en
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced with a newline character.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \er
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced with a carriage return character.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \es
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced with a space character.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \et
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced with a tab character.
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \eT
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced by the current phone number (see
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq set phone
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
below).
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \eP
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced by the current
.Ar authkey
value (see
.Dq set authkey
above).
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.It Li \eU
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
This is replaced by the current
.Ar authname
value (see
.Dq set authname
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
above).
mdoc(7) police: replace two -unfilled displays with -tag lists. This works only because of bugs in current implementation: the first .It after ``.Bd -unfilled'' re-enables filling mode and does not restore (disable) it back afterwards.
2001-02-07 16:02:21 +00:00
.El
o Log ******** instead of the actual password for "set authkey" when command logging is switched on. o Display ******** for the authkey for "show auth" o Document how \P should be used, and document the other chat escapes while I'm there. o Make sure the full command is displayed when a compound command fails - ie, "set novar rubbish" should say "set novar: Invalid command" rather than "novar: Invalid command" Problem pointed out by: Theo de Raadt <deraadt@cvs.openbsd.org> (among others)
1997-12-17 21:21:42 +00:00
.Pp
Note that two parsers will examine these escape sequences, so in order to
have the
.Sq chat parser
see the escape character, it is necessary to escape it from the
.Sq command parser .
This means that in practice you should use two escapes, for example:
.Bd -literal -offset indent
set dial "... ATDT\\\\T CONNECT"
.Ed
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
exclamation mark
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Pq Dq !\& .
various typo and minor punctuation changes. PR: 23111 Submitted by: Jimmy Olgeni <olgeni@uli.it>
2000-11-28 11:35:14 +00:00
If a literal exclamation mark is required, double it up to
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !!\&
Allow leading ``!'' characters in authkeys and chat scripts to be doubled up to mean a single literaly ``!''.
2000-08-09 19:29:50 +00:00
and it will be treated as a single literal
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Dq !\& .
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
When the command is executed, standard input and standard output are
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
directed to the open device (see the
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
.Dq set device
command), and standard error is read by
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
and substituted as the expect or send string.
If
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is running in interactive mode, file descriptor 3 is attached to
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
.Pa /dev/tty .
.Pp
various typo and minor punctuation changes. PR: 23111 Submitted by: Jimmy Olgeni <olgeni@uli.it>
2000-11-28 11:35:14 +00:00
For example (wrapped for readability):
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
.Bd -literal -offset indent
set login "TIMEOUT 5 \\"\\" \\"\\" login:--login: ppp \e
Mention that it's only necessary to escape the '-' in chat scripts twice (once for the arg parsing and once to make it a normal character). Make the man page example consistent. Reminded by: Bryan Liesner <bleez@netaxs.com>
1999-12-29 22:31:10 +00:00
word: ppp \\"!sh \\\\-c \\\\\\"echo \\\\-n label: >&2\\\\\\"\\" \e
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
\\"!/bin/echo in\\" HELLO"
.Ed
.Pp
would result in the following chat sequence (output using the
.Sq set log local chat
command before dialing):
.Bd -literal -offset indent
Dial attempt 1 of 1
dial OK!
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Chat: Expecting:
Chat: Sending:
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
Chat: Expecting: login:--login:
Chat: Wait for (5): login:
Chat: Sending: ppp
Chat: Expecting: word:
Chat: Wait for (5): word:
Chat: Sending: ppp
Chat: Expecting: !sh \\-c "echo \\-n label: >&2"
Chat: Exec: sh -c "echo -n label: >&2"
Chat: Wait for (5): !sh \\-c "echo \\-n label: >&2" --> label:
Chat: Exec: /bin/echo in
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Chat: Sending:
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
Chat: Expecting: HELLO
Chat: Wait for (5): HELLO
login OK!
.Ed
.Pp
Note (again) the use of the escape character, allowing many levels of
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
nesting.
Here, there are four parsers at work.
The first parses the original line, reading it as three arguments.
The second parses the third argument, reading it as 11 arguments.
At this point, it is
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
important that the
.Dq \&-
signs are escaped, otherwise this parser will see them as constituting
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
an expect-send-expect sequence.
When the
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !\&
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
character is seen, the execution parser reads the first command as three
arguments, and then
.Xr sh 1
itself expands the argument after the
.Fl c .
As we wish to send the output back to the modem, in the first example
we redirect our output to file descriptor 2 (stderr) so that
.Nm
itself sends and logs it, and in the second example, we just output to stdout,
which is attached directly to the modem.
.Pp
This, of course means that it is possible to execute an entirely external
.Dq chat
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command rather than using the internal one.
See
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
.Xr chat 8
for a good alternative.
When executing a command as part of a dial/login/hangup script, expand words in the same way as !bg does.
1999-02-12 00:52:30 +00:00
.Pp
The external command that is executed is subjected to the same special
word expansions as the
.Dq !bg
command.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set enddisc Op label|IP|MAC|magic|psn value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This command sets our local endpoint discriminator.
If set prior to LCP negotiation, and if no
Allow our endpoint discriminator to be enabled, disabled, accepted and denied. This is necessary for some MP implementations that get confused if you accept their endpoint discriminator but reject their MRRU.
1999-06-09 16:54:04 +00:00
.Dq disable enddisc
command has been used,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will send the information to the peer using the LCP endpoint discriminator
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
option.
The following discriminators may be set:
mdoc(7) police: replace two -unfilled displays with -tag lists. This works only because of bugs in current implementation: the first .It after ``.Bd -unfilled'' re-enables filling mode and does not restore (disable) it back afterwards.
2001-02-07 16:02:21 +00:00
.Bl -tag -width indent
Be careful about using ``.Bd -literal'' as groff sometimes keeps the `-literal' after the closing .Ed. Where this happens, use ``.Bd -unfilled'' with ``.It Li'' to dodge the problem - it looks better too. Problem reported by: Dom Mitchell <dom@phmit.demon.co.uk>
1998-08-11 18:59:36 +00:00
.It Li label
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
The current label is used.
Be careful about using ``.Bd -literal'' as groff sometimes keeps the `-literal' after the closing .Ed. Where this happens, use ``.Bd -unfilled'' with ``.It Li'' to dodge the problem - it looks better too. Problem reported by: Dom Mitchell <dom@phmit.demon.co.uk>
1998-08-11 18:59:36 +00:00
.It Li IP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
it does, the endpoint discriminator stays at the old value unless manually
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
reset.
Be careful about using ``.Bd -literal'' as groff sometimes keeps the `-literal' after the closing .Ed. Where this happens, use ``.Bd -unfilled'' with ``.It Li'' to dodge the problem - it looks better too. Problem reported by: Dom Mitchell <dom@phmit.demon.co.uk>
1998-08-11 18:59:36 +00:00
.It Li MAC
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
This is similar to the
.Ar IP
option above, except that the MAC address associated with the local IP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
number is used.
If the local IP number is not resident on any Ethernet
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
interface, the command will fail.
.Pp
As the local IP number defaults to whatever the machine host name is,
.Dq set enddisc mac
is usually done prior to any
.Dq set ifaddr
commands.
Be careful about using ``.Bd -literal'' as groff sometimes keeps the `-literal' after the closing .Ed. Where this happens, use ``.Bd -unfilled'' with ``.It Li'' to dodge the problem - it looks better too. Problem reported by: Dom Mitchell <dom@phmit.demon.co.uk>
1998-08-11 18:59:36 +00:00
.It Li magic
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
A 20 digit random number is used.
Care should be taken when using magic numbers as restarting
Describe why a ``magic'' enddisc is not always a good idea.
1999-06-11 11:27:18 +00:00
.Nm
or creating a link using a different
.Nm
invocation will also use a different magic number and will therefore not
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
be recognised by the peer as belonging to the same bundle.
This makes it unsuitable for
Describe why a ``magic'' enddisc is not always a good idea.
1999-06-11 11:27:18 +00:00
.Fl direct
connections.
Be careful about using ``.Bd -literal'' as groff sometimes keeps the `-literal' after the closing .Ed. Where this happens, use ``.Bd -unfilled'' with ``.It Li'' to dodge the problem - it looks better too. Problem reported by: Dom Mitchell <dom@phmit.demon.co.uk>
1998-08-11 18:59:36 +00:00
.It Li psn Ar value
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
The given
.Ar value
is used.
.Ar Value
should be set to an absolute public switched network number with the
country code first.
mdoc(7) police: replace two -unfilled displays with -tag lists. This works only because of bugs in current implementation: the first .It after ``.Bd -unfilled'' re-enables filling mode and does not restore (disable) it back afterwards.
2001-02-07 16:02:21 +00:00
.El
Allow (and document) execution of commands from within our chat script. You can now even run chat(8) - see ppp.conf.sample.
1997-12-27 07:22:12 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
If no arguments are given, the endpoint discriminator is reset.
.It set escape Ar value...
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This option is similar to the
.Dq set accmap
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
option above.
It allows the user to specify a set of characters that will be
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
.Sq escaped
as they travel across the link.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set filter dial|alive|in|out Ar rule-no Xo
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
.No permit|deny|clear| Ns Ar rule-no
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Op !\&
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
.Oo Op host
.Ar src_addr Ns Op / Ns Ar width
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Op Ar dst_addr Ns Op / Ns Ar width
Some cosmetic changes to sync with OpenBSD
2001-08-27 19:08:43 +00:00
.Oc [ Ns Ar proto
.Op src lt|eq|gt Ar port
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Op dst lt|eq|gt Ar port
.Op estab
.Op syn
.Op finrst
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Op timeout Ar secs ]
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Xc
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
supports four filter sets.
The
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em alive
Typo Submitted by: Alex Nash <nash@mcs.net>
1999-09-24 23:57:22 +00:00
filter specifies packets that keep the connection alive - resetting the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
idle timer.
The
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em dial
filter specifies packets that cause
.Nm
to dial when in
.Fl auto
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
mode.
The
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em in
filter specifies packets that are allowed to travel
into the machine and the
.Em out
filter specifies packets that are allowed out of the machine.
.Pp
Filtering is done prior to any IP alterations that might be done by the
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
NAT engine on outgoing packets and after any IP alterations that might
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
be done by the NAT engine on incoming packets.
Allow a ``timeout secs'' filter option to let specific packet types effect the idle timer in different ways. Submitted by: Stefan Esser <se@freebsd.org> With adjustments by me to document the option in the man page and to give the same semantics for outgoing traffic as incoming. I made the style more consistent in ip.c - this should really have been done as a separate commit.
2000-07-11 22:11:36 +00:00
By default all empty filter sets allow all packets to pass.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Rules are processed in order according to
o Overhaul filtering, adding facilities to jump over rules and to negate the sense of rules. o Remove the redundant (and undocumented) ``host'' and ``port'' words (README.changes updated). o Don't permit (and ignore) garbage instead of the protocol. Mostly submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-27 23:44:00 +00:00
.Ar rule-no
(unless skipped by specifying a rule number as the
.Ar action ) .
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Up to 40 rules may be given for each set.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
If a packet does not match
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
any of the rules in a given set, it is discarded.
In the case of
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em in
and
.Em out
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
filters, this means that the packet is dropped.
In the case of
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em alive
Allow a ``timeout secs'' filter option to let specific packet types effect the idle timer in different ways. Submitted by: Stefan Esser <se@freebsd.org> With adjustments by me to document the option in the man page and to give the same semantics for outgoing traffic as incoming. I made the style more consistent in ip.c - this should really have been done as a separate commit.
2000-07-11 22:11:36 +00:00
filters it means that the packet will not reset the idle timer (even if
the
.Ar in Ns No / Ns Ar out
filter has a
.Dq timeout
value) and in the case of
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Em dial
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
filters it means that the packet will not trigger a dial.
A packet failing to trigger a dial will be dropped rather than queued.
Refer to the
Use ``Sx'' when xref'ing sections.
1999-03-18 21:53:56 +00:00
section on
.Sx PACKET FILTERING
above for further details.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set hangup Ar chat-script
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
This specifies the chat script that will be used to reset the device
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
before it is closed.
It should not normally be necessary, but can
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
be used for devices that fail to reset themselves properly on close.
.It set help|? Op Ar command
This command gives a summary of available set commands, or if
.Ar command
is specified, the command usage is shown.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set ifaddr Oo Ar myaddr Ns
.Op / Ns Ar \&nn
.Oo Ar hisaddr Ns Op / Ns Ar \&nn
.Oo Ar netmask
.Op Ar triggeraddr
.Oc Oc
.Oc
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This command specifies the IP addresses that will be used during
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
IPCP negotiation.
Addresses are specified using the format
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dl a.b.c.d/nn
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Where
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dq a.b.c.d
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is the preferred IP, but
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Ar nn
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
specifies how many bits of the address we will insist on.
If
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No / Ns Ar nn
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
is omitted, it defaults to
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dq /32
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
unless the IP address is 0.0.0.0 in which case it defaults to
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dq /0 .
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Pp
Come up with something useful when someone searches for ``dynamic IP''.
1999-06-14 10:12:41 +00:00
If you wish to assign a dynamic IP number to the peer,
.Ar hisaddr
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
may also be specified as a range of IP numbers in the format
mdoc(7) police: split punctuation characters + misc fixes.
2001-02-01 16:44:04 +00:00
.Bd -ragged -offset indent
mdoc fixes.
2012-09-08 08:46:43 +00:00
.Ar \&IP Ns Oo \&- Ns Ar \&IP Ns Oc Ns Oo , Ns Ar \&IP Ns
.Oo \&- Ns Ar \&IP Ns Oc Oc Ns ...
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Ed
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
for example:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Dl set ifaddr 10.0.0.1 10.0.1.2-10.0.1.10,10.0.1.20
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
will only negotiate
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dq 10.0.0.1
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
as the local IP number, but may assign any of the given 10 IP
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
numbers to the peer.
If the peer requests one of these numbers,
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
and that number is not already in use,
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will grant the peers request.
This is useful if the peer wants
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
to re-establish a link using the same IP number as was previously
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
allocated (thus maintaining any existing tcp or udp connections).
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Expand contractions.
2005-02-13 23:45:54 +00:00
If the peer requests an IP number that is either outside
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
of this range or is already in use,
.Nm
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
will suggest a random unused IP number from the range.
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Pp
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
If
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar triggeraddr
Correct the forth arg to "set ifaddr". If specified, it gives the IP number that should be used for initial IPCP config requests, irrespective of MYADDR.
1997-08-19 01:10:24 +00:00
is specified, it is used in place of
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar myaddr
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
in the initial IPCP negotiation.
However, only an address in the
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar myaddr
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
range will be accepted.
This is useful when negotiating with some
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dv PPP
implementations that will not assign an IP number unless their peer
requests
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Dq 0.0.0.0 .
Make it clear that using "add ...." in ppp.conf when not in -auto mode isn't a good idea, and that the add should be done in ppp.linkup instead. Change "add 0 0 HISADDR" to "add default HISADDR". It's more intuitive.
1998-01-04 21:28:49 +00:00
.Pp
It should be noted that in
.Fl auto
mode,
.Nm
will configure the interface immediately upon reading the
.Dq set ifaddr
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
line in the config file.
In any other mode, these values are just
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
used for IPCP negotiations, and the interface is not configured
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
until the IPCP layer is up.
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Note that the
.Ar HISADDR
argument may be overridden by the third field in the
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
.Pa ppp.secret
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
file once the client has authenticated itself
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(if PAP or CHAP are
.Dq enabled ) .
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Refer to the
Use ``Sx'' when xref'ing sections.
1999-03-18 21:53:56 +00:00
.Sx AUTHENTICATING INCOMING CONNECTIONS
o Allow the use of HISADDR as the first arg to "add". o Allow a forth argument in ppp.secret, specifying a new label. This gives control over which section of ppp.link{up,down} is used based on the authenticated user. o Support random address ranges in ppp.secret (not just in ppp.conf). o Add a AUTHENTICATING INCOMING CONNECTIONS section to the man page. o Add a bit more about DEFLATE in the man page. o Fix the incorrect "you must specify a password in interactive mode" bit of the manual. o Space things in the man page consistently. o Be more precice about where you can use MYADDR, HISADDR and INTERFACE in the "add" command documentation.
1998-01-05 01:35:20 +00:00
section for details.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
In all cases, if the interface is already configured,
.Nm
will try to maintain the interface IP numbers so that any existing
bound sockets will remain valid.
Add ``set ifqueue'' to control the size of the outgoing packet queue. Doing ``set ifqueue 0'' and ``set urgent none'' will allow full use of luigi's WF2Q code. Requested by: luigi
2000-06-11 02:30:51 +00:00
.It set ifqueue Ar packets
Set the maximum number of packets that
.Nm
will read from the tunnel interface while data cannot be sent to any of
A few more hard-sentence breaks.
2000-06-13 10:03:28 +00:00
the available links.
This queue limit is necessary to flow control outgoing data as the tunnel
interface is likely to be far faster than the combined links available to
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Add ``set ifqueue'' to control the size of the outgoing packet queue. Doing ``set ifqueue 0'' and ``set urgent none'' will allow full use of luigi's WF2Q code. Requested by: luigi
2000-06-11 02:30:51 +00:00
.Pp
If
.Ar packets
is set to a value less than the number of links,
.Nm
will read up to that value regardless.
This prevents any possible latency problems.
.Pp
The default value for
.Ar packets
is
.Dq 30 .
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set ccpretry|ccpretries Oo Ar timeout
.Op Ar reqtries Op Ar trmtries
.Oc
.It set chapretry|chapretries Oo Ar timeout
.Op Ar reqtries
.Oc
.It set ipcpretry|ipcpretries Oo Ar timeout
.Op Ar reqtries Op Ar trmtries
.Oc
- made ppp compliant to RFC 2472 (based on a patch from another contributor) - support ipv6cpretry and ipv6cpretries, which are IPv6 versions of ipcpretry and ipcpretries. - improve handling of IPv6 link-local addresses Submitted by: JINMEI Tatuya <jinmei@isl.rdc.toshiba.co.jp>
2002-08-29 02:44:58 +00:00
.It set ipv6cpretry|ipv6cpretries Oo Ar timeout
.Op Ar reqtries Op Ar trmtries
.Oc
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set lcpretry|lcpretries Oo Ar timeout
.Op Ar reqtries Op Ar trmtries
.Oc
.It set papretry|papretries Oo Ar timeout
.Op Ar reqtries
.Oc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
These commands set the number of seconds that
.Nm
will wait before resending Finite State Machine (FSM) Request packets.
The default
Allow control over the number of ConfigREQ & TermREQ attempts that are made in each of the FSMs (LCP, CCP & IPCP) and the number of REQs/Challenges for PAP/CHAP by accepting more arguments in the ``set {c,ip,l}cpretry'' and ``set {ch,p}apretry'' commands. Change the non-convergence thresholds to 3 times the number of configured REQ tries (rather than the previous fixed ``10''). We now notice repeated NAKs and REJs rather than just REQs. Don't suggest that CHAP 0x05 isn't supported when it's not configured. Fix some bugs that expose themselves with smaller numbers of retries: o Handle instantaneous disconnects (set device /dev/null) correctly by stopping all fsm timers in fsm2initial. o Don't forget to uu_unlock() devices that are files but are not ttys (set device /dev/zero). Fix a *HORRENDOUS* bug in RFC1661 (already fixed for an Open event in state ``Closed''): According to the state transition table, a RCR+ or RCR- received in the ``Stopped'' state are supposed to InitRestartCounter, SendConfigReq and SendConfig{Ack,Nak}. However, in ``Stopped'', we haven't yet done a TLS (or the last thing we did is a TLF). We must therefore do the TLS at this point ! This was never noticed before because LCP and CCP used not use LayerStart() for anything interesting, and IPCP tends to go into Stopped then get a Down because of an LCP RTR rather than getting a RCR again.
1999-02-26 21:28:14 +00:00
.Ar timeout
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
for all FSMs is 3 seconds (which should suffice in most cases).
Allow control over the number of ConfigREQ & TermREQ attempts that are made in each of the FSMs (LCP, CCP & IPCP) and the number of REQs/Challenges for PAP/CHAP by accepting more arguments in the ``set {c,ip,l}cpretry'' and ``set {ch,p}apretry'' commands. Change the non-convergence thresholds to 3 times the number of configured REQ tries (rather than the previous fixed ``10''). We now notice repeated NAKs and REJs rather than just REQs. Don't suggest that CHAP 0x05 isn't supported when it's not configured. Fix some bugs that expose themselves with smaller numbers of retries: o Handle instantaneous disconnects (set device /dev/null) correctly by stopping all fsm timers in fsm2initial. o Don't forget to uu_unlock() devices that are files but are not ttys (set device /dev/zero). Fix a *HORRENDOUS* bug in RFC1661 (already fixed for an Open event in state ``Closed''): According to the state transition table, a RCR+ or RCR- received in the ``Stopped'' state are supposed to InitRestartCounter, SendConfigReq and SendConfig{Ack,Nak}. However, in ``Stopped'', we haven't yet done a TLS (or the last thing we did is a TLF). We must therefore do the TLS at this point ! This was never noticed before because LCP and CCP used not use LayerStart() for anything interesting, and IPCP tends to go into Stopped then get a Down because of an LCP RTR rather than getting a RCR again.
1999-02-26 21:28:14 +00:00
.Pp
If
.Ar reqtries
is specified, it tells
.Nm
how many configuration request attempts it should make while receiving
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
no reply from the peer before giving up.
The default is 5 attempts for
Allow control over the number of ConfigREQ & TermREQ attempts that are made in each of the FSMs (LCP, CCP & IPCP) and the number of REQs/Challenges for PAP/CHAP by accepting more arguments in the ``set {c,ip,l}cpretry'' and ``set {ch,p}apretry'' commands. Change the non-convergence thresholds to 3 times the number of configured REQ tries (rather than the previous fixed ``10''). We now notice repeated NAKs and REJs rather than just REQs. Don't suggest that CHAP 0x05 isn't supported when it's not configured. Fix some bugs that expose themselves with smaller numbers of retries: o Handle instantaneous disconnects (set device /dev/null) correctly by stopping all fsm timers in fsm2initial. o Don't forget to uu_unlock() devices that are files but are not ttys (set device /dev/zero). Fix a *HORRENDOUS* bug in RFC1661 (already fixed for an Open event in state ``Closed''): According to the state transition table, a RCR+ or RCR- received in the ``Stopped'' state are supposed to InitRestartCounter, SendConfigReq and SendConfig{Ack,Nak}. However, in ``Stopped'', we haven't yet done a TLS (or the last thing we did is a TLF). We must therefore do the TLS at this point ! This was never noticed before because LCP and CCP used not use LayerStart() for anything interesting, and IPCP tends to go into Stopped then get a Down because of an LCP RTR rather than getting a RCR again.
1999-02-26 21:28:14 +00:00
CCP, LCP and IPCP and 3 attempts for PAP and CHAP.
.Pp
If
.Ar trmtries
is specified, it tells
.Nm
how many terminate requests should be sent before giving up waiting for the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
peers response.
The default is 3 attempts.
Authentication protocols are
Allow control over the number of ConfigREQ & TermREQ attempts that are made in each of the FSMs (LCP, CCP & IPCP) and the number of REQs/Challenges for PAP/CHAP by accepting more arguments in the ``set {c,ip,l}cpretry'' and ``set {ch,p}apretry'' commands. Change the non-convergence thresholds to 3 times the number of configured REQ tries (rather than the previous fixed ``10''). We now notice repeated NAKs and REJs rather than just REQs. Don't suggest that CHAP 0x05 isn't supported when it's not configured. Fix some bugs that expose themselves with smaller numbers of retries: o Handle instantaneous disconnects (set device /dev/null) correctly by stopping all fsm timers in fsm2initial. o Don't forget to uu_unlock() devices that are files but are not ttys (set device /dev/zero). Fix a *HORRENDOUS* bug in RFC1661 (already fixed for an Open event in state ``Closed''): According to the state transition table, a RCR+ or RCR- received in the ``Stopped'' state are supposed to InitRestartCounter, SendConfigReq and SendConfig{Ack,Nak}. However, in ``Stopped'', we haven't yet done a TLS (or the last thing we did is a TLF). We must therefore do the TLS at this point ! This was never noticed before because LCP and CCP used not use LayerStart() for anything interesting, and IPCP tends to go into Stopped then get a Down because of an LCP RTR rather than getting a RCR again.
1999-02-26 21:28:14 +00:00
not terminated and it is therefore invalid to specify
.Ar trmtries
for PAP or CHAP.
.Pp
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
In order to avoid negotiations with the peer that will never converge,
Allow control over the number of ConfigREQ & TermREQ attempts that are made in each of the FSMs (LCP, CCP & IPCP) and the number of REQs/Challenges for PAP/CHAP by accepting more arguments in the ``set {c,ip,l}cpretry'' and ``set {ch,p}apretry'' commands. Change the non-convergence thresholds to 3 times the number of configured REQ tries (rather than the previous fixed ``10''). We now notice repeated NAKs and REJs rather than just REQs. Don't suggest that CHAP 0x05 isn't supported when it's not configured. Fix some bugs that expose themselves with smaller numbers of retries: o Handle instantaneous disconnects (set device /dev/null) correctly by stopping all fsm timers in fsm2initial. o Don't forget to uu_unlock() devices that are files but are not ttys (set device /dev/zero). Fix a *HORRENDOUS* bug in RFC1661 (already fixed for an Open event in state ``Closed''): According to the state transition table, a RCR+ or RCR- received in the ``Stopped'' state are supposed to InitRestartCounter, SendConfigReq and SendConfig{Ack,Nak}. However, in ``Stopped'', we haven't yet done a TLS (or the last thing we did is a TLF). We must therefore do the TLS at this point ! This was never noticed before because LCP and CCP used not use LayerStart() for anything interesting, and IPCP tends to go into Stopped then get a Down because of an LCP RTR rather than getting a RCR again.
1999-02-26 21:28:14 +00:00
.Nm
will only send at most 3 times the configured number of
.Ar reqtries
in any given negotiation session before giving up and closing that layer.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set log Xo
.Op local
.Op +|- Ns
.Ar value Ns No ...
.Xc
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This command allows the adjustment of the current log level.
Refer to the Logging Facility section for further details.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set login Ar chat-script
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
This
.Ar chat-script
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
compliments the dial-script.
If both are specified, the login
script will be executed after the dial script.
Escape sequences available in the dial script are also available here.
Introduce ``set logout''; another chat script. This is in preparation for the abstraction of ``set dial'' and ``set hangup''.
1999-10-25 13:49:44 +00:00
.It set logout Ar chat-script
This specifies the chat script that will be used to logout
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
before the hangup script is called.
It should not normally be necessary.
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
.It set lqrperiod|echoperiod Ar frequency
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
This command sets the
.Ar frequency
in seconds at which
.Em LQR
or
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
.Em LCP ECHO
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
packets are sent.
The default is 30 seconds.
You must also use the
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq enable lqr
Implement an ``enable/disable echo'' option, defaults to off. This allows LCP ECHOs to be enabled independently of LQR reports. Note: This introduces a change in the default behaviour (search for lqr and echo in the man page). I'll update UPDATING to reflect this. PR: 74821
2004-12-13 12:51:19 +00:00
and/or
.Dq enable echo
commands if you wish to send
.Em LQR
or
.Em LCP ECHO
requests to the peer.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set mode Ar interactive|auto|ddial|background
This command allows you to change the
.Sq mode
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
of the specified link.
This is normally only useful in multi-link mode,
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
but may also be used in uni-link mode.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
It is not possible to change a link that is
.Sq direct
or
.Sq dedicated .
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Pp
Note: If you issue the command
.Dq set mode auto ,
o Add the -foreground switch. This switch behaves like -background except that ppp stays in the foreground. o Add the -quiet switch to quieten ppps startup o Add the -nat flag and discourage the use of the -alias flag. Both do the same thing. o Correct some nat usage strings. o Change the internal ``alias'' command to ``nat''.
1999-08-19 18:15:52 +00:00
and have network address translation enabled, it may be useful to
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Dq enable iface-alias
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
afterwards.
This will allow
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.Nm
to do the necessary address translations to enable the process that
triggers the connection to connect once the link is up despite the
peer assigning us a new (dynamic) IP address.
Spell stateful properly Inconsistently done by: brian Spotted by: ru
2001-07-06 23:45:32 +00:00
.It set mppe Op 40|56|128|* Op stateless|stateful|*
Add support for stateful MPPE (microsoft encryption) providing encryption compatibility with Windows 2000. Stateful encryption uses less CPU but is bad on lossy transports. The ``set mppe'' command has been expanded. If it's used with any arguments, ppp will insist on encryption, closing LCP if the other end refuses. Unfortunately, Microsoft have abused the CCP reset request so that receiving a reset request does not result in a reset ack when using MPPE... Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 15:00:22 +00:00
This option selects the encryption parameters used when negotiation
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
MPPE.
MPPE can be disabled entirely with the
Add support for stateful MPPE (microsoft encryption) providing encryption compatibility with Windows 2000. Stateful encryption uses less CPU but is bad on lossy transports. The ``set mppe'' command has been expanded. If it's used with any arguments, ppp will insist on encryption, closing LCP if the other end refuses. Unfortunately, Microsoft have abused the CCP reset request so that receiving a reset request does not result in a reset ack when using MPPE... Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 15:00:22 +00:00
.Dq disable mppe
command.
If no arguments are given,
.Nm
Spell stateful properly Inconsistently done by: brian Spotted by: ru
2001-07-06 23:45:32 +00:00
will attempt to negotiate a stateful link with a 128 bit key, but
Add support for stateful MPPE (microsoft encryption) providing encryption compatibility with Windows 2000. Stateful encryption uses less CPU but is bad on lossy transports. The ``set mppe'' command has been expanded. If it's used with any arguments, ppp will insist on encryption, closing LCP if the other end refuses. Unfortunately, Microsoft have abused the CCP reset request so that receiving a reset request does not result in a reset ack when using MPPE... Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 15:00:22 +00:00
will agree to whatever the peer requests (including no encryption
at all).
.Pp
If any arguments are given,
.Nm
will
.Em insist
Expand contractions.
2005-02-13 23:45:54 +00:00
on using MPPE and will close the link if it is rejected by the peer (Note;
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
this behaviour can be overridden by a configured RADIUS server).
Add support for stateful MPPE (microsoft encryption) providing encryption compatibility with Windows 2000. Stateful encryption uses less CPU but is bad on lossy transports. The ``set mppe'' command has been expanded. If it's used with any arguments, ppp will insist on encryption, closing LCP if the other end refuses. Unfortunately, Microsoft have abused the CCP reset request so that receiving a reset request does not result in a reset ack when using MPPE... Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 15:00:22 +00:00
.Pp
The first argument specifies the number of bits that
.Nm
should insist on during negotiations and the second specifies whether
.Nm
Spell stateful properly Inconsistently done by: brian Spotted by: ru
2001-07-06 23:45:32 +00:00
should insist on stateful or stateless mode.
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
In stateless mode, the
Add support for stateful MPPE (microsoft encryption) providing encryption compatibility with Windows 2000. Stateful encryption uses less CPU but is bad on lossy transports. The ``set mppe'' command has been expanded. If it's used with any arguments, ppp will insist on encryption, closing LCP if the other end refuses. Unfortunately, Microsoft have abused the CCP reset request so that receiving a reset request does not result in a reset ack when using MPPE... Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 15:00:22 +00:00
encryption dictionary is re-initialised with every packet according to
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
an encryption key that is changed with every packet.
Spell stateful properly Inconsistently done by: brian Spotted by: ru
2001-07-06 23:45:32 +00:00
In stateful mode,
Add support for stateful MPPE (microsoft encryption) providing encryption compatibility with Windows 2000. Stateful encryption uses less CPU but is bad on lossy transports. The ``set mppe'' command has been expanded. If it's used with any arguments, ppp will insist on encryption, closing LCP if the other end refuses. Unfortunately, Microsoft have abused the CCP reset request so that receiving a reset request does not result in a reset ack when using MPPE... Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 15:00:22 +00:00
the encryption dictionary is re-initialised every 256 packets or after
the loss of any data and the key is changed every 256 packets.
Stateless mode is less efficient but is better for unreliable transport
layers.
o Allow ``set mrru'' or ``set mrru 0'' to disable multi-link mode. o Fix a typo in the ``set mrru'' description.
1998-06-16 23:23:57 +00:00
.It set mrru Op Ar value
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
Setting this option enables Multi-link PPP negotiations, also known as
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Multi-link Protocol or MP.
There is no default MRRU (Maximum Reconstructed Receive Unit) value.
If no argument is given, multi-link mode is disabled.
Avoid using too many args for ``set m[tr]u'' This needs to work with OpenBSD's groff too :(
2001-06-20 19:55:58 +00:00
.It set mru Xo
.Op max Ns Op imum
.Op Ar value
.Xc
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
The default MRU (Maximum Receive Unit) is 1500.
If it is increased, the other side *may* increase its MTU.
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
In theory there is no point in decreasing the MRU to below the default as the
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Em PPP
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
protocol says implementations *must* be able to accept packets of at
least 1500 octets.
.Pp
If the
.Dq maximum
keyword is used,
.Nm
will refuse to negotiate a higher value.
The maximum MRU can be set to 2048 at most.
Setting a maximum of less than 1500 violates the
.Em PPP
rfc, but may sometimes be necessary.
For example,
.Em PPPoE
imposes a maximum of 1492 due to hardware limitations.
.Pp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
If no argument is given, 1500 is assumed.
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
A value must be given when
.Dq maximum
is specified.
Avoid using too many args for ``set m[tr]u'' This needs to work with OpenBSD's groff too :(
2001-06-20 19:55:58 +00:00
.It set mtu Xo
.Op max Ns Op imum
.Op Ar value
.Xc
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
The default MTU is 1500.
At negotiation time,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Expand contractions.
2005-02-13 23:45:54 +00:00
will accept whatever MRU the peer requests (assuming it is
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
not less than 296 bytes or greater than the assigned maximum).
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
If the MTU is set,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
will not accept MRU values less than
o Fix remaining sizeof problems for 64 bit machines. o Allow ``set ....'' when we have multiple links but aren't in multilink mode. o Do a TLS when we receive a ``Open'' event in ``Closed'' state, despite the rfc state transition table. This is clearly an error in the RFC as TLS cannot have yet been called (without TLF) in the ``Closed'' state. I've posted a message to comp.protocols.ppp for confirmation.
1998-06-27 23:48:54 +00:00
.Ar value .
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
When negotiations are complete, the MTU is used when writing to the
interface, even if the peer requested a higher value MRU.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This can be useful for
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
limiting your packet size (giving better bandwidth sharing at the expense
of more header data).
o Fix remaining sizeof problems for 64 bit machines. o Allow ``set ....'' when we have multiple links but aren't in multilink mode. o Do a TLS when we receive a ``Open'' event in ``Closed'' state, despite the rfc state transition table. This is clearly an error in the RFC as TLS cannot have yet been called (without TLF) in the ``Closed'' state. I've posted a message to comp.protocols.ppp for confirmation.
1998-06-27 23:48:54 +00:00
.Pp
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
If the
.Dq maximum
keyword is used,
.Nm
will refuse to negotiate a higher value.
The maximum MTU can be set to 2048 at most.
Mention that ``set mtu max'' is necessary for PPPoE. PR: 32040 MFC after: 2 weeks
2004-06-29 07:48:43 +00:00
Note, it is necessary to use the
.Dq maximum
keyword to limit the MTU when using PPPoE.
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
.Pp
o Fix remaining sizeof problems for 64 bit machines. o Allow ``set ....'' when we have multiple links but aren't in multilink mode. o Do a TLS when we receive a ``Open'' event in ``Closed'' state, despite the rfc state transition table. This is clearly an error in the RFC as TLS cannot have yet been called (without TLF) in the ``Closed'' state. I've posted a message to comp.protocols.ppp for confirmation.
1998-06-27 23:48:54 +00:00
If no
.Ar value
is given, 1500, or whatever the peer asks for is used.
Handle hardware-imposed MTU/MRU limitations. PPPoE will no longer allow MRU/MTU negotiations to exceed 1492. Add an optional ``max'' specifier to ``set m[rt]u'', ie. set mtu max 1480 Bump the ppp version number. Sponsored by: Monzoon Networks AG and FreeBSD Services Limited
2001-06-18 14:59:36 +00:00
A value must be given when
.Dq maximum
is specified.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set nbns Op Ar x.x.x.x Op Ar y.y.y.y
This option allows the setting of the Microsoft NetBIOS name server
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
values to be returned at the peers request.
If no values are given,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Nm
will reject any such requests.
.It set openmode active|passive Op Ar delay
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
By default,
.Ar openmode
is always
Allow an optional delay when specifying "set openmode active". The delay defaults to 1 sec (as it always has) unless we've done a ~p in interactive mode or we've actually detected a HDLC frame. This is now cleanly implemented (via async timers) so that it is possible for LCP to come up despite the delay if an LCP REQ is received. This will hopefully solve situations with slow servers or slirp scenarios (where ECHO is left on the port for a second or so before the peer enters packet mode). Also, ~p in interactive mode no longer changes the value of the default openmode delay and -dedicated mode enters packet mode in the right state according to the value of openmode.
1998-01-20 22:47:48 +00:00
.Ar active
with a one second
.Ar delay .
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
That is,
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
Allow an optional delay when specifying "set openmode active". The delay defaults to 1 sec (as it always has) unless we've done a ~p in interactive mode or we've actually detected a HDLC frame. This is now cleanly implemented (via async timers) so that it is possible for LCP to come up despite the delay if an LCP REQ is received. This will hopefully solve situations with slow servers or slirp scenarios (where ECHO is left on the port for a second or so before the peer enters packet mode). Also, ~p in interactive mode no longer changes the value of the default openmode delay and -dedicated mode enters packet mode in the right state according to the value of openmode.
1998-01-20 22:47:48 +00:00
will always initiate LCP/IPCP/CCP negotiation one second after the line
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
comes up.
If you want to wait for the peer to initiate negotiations, you
Allow an optional delay when specifying "set openmode active". The delay defaults to 1 sec (as it always has) unless we've done a ~p in interactive mode or we've actually detected a HDLC frame. This is now cleanly implemented (via async timers) so that it is possible for LCP to come up despite the delay if an LCP REQ is received. This will hopefully solve situations with slow servers or slirp scenarios (where ECHO is left on the port for a second or so before the peer enters packet mode). Also, ~p in interactive mode no longer changes the value of the default openmode delay and -dedicated mode enters packet mode in the right state according to the value of openmode.
1998-01-20 22:47:48 +00:00
can use the value
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar passive .
Allow an optional delay when specifying "set openmode active". The delay defaults to 1 sec (as it always has) unless we've done a ~p in interactive mode or we've actually detected a HDLC frame. This is now cleanly implemented (via async timers) so that it is possible for LCP to come up despite the delay if an LCP REQ is received. This will hopefully solve situations with slow servers or slirp scenarios (where ECHO is left on the port for a second or so before the peer enters packet mode). Also, ~p in interactive mode no longer changes the value of the default openmode delay and -dedicated mode enters packet mode in the right state according to the value of openmode.
1998-01-20 22:47:48 +00:00
If you want to initiate negotiations immediately or after more than one
second, the appropriate
.Ar delay
may be specified here in seconds.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It set parity odd|even|none|mark
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This allows the line parity to be set.
The default value is
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar none .
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set phone Ar telno Ns Xo
mdoc fixes.
2012-09-08 08:46:43 +00:00
.Oo \&| Ns Ar backupnumber Oc Ns ... Ns Oo : Ns Ar nextnumber Oc Ns ... Xc
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This allows the specification of the phone number to be used in
place of the \\\\T string in the dial and login chat scripts.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
Multiple phone numbers may be given separated either by a pipe
.Pq Dq \&|
or a colon
.Pq Dq \&: .
.Pp
Numbers after the pipe are only dialed if the dial or login
script for the previous number failed.
.Pp
Numbers after the colon are tried sequentially, irrespective of
the reason the line was dropped.
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
If multiple numbers are given,
.Nm
Phone the number after the ``|'' whether the dial OR login script fails. Catch a small typo in the man page.
1997-08-23 23:14:24 +00:00
will dial them according to these rules until a connection is made, retrying
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
the maximum number of times specified by
.Dq set redial
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
below.
In
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Fl background
mode, each number is attempted at most once.
Add configuration option "set pppoe [standard|3Com]" which allows to configure mode for ng_pppoe(4) node under control. Reviewed by: brian Approved by: julian (mentor)
2004-07-29 05:59:43 +00:00
.It set pppoe Op standard|3Com
This option configures the underlying
.Xr ng_pppoe 4
node to either standard RFC2516 PPPoE or proprietary 3Com mode.
If not set the system default will be used.
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It set Oo proc Oc Ns Xo
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No title Op Ar value
.Xc
Add ``set proctitle'' for changing argv[0]. All substitutions are done in the same way as command execution. For example, ``set proctitle USER INTERFACE PROCESSID'' would be useful in a -direct profile for identifying who's connected.
1998-10-27 22:53:22 +00:00
The current process title as displayed by
.Xr ps 1
is changed according to
.Ar value .
If
.Ar value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is not specified, the original process title is restored.
All the
Add ``set proctitle'' for changing argv[0]. All substitutions are done in the same way as command execution. For example, ``set proctitle USER INTERFACE PROCESSID'' would be useful in a -direct profile for identifying who's connected.
1998-10-27 22:53:22 +00:00
word replacements done by the shell commands (see the
.Dq bg
command above) are done here too.
Suggest that ``set proctitle'' is used in ppp.linkup when USER is expected to be expanded.
1999-01-19 22:15:41 +00:00
.Pp
Note, if USER is required in the process title, the
.Dq set proctitle
command must appear in
.Pa ppp.linkup ,
as it is not known when the commands in
.Pa ppp.conf
are executed.
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.It set radius Op Ar config-file
Expand contractions.
2005-02-13 23:45:54 +00:00
This command enables RADIUS support (if it is compiled in).
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.Ar config-file
refers to the radius client configuration file as described in
.Xr radius.conf 5 .
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
If PAP, CHAP, MSCHAP or MSCHAPv2 are
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.Dq enable Ns No d ,
.Nm
behaves as a
.Em \&N Ns No etwork
.Em \&A Ns No ccess
.Em \&S Ns No erver
and uses the configured RADIUS server to authenticate rather than
authenticating from the
.Pa ppp.secret
file or from the passwd database.
.Pp
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
If none of PAP, CHAP, MSCHAP or MSCHAPv2 are enabled,
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.Dq set radius
will do nothing.
.Pp
.Nm
uses the following attributes from the RADIUS reply:
.Bl -tag -width XXX -offset XXX
.It RAD_FRAMED_IP_ADDRESS
The peer IP address is set to the given value.
.It RAD_FRAMED_IP_NETMASK
The tun interface netmask is set to the given value.
.It RAD_FRAMED_MTU
If the given MTU is less than the peers MRU as agreed during LCP
negotiation, *and* it is less that any configured MTU (see the
.Dq set mru
command), the tun interface MTU is set to the given value.
.It RAD_FRAMED_COMPRESSION
If the received compression type is
.Dq 1 ,
.Nm
will request VJ compression during IPCP negotiations despite any
.Dq disable vj
configuration command.
Understand the Session-Timeout RADIUS attribute Store the Filter-Id attribute (we don't do anything with it yet) Submitted mostly by: andrew pavlov <and@kremenchug.net>
2002-05-07 10:06:54 +00:00
.It RAD_FILTER_ID
If a RAD_FILTER_ID is supplied by the RADIUS server, treat it as an additional label from ppp.linkup & ppp.linkdown to load. Suggested and mostly submitted by: andrew pavlov <and@kremenchug.net>
2002-06-12 23:45:15 +00:00
If this attribute is supplied,
.Nm
will attempt to use it as an additional label to load from the
.Pa ppp.linkup
and
.Pa ppp.linkdown
files.
The load will be attempted before (and in addition to) the normal
label search.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
If the label does not exist, no action is taken and
If a RAD_FILTER_ID is supplied by the RADIUS server, treat it as an additional label from ppp.linkup & ppp.linkdown to load. Suggested and mostly submitted by: andrew pavlov <and@kremenchug.net>
2002-06-12 23:45:15 +00:00
.Nm
proceeds to the normal load using the current label.
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.It RAD_FRAMED_ROUTE
The received string is expected to be in the format
.Ar dest Ns Op / Ns Ar bits
.Ar gw
.Op Ar metrics .
Any specified metrics are ignored.
.Dv MYADDR
and
.Dv HISADDR
are understood as valid values for
.Ar dest
and
.Ar gw ,
.Dq default
can be used for
.Ar dest
to sepcify the default route, and
.Dq 0.0.0.0
is understood to be the same as
.Dq default
for
.Ar dest
and
.Dv HISADDR
for
.Ar gw .
.Pp
For example, a returned value of
.Dq 1.2.3.4/24 0.0.0.0 1 2 -1 3 400
would result in a routing table entry to the 1.2.3.0/24 network via
.Dv HISADDR
and a returned value of
.Dq 0.0.0.0 0.0.0.0
or
.Dq default HISADDR
would result in a default route to
.Dv HISADDR .
.Pp
All RADIUS routes are applied after any sticky routes are applied, making
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
RADIUS routes override configured routes.
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
This also applies for RADIUS routes that do not {include} the
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.Dv MYADDR
or
.Dv HISADDR
keywords.
.Pp
Mention the use of Framed-IPv6-Prefix. MFC after: 1 week
2003-06-20 18:14:57 +00:00
.It RAD_FRAMED_IPV6_PREFIX
If this attribute is supplied, the value is substituted for IPV6PREFIX
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
in a command.
Add a missing phrase. Submitted by: Jason McIntyre jmc at kerhand dot co dot uk Approved by: re (kib) Obtained from: OpenBSD MFC after: 3 weeks
2009-07-05 16:55:57 +00:00
You may pass it to an upper layer protocol such as DHCPv6 for delegating an
Mention the use of Framed-IPv6-Prefix. MFC after: 1 week
2003-06-20 18:14:57 +00:00
IPv6 prefix to a peer.
Mention the use of Framed-IPv6-Route. MFC after: 1 week
2003-06-20 15:44:52 +00:00
.It RAD_FRAMED_IPV6_ROUTE
The received string is expected to be in the format
.Ar dest Ns Op / Ns Ar bits
.Ar gw
.Op Ar metrics .
Any specified metrics are ignored.
.Dv MYADDR6
and
.Dv HISADDR6
are understood as valid values for
.Ar dest
and
.Ar gw ,
.Dq default
can be used for
.Ar dest
to sepcify the default route, and
.Dq ::
is understood to be the same as
.Dq default
for
.Ar dest
and
.Dv HISADDR6
for
.Ar gw .
.Pp
For example, a returned value of
.Dq 3ffe:505:abcd::/48 ::
would result in a routing table entry to the 3ffe:505:abcd::/48 network via
.Dv HISADDR6
and a returned value of
.Dq :: ::
or
.Dq default HISADDR6
would result in a default route to
.Dv HISADDR6 .
.Pp
All RADIUS IPv6 routes are applied after any sticky routes are
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
applied, making RADIUS IPv6 routes override configured routes.
This
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
also applies for RADIUS IPv6 routes that do not {include} the
Mention the use of Framed-IPv6-Route. MFC after: 1 week
2003-06-20 15:44:52 +00:00
.Dv MYADDR6
or
.Dv HISADDR6
keywords.
.Pp
Understand the Session-Timeout RADIUS attribute Store the Filter-Id attribute (we don't do anything with it yet) Submitted mostly by: andrew pavlov <and@kremenchug.net>
2002-05-07 10:06:54 +00:00
.It RAD_SESSION_TIMEOUT
If supplied, the client connection is closed after the given number of
seconds.
Add support for MS-CHAP authentication via a RADIUS server. Add support for Reply-Message and MS-CHAP-Error. Sponsored by: Monzoon
2002-05-10 03:11:35 +00:00
.It RAD_REPLY_MESSAGE
If supplied, this message is passed back to the peer as the authentication
SUCCESS text.
.It RAD_MICROSOFT_MS_CHAP_ERROR
If this
.Dv RAD_VENDOR_MICROSOFT
vendor specific attribute is supplied, it is passed back to the peer as the
authentication FAILURE text.
Document RAD_MICROSOFT_MS_CHAP2_SUCCESS.
2002-05-18 23:58:15 +00:00
.It RAD_MICROSOFT_MS_CHAP2_SUCCESS
If this
.Dv RAD_VENDOR_MICROSOFT
vendor specific attribute is supplied and if MS-CHAPv2 authentication is
being used, it is passed back to the peer as the authentication SUCCESS text.
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
.It RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY
If this
.Dv RAD_VENDOR_MICROSOFT
vendor specific attribute is supplied and has a value of 2 (Required),
.Nm
will insist that MPPE encryption is used (even if no
.Dq set mppe
configuration command has been given with arguments).
If it is supplied with a value of 1 (Allowed), encryption is made optional
(despite any
.Dq set mppe
configuration commands with arguments).
.It RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES
If this
.Dv RAD_VENDOR_MICROSOFT
vendor specific attribute is supplied, bits 1 and 2 are examined.
If either or both are set, 40 bit and/or 128 bit (respectively) encryption
options are set, overriding any given first argument to the
.Dq set mppe
command.
Note, it is not currently possible for the RADIUS server to specify 56 bit
encryption.
.It RAD_MICROSOFT_MS_MPPE_RECV_KEY
If this
.Dv RAD_VENDOR_MICROSOFT
Expand contractions.
2005-02-13 23:45:54 +00:00
vendor specific attribute is supplied, it is value is used as the master
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
key for decryption of incoming data.
When clients are authenticated using
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
MSCHAPv2, the RADIUS server MUST provide this attribute if inbound MPPE is
to function.
.It RAD_MICROSOFT_MS_MPPE_SEND_KEY
If this
.Dv RAD_VENDOR_MICROSOFT
Expand contractions.
2005-02-13 23:45:54 +00:00
vendor specific attribute is supplied, it is value is used as the master
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
key for encryption of outgoing data.
When clients are authenticated using
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
MSCHAPv2, the RADIUS server MUST provide this attribute if outbound MPPE is
to function.
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
.El
Understand the following Microsoft Vendor Specific RADIUS attributes: RAD_MICROSOFT_MS_MPPE_ENCRYPTION_POLICY RAD_MICROSOFT_MS_MPPE_ENCRYPTION_TYPES RAD_MICROSOFT_MS_MPPE_RECV_KEY RAD_MICROSOFT_MS_MPPE_SEND_KEY These attributes may be supplied by a RADIUS server when MSCHAPv2 is used to authenticate. It *should* now be possible to build ppp with -DNODES and still support CHAP/MSCHAP/MSCHAPv2/MPPE via a RADIUS server, but the code isn't yet smart enough to do that (building with -DNODES just looses these facilities). Sponsored by: Monzoon
2002-06-12 00:33:17 +00:00
.Pp
Initial RADIUS support (using libradius). See the man page for details. Compiling with -DNORADIUS (the default for `release') removes support. TODO: The functionality in libradius::rad_send_request() needs to be supplied as a set of routines so that ppp doesn't have to wait indefinitely for the radius server(s). Instead, we need to get a descriptor back, select() on the descriptor, and ask libradius to service it when necessary. For now, ppp blocks SIGALRM while in rad_send_request(), so it misses PAP/CHAP retries & timeouts if they occur. Only PAP is functional. When CHAP is attempted, libradius complains that no User-Password has been specified... rfc2138 says that it *mustn't* be used for CHAP :-( Sponsored by: Internet Business Solutions Ltd., Switzerland
1999-01-28 01:56:34 +00:00
Values received from the RADIUS server may be viewed using
.Dq show bundle .
Support a ``set rad_alive N'' command to enable periodic RADIUS accounting information being sent to the RADIUS server. Logging of RADIUS accounting information moves to a ``set log [+-]radius'' level, along with the RADIUS alive info, and the version number is bumped to 3.2 to reflect this. Mostly submitted by: alx@sm.ukrtel.net (back in January) MFC after: 3 weeks
2004-07-17 01:07:53 +00:00
.It set rad_alive Ar timeout
When RADIUS is configured, setting
.Dq rad_alive
to a non-zero
.Ar timeout
value will tell
.Nm
to sent RADIUS accounting information to the RADIUS server every
.Ar timeout
seconds.
Add a new option for ppp.conf: rad_port_id. It allows to change the way of what ppp submits to the RADIUS server as NAS-Port-Id. Possible options are: the PID of the process owning the corresponding interface, tun(4) interface number, interface index (as it would get returned by if_nametoindex(3)), or it's possible to keep the default behavior. Check the ppp(8) manual page for details. PR: bin/112764 Submitted by: novel (myself) Reviewed by: flz Approved by: flz MFC after: 1 month
2007-05-25 13:45:49 +00:00
.It set rad_port_id Ar option
Cleanup after previous commit.
2007-05-25 16:05:17 +00:00
When RADIUS is configured, setting the
Add a new option for ppp.conf: rad_port_id. It allows to change the way of what ppp submits to the RADIUS server as NAS-Port-Id. Possible options are: the PID of the process owning the corresponding interface, tun(4) interface number, interface index (as it would get returned by if_nametoindex(3)), or it's possible to keep the default behavior. Check the ppp(8) manual page for details. PR: bin/112764 Submitted by: novel (myself) Reviewed by: flz Approved by: flz MFC after: 1 month
2007-05-25 13:45:49 +00:00
.Dq rad_port_id
value allows to specify what should be sent to the RADIUS server as
NAS-Port-Id.
The
.Ar option Ns No s
are as follows:
.Bl -tag -width Ds
.It pid
PID of the corresponding tunnel.
.It tunnum
Cleanup after previous commit.
2007-05-25 16:05:17 +00:00
.Xr tun 4
interface number.
Add a new option for ppp.conf: rad_port_id. It allows to change the way of what ppp submits to the RADIUS server as NAS-Port-Id. Possible options are: the PID of the process owning the corresponding interface, tun(4) interface number, interface index (as it would get returned by if_nametoindex(3)), or it's possible to keep the default behavior. Check the ppp(8) manual page for details. PR: bin/112764 Submitted by: novel (myself) Reviewed by: flz Approved by: flz MFC after: 1 month
2007-05-25 13:45:49 +00:00
.It ifnum
Cleanup after previous commit.
2007-05-25 16:05:17 +00:00
index of the interface as returned by
.Xr if_nametoindex 3 .
Add a new option for ppp.conf: rad_port_id. It allows to change the way of what ppp submits to the RADIUS server as NAS-Port-Id. Possible options are: the PID of the process owning the corresponding interface, tun(4) interface number, interface index (as it would get returned by if_nametoindex(3)), or it's possible to keep the default behavior. Check the ppp(8) manual page for details. PR: bin/112764 Submitted by: novel (myself) Reviewed by: flz Approved by: flz MFC after: 1 month
2007-05-25 13:45:49 +00:00
.It default
keeps the default behavior.
.El
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set reconnect Ar timeout ntries
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
Should the line drop unexpectedly (due to loss of CD or LQR
failure), a connection will be re-established after the given
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar timeout .
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
The line will be re-connected at most
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar ntries
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
times.
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar Ntries
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
defaults to zero.
A value of
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar random
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
for
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar timeout
When our dial timeout is ``random'', display its value correctly by invoking the timer to get the value before displaying the message. Don't assume that a value of 0 is ``random'' in ``show datalink''. Make the random value between 1 and DIAL_TIMEOUT rather than between 0 and DIAL_TIMEOUT-1
1999-02-25 12:00:04 +00:00
will result in a variable pause, somewhere between 1 and 30 seconds.
Add ``enable proxyall'' support. This adds proxy ARP entries for every machine on every class C or smaller subnet that we route to. Add ``set {send,recv}pipe'' for controlling our socket buffer sizes. Mention the IP number with the problem in a few error messages. All submitted by: Craig Leres <leres@ee.lbl.gov> Modified slightly by: me
1998-10-26 19:07:39 +00:00
.It set recvpipe Op Ar value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This sets the routing table RECVPIPE value.
The optimum value is just over twice the MTU value.
If
Add ``enable proxyall'' support. This adds proxy ARP entries for every machine on every class C or smaller subnet that we route to. Add ``set {send,recv}pipe'' for controlling our socket buffer sizes. Mention the IP number with the problem in a few error messages. All submitted by: Craig Leres <leres@ee.lbl.gov> Modified slightly by: me
1998-10-26 19:07:39 +00:00
.Ar value
is unspecified or zero, the default kernel controlled value is used.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set redial Ar secs Ns Xo
.Oo + Ns Ar inc Ns
mdoc fixes.
2012-09-08 08:46:43 +00:00
.Oo - Ns Ar max Ns Oc Oc Ns
.Op . Ns Ar next
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Op Ar attempts
.Xc
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
can be instructed to attempt to redial
Allow random IP number allocation to peer. Validate the peers suggested IP by attempting to make a routing table entry. Give up IPCP negotiation if the peer NAKs us with an unusable IP. Always SIOCDIFADDR then SIOCAIFADDR when configuring the tun device. Using SIOCSIFDSTADDR allows duplicate dst addresses (which we don't want)!!! Allow up to 200 interface names (was 50) (now that ppp can play server properly). Up the version number (1.5 -> 1.6). Cosmetic: Log unexpected CCP packets in the CCP log rather than the ERROR log. Log unexpected Config Reqs in the appropriate LCP/IPCP/CCP log rather than the ERROR log. Log failed route additions and deletions with WARN, not TCPIP. Log the option id and length for unrecognised IPCP options. Change some .Sq to .Ar in the man page.
1997-12-13 02:37:33 +00:00
.Ar attempts
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
times.
If more than one phone number is specified (see
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Dq set phone
above), a pause of
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar next
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is taken before dialing each number.
A pause of
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar secs
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is taken before starting at the first number again.
A literal value of
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Dq Li random
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
may be used here in place of
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar secs
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
and
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
.Ar next ,
When our dial timeout is ``random'', display its value correctly by invoking the timer to get the value before displaying the message. Don't assume that a value of 0 is ``random'' in ``show datalink''. Make the random value between 1 and DIAL_TIMEOUT rather than between 0 and DIAL_TIMEOUT-1
1999-02-25 12:00:04 +00:00
causing a random delay of between 1 and 30 seconds.
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
.Pp
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
If
.Ar inc
is specified, its value is added onto
.Ar secs
each time
.Nm
tries a new number.
.Ar secs
will only be incremented at most
Be a bit more consistent with variable names.
1999-07-27 00:30:32 +00:00
.Ar max
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
times.
Be a bit more consistent with variable names.
1999-07-27 00:30:32 +00:00
.Ar max
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
defaults to 10.
.Pp
Note, the
.Ar secs
delay will be effective, even after
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
.Ar attempts
has been exceeded, so an immediate manual dial may appear to have
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
done nothing.
If an immediate dial is required, a
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq !\&
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
should immediately follow the
.Dq open
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
keyword.
See the
Allow an optional ``!'' in the open, dial & call commands. When used, the redial timer is ignored and the modem is opened immediately.
1998-07-29 18:21:17 +00:00
.Dq open
description above for further details.
Add ``enable proxyall'' support. This adds proxy ARP entries for every machine on every class C or smaller subnet that we route to. Add ``set {send,recv}pipe'' for controlling our socket buffer sizes. Mention the IP number with the problem in a few error messages. All submitted by: Craig Leres <leres@ee.lbl.gov> Modified slightly by: me
1998-10-26 19:07:39 +00:00
.It set sendpipe Op Ar value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This sets the routing table SENDPIPE value.
The optimum value is just over twice the MTU value.
If
Add ``enable proxyall'' support. This adds proxy ARP entries for every machine on every class C or smaller subnet that we route to. Add ``set {send,recv}pipe'' for controlling our socket buffer sizes. Mention the IP number with the problem in a few error messages. All submitted by: Craig Leres <leres@ee.lbl.gov> Modified slightly by: me
1998-10-26 19:07:39 +00:00
.Ar value
is unspecified or zero, the default kernel controlled value is used.
Only remove socket files with ``set server open''. Only show the mask in ``show bundle'' when it's been specified. Complain about unexpected arguments after ``set server {none,open,closed}'' Log re-open failures as warnings rather than phase messages. Fix some markup for the ``set server'' man page description.
2001-01-29 01:35:06 +00:00
.It "set server|socket" Ar TcpPort Ns No \&| Ns Xo
.Ar LocalName Ns No |none|open|closed
.Op password Op Ar mask
.Xc
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
This command tells
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
.Nm
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
to listen on the given socket or
.Sq diagnostic port
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
for incoming command connections.
.Pp
The word
Only remove socket files with ``set server open''. Only show the mask in ``show bundle'' when it's been specified. Complain about unexpected arguments after ``set server {none,open,closed}'' Log re-open failures as warnings rather than phase messages. Fix some markup for the ``set server'' man page description.
2001-01-29 01:35:06 +00:00
.Dq none
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
instructs
.Nm
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
to close any existing socket and clear the socket configuration.
The word
Only remove socket files with ``set server open''. Only show the mask in ``show bundle'' when it's been specified. Complain about unexpected arguments after ``set server {none,open,closed}'' Log re-open failures as warnings rather than phase messages. Fix some markup for the ``set server'' man page description.
2001-01-29 01:35:06 +00:00
.Dq open
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
instructs
.Nm
to attempt to re-open the port.
The word
Only remove socket files with ``set server open''. Only show the mask in ``show bundle'' when it's been specified. Complain about unexpected arguments after ``set server {none,open,closed}'' Log re-open failures as warnings rather than phase messages. Fix some markup for the ``set server'' man page description.
2001-01-29 01:35:06 +00:00
.Dq closed
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
instructs
.Nm
to close the open port.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
If you wish to specify a local domain socket,
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
.Ar LocalName
must be specified as an absolute file name, otherwise it is assumed
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
to be the name or number of a TCP port.
Only remove socket files with ``set server open''. Only show the mask in ``show bundle'' when it's been specified. Complain about unexpected arguments after ``set server {none,open,closed}'' Log re-open failures as warnings rather than phase messages. Fix some markup for the ``set server'' man page description.
2001-01-29 01:35:06 +00:00
You may specify the octal umask to be used with a local domain socket.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Refer to
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
.Xr umask 2
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
for umask details.
Refer to
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
.Xr services 5
for details of how to translate TCP port names.
Add "set server" to control the server socket. Catch SIGUSR1 to re-init listening socket. Document signal behaviour. Add missing '\n's to LogPrintf(LogWARN,...) Main() returns int not void. AF_LOCAL ideal suggested a long time ago by: joerg
1997-06-25 19:30:05 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
You must also specify the password that must be entered by the client
(using the
.Dq passwd
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
variable above) when connecting to this socket.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
If the password is
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
specified as an empty string, no password is required for connecting clients.
.Pp
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
When specifying a local domain socket, the first
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq %d
sequence found in the socket name will be replaced with the current
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
interface unit number.
This is useful when you wish to use the same
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
profile for more than one connection.
.Pp
In a similar manner TCP sockets may be prefixed with the
.Dq +
character, in which case the current interface unit number is added to
the port number.
Refer a bit to pppctl. Suggested (far to subtly for his own good) by: joerg
1997-10-05 14:27:08 +00:00
.Pp
When using
.Nm
with a server socket, the
.Xr pppctl 8
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command is the preferred mechanism of communications.
Currently,
Refer a bit to pppctl. Suggested (far to subtly for his own good) by: joerg
1997-10-05 14:27:08 +00:00
.Xr telnet 1
can also be used, but link encryption may be implemented in the future, so
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
.Xr telnet 1
Allow ``set server closed'' to close the diagnostic socket. Allow ``set server open'' to re-open the diagnostic socket. Handle SIGUSR1 by re-opening the diagnostic socket When receiving SIGUSR2 (and in ``set server none''), don't forget the socket details so that ``set server open'' and SIGUSR1 open it again. Don't create the diagnostic socket as uid 0 ! It's far to dangerous.
2001-01-26 01:41:34 +00:00
should be avoided.
.Pp
Note;
.Dv SIGUSR1
and
.Dv SIGUSR2
interact with the diagnostic socket.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set speed Ar value
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This sets the speed of the serial device.
If speed is specified as
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
.Dq sync ,
.Nm
treats the device as a synchronous device.
.Pp
Certain device types will know whether they should be specified as
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
synchronous or asynchronous.
These devices will override incorrect
Allow ``host:port/udp'' devices and support ``host:port/tcp'' as being the same as the previous (still supported) ``host:port'' syntax for tcp socket devices. A udp device uses synchronous ppp rather than async, and avoids the double-retransmit overhead that comes with ppp over tcp (it's usually a bad idea to transport IP over a reliable transport that itself is using an unreliable transport). PPP over UDP provides througput of ** 1.5Mb per second ** with all compression disabled, maxing out a PPro/200 when running ppp twice, back-to-back. This proves that PPPoE is plausable in userland.... This change adds a few more handler functions to struct device and allows derivations of struct device (which may contain their own data etc) to pass themselves through the unix domain socket for MP. ** At last **, struct physical has lost all the tty crud ! iov2physical() is now smart enough to restore the correct stack of layers so that MP servers will work again. The version number has bumped as our MP link transfer contents have changed (they now may contain a `struct device'). Don't extract the protocol twice in MP mode (resulting in protocol rejects for every MP packet). This was broken with my original layering changes. Add ``Physical'' and ``Sync'' log levels for logging the relevent raw packets and add protocol-tracking LogDEBUG stuff in various LayerPush & LayerPull functions. Assign our physical device name for incoming tcp connections by calling getpeername(). Assign our physical device name for incoming udp connections from the address retrieved by the first recvfrom().
1999-05-12 09:49:12 +00:00
settings and log a warning to this effect.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set stopped Op Ar LCPseconds Op Ar CCPseconds
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
If this option is set,
.Nm
will time out after the given FSM (Finite State Machine) has been in
the stopped state for the given number of
.Dq seconds .
This option may be useful if the peer sends a terminate request,
but never actually closes the connection despite our sending a terminate
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
acknowledgement.
This is also useful if you wish to
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set openmode passive
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
and time out if the peer does not send a Configure Request within the
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
given time.
Use
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Dq set log +lcp +ccp
to make
.Nm
log the appropriate state transitions.
.Pp
The default value is zero, where
.Nm
Expand *n't contractions.
2005-02-13 22:25:33 +00:00
does not time out in the stopped state.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pp
This value should not be set to less than the openmode delay (see
.Dq set openmode
above).
Implement a minimum idle time value as an optional second argument to ``set timeout''. This is useful for situations where your minimum call charge is (say) 5 minutes (like mine is)
1999-08-17 17:22:46 +00:00
.It set timeout Ar idleseconds Op Ar mintimeout
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
This command allows the setting of the idle timer.
Refer to the section titled
Use ``Sx'' when xref'ing sections.
1999-03-18 21:53:56 +00:00
.Sx SETTING THE IDLE TIMER
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
for further details.
Implement a minimum idle time value as an optional second argument to ``set timeout''. This is useful for situations where your minimum call charge is (say) 5 minutes (like mine is)
1999-08-17 17:22:46 +00:00
.Pp
If
.Ar mintimeout
is specified,
.Nm
will never idle out before the link has been up for at least that number
of seconds.
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
.It set urgent Xo
Allow ``set urgent none'' to disable all urgent ports and IPTOS_LOWDELAY prioritisation. Requested by: luigi
2000-06-08 20:07:48 +00:00
.Op tcp|udp|none
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
.Oo Op +|- Ns
.Ar port
.Oc No ...
.Xc
This command controls the ports that
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
prioritizes when transmitting data.
The default priority TCP ports
Introduce a forth IP packet queue. Urgent packets with ip_tos == IPTOS_LOWDELAY now get precidence over urgent packets with ip_tos != IPTOS_LOWDELAY and non-urgent packets with ip_tos == IPTOS_LOWDELAY. Enhance the ``set urgent'' syntax to allow for urgent UDP packets as well as urgent TCP packets.
1999-09-07 07:51:11 +00:00
are ports 21 (ftp control), 22 (ssh), 23 (telnet), 513 (login), 514 (shell),
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
543 (klogin) and 544 (kshell).
There are no priority UDP ports by default.
Introduce a forth IP packet queue. Urgent packets with ip_tos == IPTOS_LOWDELAY now get precidence over urgent packets with ip_tos != IPTOS_LOWDELAY and non-urgent packets with ip_tos == IPTOS_LOWDELAY. Enhance the ``set urgent'' syntax to allow for urgent UDP packets as well as urgent TCP packets.
1999-09-07 07:51:11 +00:00
See
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
.Xr services 5
for details.
.Pp
Introduce a forth IP packet queue. Urgent packets with ip_tos == IPTOS_LOWDELAY now get precidence over urgent packets with ip_tos != IPTOS_LOWDELAY and non-urgent packets with ip_tos == IPTOS_LOWDELAY. Enhance the ``set urgent'' syntax to allow for urgent UDP packets as well as urgent TCP packets.
1999-09-07 07:51:11 +00:00
If neither
.Dq tcp
or
.Dq udp
are specified,
.Dq tcp
is assumed.
.Pp
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
If no
.Ar port Ns No s
Introduce a forth IP packet queue. Urgent packets with ip_tos == IPTOS_LOWDELAY now get precidence over urgent packets with ip_tos != IPTOS_LOWDELAY and non-urgent packets with ip_tos == IPTOS_LOWDELAY. Enhance the ``set urgent'' syntax to allow for urgent UDP packets as well as urgent TCP packets.
1999-09-07 07:51:11 +00:00
are given, the priority port lists are cleared (although if
.Dq tcp
or
.Dq udp
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is specified, only that list is cleared).
If the first
o Split the two IPCP queues into three - one for FSM data (LCP/CCP/IPCP), one for urgent IP traffic and one for everything else. o Add the ``set urgent'' command for adjusting the list of urgent port numbers. The default urgent ports are 21, 22, 23, 513, 514, 543 and 544 (Ports 80 and 81 have been removed from the default priority list). o Increase the buffered packet threshold from 20 to 30. o Report the number of packets in the IP output queue and the list of urgent ports under ``show ipcp''.
1999-09-04 00:00:21 +00:00
.Ar port
argument is prefixed with a plus
.Pq Dq \&+
or a minus
.Pq Dq \&- ,
the current list is adjusted, otherwise the list is reassigned.
.Ar port Ns No s
prefixed with a plus or not prefixed at all are added to the list and
.Ar port Ns No s
prefixed with a minus are removed from the list.
Allow ``set urgent none'' to disable all urgent ports and IPTOS_LOWDELAY prioritisation. Requested by: luigi
2000-06-08 20:07:48 +00:00
.Pp
If
.Dq none
is specified, all priority port lists are disabled and even
.Dv IPTOS_LOWDELAY
packets are not prioritised.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It set vj slotcomp on|off
This command tells
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
whether it should attempt to negotiate VJ slot compression.
By default, slot compression is turned
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar on .
.It set vj slots Ar nslots
This command sets the initial number of slots that
Allow "set vj" for changing the default number of slots and whether slot compression is requested. Don't show current values with "show ipcp" if IPCP isn't "opened".
1998-01-18 20:49:22 +00:00
.Nm
will try to negotiate with the peer when VJ compression is enabled (see the
.Sq enable
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
command above).
It defaults to a value of 16.
Allow "set vj" for changing the default number of slots and whether slot compression is requested. Don't show current values with "show ipcp" if IPCP isn't "opened".
1998-01-18 20:49:22 +00:00
.Ar Nslots
must be between
.Ar 4
and
.Ar 16
inclusive.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It shell|! Op Ar command
Introduce the "bg" command. It's pretty much the same as "shell", but it's in the background.
1997-08-18 20:15:10 +00:00
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar command
Introduce the "bg" command. It's pretty much the same as "shell", but it's in the background.
1997-08-18 20:15:10 +00:00
is not specified a shell is invoked according to the
.Dv SHELL
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
environment variable.
Otherwise, the given
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar command
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
is executed.
Word replacement is done in the same way as for the
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.Dq !bg
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
command as described above.
Add the following word substitutions when running a shell command: AUTHNAME: The local authname ENDDISC: The local endpoint discriminator LABEL: The configuration label in use PEER_ENDDISC: The peers endpoint discriminator USER: The peers authname
1998-08-29 23:02:42 +00:00
.Pp
Mechanically kill hard sentence breaks.
2004-07-02 23:13:00 +00:00
Use of the !\& character
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
requires a following space as with any of the other commands.
You should note that this command is executed in the foreground;
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Nm
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
will not continue running until this process has exited.
Use the
Introduce the "bg" command. It's pretty much the same as "shell", but it's in the background.
1997-08-18 20:15:10 +00:00
.Dv bg
command if you wish processing to happen in the background.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It show Ar var
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
This command allows the user to examine the following:
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It show bundle
Show the current bundle settings.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show ccp
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Show the current CCP compression statistics.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show compress
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Show the current VJ compression statistics.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show escape
Show the current escape characters.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It show filter Op Ar name
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
List the current rules for the given filter.
If
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Ar name
is not specified, all filters are shown.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show hdlc
Show the current HDLC statistics.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It show help|?
Give a summary of available show commands.
Solve the ``first connection'' problem that occurs on demand-dial links with dynamic IP numbers where the program that causes the dial bind()s to an interface address that is subsequently changed after ppp negotiation. The problem is defeated by adding negotiated addresses to the tun interface as additional alias addresses and providing a set of ``iface'' commands for managing the interface. Libalias is also required (and what a name clash!) - it happily IP-aliases the address so that the source is that of the primary (negotiated) interface and un-IP-aliases it on the way back. An ``enable iface-alias'' is done implicitly by the -alias command line switch. If -alias isn't given, iface-aliasing is disabled by default and can't be enabled 'till an ``alias enable yes'' is done. ``alias enable no'' silently disables iface-alias. So, for dynamic-IP-type-connections, running ``ppp -alias -auto blah'' will work for the first connection, although existing bindings will not survive a disconnect/connect as the TCP peer will be trying to send to the old IP address - the packets won't route. It's now a lot easier to add IPXCP to ppp with minor updates to the new iface.[ch] (if anyone ever gets 'round to it). It's also now possible to manually add interface aliases with something like ``iface add 1.2.3.4/24 5.6.7.8''. This allows multi-homed ppp links :-)
1998-10-22 02:32:50 +00:00
.It show iface
Show the current interface information
mdoc(7) police: Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text. Not only this slows down the mdoc(7) processing significantly, but it also has an undesired (in this case) effect of disabling hyphenation within the entire enclosed block.
2001-08-07 15:48:51 +00:00
(the same as
.Dq iface show ) .
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show ipcp
Show the current IPCP statistics.
Mention ``show layers''
1999-05-16 13:39:03 +00:00
.It show layers
Show the protocol layers currently in use.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show lcp
Show the current LCP statistics.
mdoc fixes.
2012-09-08 08:46:43 +00:00
.It show Oo data Oc Ns Xo
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.No link
.Xc
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Show high level link information.
.It show links
Show a list of available logical links.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show log
Show the current log values.
.It show mem
Show current memory statistics.
o Add ipv6 support, abstracting most NCP addresses into opaque structures (well, they're treated as opaque). It's now possible to manage IPv6 interface addresses and routing table entries and to filter IPV6 traffic whether encapsulated or not. IPV6CP support is crude for now, and hasn't been tested against any other implementations. RADIUS and IPv6 are independent of eachother for now. ppp.linkup/ppp.linkdown aren't currently used by IPV6CP o Understand all protocols(5) in filter rules rather than only a select few. o Allow a mask specification for the ``delete'' command. It's now possible to specifically delete one of two conflicting routes. o When creating and deleting proxy arp entries, do it for all IPv4 interface addresses rather than doing it just for the ``current'' peer address. o When iface-alias isn't in effect, don't blow away manually (via ``iface add'') added interface addresses. o When listening on a tcp server (diagnostic) socket, bind so that a tcp46 socket is created -- allowing both IPv4 and IPv6 connections. o When displaying ICMP traffic, don't display the icmp type twice. When display traffic, display at least some information about unrecognised traffic. o Bump version Inspired after filtering work by: Makoto MATSUSHITA <matusita@jp.FreeBSD.org>
2001-08-14 16:05:52 +00:00
.It show ncp
Show the current NCP statistics.
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
.It show physical
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Show low level link information.
Mention ``show mp''. Describe ACFComp correctly.
1999-05-02 08:52:50 +00:00
.It show mp
Show Multi-link information.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show proto
Show current protocol totals.
.It show route
Show the current routing tables.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It show stopped
Show the current stopped timeouts.
.It show timer
Show the active alarm timers.
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It show version
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Show the current version number of
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.El
Cosmetic: Remove blank lines, add .Pp where necessary. Submitted by: Theo de Raadt <deraadt@cvs.openbsd.org>
1997-12-21 01:07:13 +00:00
.Pp
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.It term
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Go into terminal mode.
Characters typed at the keyboard are sent to the device.
Characters read from the device are displayed on the screen.
When a remote
o Redesign the layering mechanism and make the aliasing code part of the layering. We now ``stack'' layers as soon as we open the device (when we figure out what we're dealing with). A static set of `dispatch' routines are also declared for dealing with incoming packets after they've been `pulled' up through the stacked layers. Physical devices are now assigned handlers based on the device type when they're opened. For the moment there are three device types; ttys, execs and tcps. o Increment version number to 2.2 o Make an entry in [uw]tmp for non-tty -direct invocations (after pap/chap authentication). o Make throughput counters quad_t's o Account for the absolute number of mbuf malloc()s and free()s in ``show mem''. o ``show modem'' becomes ``show physical''.
1999-05-08 11:07:56 +00:00
.Em PPP
peer is detected,
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Nm
automatically enables Packet Mode and goes back into command mode.
.El
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh MORE DETAILS
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Bl -bullet
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Read the example configuration files.
They are a good source of information.
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.It
Use
.Dq help ,
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq nat \&? ,
.Dq enable \&? ,
.Dq set ?\&
1) Add multi-phone dialing/redialing, several phones separated by ':' 2) Improve on-line help subsystem 3) Make 'term' mode works even carrier dropped (old code close line forever here) 4) Make 'term' mode 8bit clean. 5) Improve manual page 6) #ifdef DEBUG diagnostic about missing optional files. 7) Don't put interactive dialing info to logfile
1996-03-08 09:03:09 +00:00
and
Prepare for mdoc(7)NG.
2000-12-27 15:30:30 +00:00
.Dq show ?\&
Expand contractions.
2005-02-13 23:45:54 +00:00
to get online information about what is available.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It
Fix a load of typos Use sizeof, not a hardcode value. Some of it submitted by: Peter Jeremy <jeremyp@gsmx07.alcatel.com.au>
1999-07-28 03:01:52 +00:00
The following URLs contain useful information:
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Bl -bullet -compact
.It
Correct the FAQ url Submitted by: Olivier Tharan <olive@oban.frmug.org>
2002-08-26 20:48:07 +00:00
http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/ppp.html
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It
Correct links to Handbook's pages, old URLs does not work anymore. MFC after: 1 week
2002-07-30 21:04:26 +00:00
http://www.FreeBSD.org/doc/handbook/userppp.html
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.El
.Pp
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
.Sh FILES
Describe manual dialing in greater detail. Mention more rfc numbers. Don't ``.Nm Ppp'' (just use ``.Nm'').
1999-02-14 12:16:41 +00:00
.Nm
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
refers to four files:
.Pa ppp.conf ,
.Pa ppp.linkup ,
.Pa ppp.linkdown
and
.Pa ppp.secret .
These files are placed in the
.Pa /etc/ppp
Remove the use of $HOME/.ppp.*
1997-11-09 13:18:51 +00:00
directory.
Avoid use of direct troff requests in mdoc(7) manual pages.
2000-11-10 17:46:15 +00:00
.Bl -tag -width 2n
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /etc/ppp/ppp.conf
1995-01-31 06:29:58 +00:00
System default configuration file.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /etc/ppp/ppp.secret
An authorisation file for each system.
.It Pa /etc/ppp/ppp.linkup
Do my best to translate this into english.. :-) Some parts were so incomprehensible that I had to excise them entirely, but I did my best with the material provided.
1995-05-21 17:32:35 +00:00
A file to check when
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Nm
Do my best to translate this into english.. :-) Some parts were so incomprehensible that I had to excise them entirely, but I did my best with the material provided.
1995-05-21 17:32:35 +00:00
establishes a network level connection.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /etc/ppp/ppp.linkdown
Add ppp.linkdown file to compliment ppp.linkup. Submitted by: Forgotten Passed on by: Terry Dwyer 61 8 9491 5161 <tdwyer@io.telstra.com.au> Also remove extraneous setuid(0) - it's only undone by the subsequent call to SelectSystem().
1997-06-13 02:07:32 +00:00
A file to check when
.Nm
closes a network level connection.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /var/log/ppp.log
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
Logging and debugging information file.
Note, this name is specified in
Spell syslog.conf correctly Submitted by: Tony Finch <dot@dotat.at> PR: 30545
2001-09-13 09:06:51 +00:00
.Pa /etc/syslog.conf .
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
See
.Xr syslog.conf 5
for further details.
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
.It Pa /var/spool/lock/LCK..*
tty port locking file.
Refer to
uucplock is in section 3 not section 8 !
1997-11-14 20:07:39 +00:00
.Xr uucplock 3
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
for further details.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /var/run/tunN.pid
The process id (pid) of the
.Nm
program connected to the tunN device, where
.Sq N
/var/run/tunX.pid is created regardless of ppps mode. Spotted by: Alex <garbanzo@hooked.net>
1998-08-09 17:17:10 +00:00
is the number of the device.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /var/run/ttyXX.if
Hard sentence breaks and trailing space tidy-ups Obtained from: OpenBSD
2000-06-11 14:58:32 +00:00
The tun interface used by this port.
Again, this file is only created in
Make the man page a little more detailed. Update the version number to 1.00. Increase the predictor-1 buffer by 2 bytes.
1997-06-09 23:38:38 +00:00
.Fl background ,
.Fl auto
and
.Fl ddial
modes.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.It Pa /etc/services
1. All fragments (except the first one) of a fragmented packet were dropped - devet@adv.IAEhv.nl (Arjan de Vet) 2. Will not read data from telnet connection - John Capo <jc@irbs.com> 3. Using LQM option could be drop the link due to LcpLayerDown() doesn't stop LQR timer. - Brian <brian@awfulhak.demon.co.uk> 4. Allow to describe a syntax of filters that is not only port number but also by name in /etc/service. - Rich Murphey <rich@lamprey.utmb.edu> Reviewed by: Atsushi Murai <amurai@spec.co.jp> Submitted by: devet@adv.IAEhv.nl, jc@irbs.com, brian@awfulhak.demon.co.uk, rich@lamprey.utmb.edu
1995-09-17 16:14:49 +00:00
Get port number if port number is using service name.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.It Pa /var/run/ppp-authname-class-value
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
In multi-link mode, local domain sockets are created using the peer
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
authentication name
.Pq Sq authname ,
the peer endpoint discriminator class
.Pq Sq class
and the peer endpoint discriminator value
.Pq Sq value .
As the endpoint discriminator value may be a binary value, it is turned
to HEX to determine the actual file name.
.Pp
This socket is used to pass links between different instances of
mdoc(7) police: use the new features of the Nm macro.
2000-11-20 20:10:44 +00:00
.Nm .
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.El
Xref chat(8) and pppd(8). Also change .It references to .Pa for file name references in the file section.
1996-05-02 19:18:47 +00:00
.Sh SEE ALSO
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr at 1 ,
.Xr ftp 1 ,
Abstract the CCP layer a level. Add DEFLATE support.
1997-12-03 10:23:54 +00:00
.Xr gzip 1 ,
Don't create a diagnostic socket by default. Allow a password spec on the "set server" command line. Use SIGUSR2 to close the diagnostic socket. Some man page corrections.
1997-11-09 22:07:29 +00:00
.Xr hostname 1 ,
Revert SEE ALSO ordering to version 1.124 Patched correctly by: wosch Blunder pointed out by: bde
1998-09-18 23:28:10 +00:00
.Xr login 1 ,
.Xr tcpdump 1 ,
.Xr telnet 1 ,
Mention that pppoe requires netgraph(4) and without it, an external pppoe program must be used (such as pppoe(8) on OpenBSD).
2000-08-10 13:26:01 +00:00
.Xr kldload 2 ,
Document that ppp handles pipe(2) descriptors specially in -direct mode. MFC after: 3 days
2009-08-25 07:52:09 +00:00
.Xr pipe 2 ,
.Xr socketpair 2 ,
Move ppp.8.m4 back to ppp.8 and de-ifdef it. Requested by: joel MFC after: 1 week
2013-06-02 23:56:38 +00:00
.Xr libalias 3 ,
.Xr libradius 3 ,
Revert SEE ALSO ordering to version 1.124 Patched correctly by: wosch Blunder pointed out by: bde
1998-09-18 23:28:10 +00:00
.Xr syslog 3 ,
.Xr uucplock 3 ,
Support PPPoE Help (lots) from: julian, archie Facilities from: ahebert@pubnix.net
1999-11-06 22:50:59 +00:00
.Xr netgraph 4 ,
mdoc(7) police: removed hard sentence breaks, sorted xrefs.
2001-07-05 11:01:12 +00:00
.Xr ng_pppoe 4 ,
Revert SEE ALSO ordering to version 1.124 Patched correctly by: wosch Blunder pointed out by: bde
1998-09-18 23:28:10 +00:00
.Xr crontab 5 ,
.Xr group 5 ,
.Xr passwd 5 ,
Add a ``nat proto'' command -- similar to natd(8)'s -redirect_proto switch. MFC after: 3 weeks
2001-07-09 00:07:56 +00:00
.Xr protocols 5 ,
Support proxying & transparent proxying curtesy of libalias(3). Order the alias command descriptions. Order the SEE ALSO entries.
1999-03-07 15:02:38 +00:00
.Xr radius.conf 5 ,
Revert SEE ALSO ordering to version 1.124 Patched correctly by: wosch Blunder pointed out by: bde
1998-09-18 23:28:10 +00:00
.Xr resolv.conf 5 ,
.Xr syslog.conf 5 ,
.Xr adduser 8 ,
.Xr chat 8 ,
.Xr getty 8 ,
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr inetd 8 ,
.Xr init 8 ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Xr named 8 ,
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr ping 8 ,
.Xr pppctl 8 ,
Xref the proper manual pages. PR: 60999 Submitted by: Marc Silver <marcs@draenor.org>
2004-01-12 16:10:38 +00:00
.Xr pppoed 8 ,
Allow "add! dst mask gw" (note the ``!'') to do an RTM_CHANGE if the RTM_ADD fails with an EEXIST. Allow "delete! dst" (note the ``!'') to silently fail if the RTM_DELETE fails with an ESRCH. Also, make the ESRCH and EEXIST error conditions more understandable to the casual observer.
1997-12-30 02:45:48 +00:00
.Xr route 8 ,
Introduce the ``keep-session'' option. Refer to the man page for details. This allows MP over non-tty devices where the original ppp process must not exit (such as sshd-spawned ppp sessions).
1999-06-02 00:46:55 +00:00
.Xr sshd 8 ,
Add a pppctl(8) xref. Suggested by: joerg
1997-09-21 13:06:43 +00:00
.Xr syslogd 8 ,
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Xr traceroute 8 ,
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Xr vipw 8
Completely re-wrote the man-page using -mandoc macros. More cleanups in sentence structure to include more articles, plus fix some mis-spellings and typos. Reviewed by: gpalmer (Gary Paler)
1995-09-24 18:15:14 +00:00
.Sh HISTORY
Fix some mdoc(7) style inconsistences Submitted by: Alexey M. Zelkin" <phantom@cris.net>
1999-08-25 21:39:40 +00:00
This program was originally written by
.An Toshiharu OHNO Aq tony-o@iij.ad.jp ,
and was submitted to
.Fx 2.0.5
by
.An Atsushi Murai Aq amurai@spec.co.jp .
.Pp
It was substantially modified during 1997 by
.An Brian Somers Aq brian@Awfulhak.org ,
and was ported to
.Ox
in November that year
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
(just after the 2.2 release).
.Pp
Fix some mdoc(7) style inconsistences Submitted by: Alexey M. Zelkin" <phantom@cris.net>
1999-08-25 21:39:40 +00:00
Most of the code was rewritten by
.An Brian Somers
in early 1998 when multi-link ppp support was added.
Reference in New Issue Copy Permalink