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

4783 lines
124 KiB
Groff
Raw Normal View History

$Id$ -> $FreeBSD$
1999-08-28 01:35:59 +00:00
.\" $FreeBSD$
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
.Dd 20 September 1995
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
.nr XX \w'\fC00'
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
.Os FreeBSD
.Dt PPP 8
.Sh NAME
.Nm 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
.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
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
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Op Fl Va mode
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.Op Ar system Ns
.No ...
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
software package. Normally,
.Em PPP
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
is implemented as a part of the kernel (e.g. as managed by
.Xr pppd 8 )
and it's thus somewhat hard to debug and/or modify its behaviour.
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
flag (or
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Fl alias
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
flag for backwards compatability) does the equivalent of a
.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
.Nm ppp 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
network address translation features. This allows
Reorganise ppp's usage to avoid some mandoc limitations. Suggested by: wollman
1999-08-03 16:14:38 +00:00
.Nm ppp
to act as a NAT or masquerading engine for all machines on an internal
LAN. Refer to
.Xr libalias 3
for details.
.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
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
.Nm ppp :
.Bl -tag -width XXX -offset XXX
.It Fl auto
.Nm
opens the tun interface, configures it then goes into the background.
The link isn't brought up until outgoing data is detected on the tun
interface at which point
.Nm
attempts to bring up the link. Packets received (including the first one)
while
.Nm
is trying to bring the link up will remain queued for a default of
2 minutes. See the
.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
use when configuring the interface. Something like
.Dq 10.0.0.1/0
is usually appropriate. See the
.Dq pmdemand
system in
.Pa /usr/share/examples/ppp/ppp.conf.sample
for an example.
.It Fl background
Here,
.Nm
attempts to establish a connection with the peer immediately. If it
succeeds,
.Nm
goes into the background and the parent process returns an exit code
of 0. If it fails,
.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
becomes a daemon. The link is created in background mode. This is useful
if you wish to control
.Nm ppp Ns No s
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
This is used for receiving incoming connections.
.Nm
ignores the
.Dq set device
line and uses descriptor 0 as the link.
.Pp
If callback is configured,
.Nm
will use the
.Dq set device
information when dialing back.
.It Fl dedicated
This option is designed for machines connected with a dedicated
wire.
.Nm
will always keep the device open and will never use any configured
chat scripts.
.It Fl ddial
This mode is equivalent to
.Fl auto
mode except that
.Nm
will bring the link back up any time it's dropped for any reason.
.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
.Pq as specified in Pa /etc/ppp/ppp.conf
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
A few more typos fixed and some general cleanup done.
1995-05-24 05:51:29 +00:00
the status of connection and close the connection. All functions can
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
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
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
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
detects it and switches to packet mode automatically. Once you have
determined the proper sequence for connecting with the remote host, you
can write a chat script to define the necessary dialing and login
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
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
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
connection. However, it differs in that it will dial the remote site
any time it detects the link is down, even if there are no packets to be
sent. This mode is useful for full-time connections where we worry less
about line charges and more about being connected full time.
A third
.Fl dedicated
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
command via its diagnostic socket. A
.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).
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
.It Supports packet aliasing.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Packet aliasing (a.k.a. IP masquerading) allows computers on a
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
host acts as a masquerading gateway. IP addresses as well as TCP and
UDP port numbers are aliased for outgoing packets and de-aliased for
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.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
Otherwise, it will exit with an error. This allows the setup of
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.
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 PAP and CHAP (rfc 1994) 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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
protocol for authentication instead. If the peer requests Microsoft
CHAP authentication and
.Nm
is compiled with DES support, an appropriate MD4/DES response will be
made.
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 RADIUS (rfc 2138) 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
characteristics. If
.Pa libradius
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
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.
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
User can define four kinds of filters: the
.Em in
filter for incoming packets, the
.Em out
filter for outgoing packets, the
.Em dial
filter to define a dialing trigger packet and the
.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
.Op / Ns Em tcp Ns No | Ns Em 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
.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
conventional serial device. UDP connections force
.Nm
into synchronous mode.
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
.It Supports PPP over ISDN
If
.Nm
is given a raw B-channel i4b device to open as a link, it's able to talk
to the
.Xr isdnd 8
daemon to establish an ISDN connection.
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.
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
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
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 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
stack (ie. 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 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 .
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 default,
.Nm
will not run if the invoking user id is not zero. This may be overridden
by using the
.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
system lock files and read the ppp configuration files. All
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
external commands (executed via the "shell" or "!bg" commands) are executed
as the user id that invoked
.Nm ppp .
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
logging facility if you're interested in what exactly is done as user id
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
Your kernel must include a tunnel device (the GENERIC kernel includes
Cosmetic: Remove unused variables and build on OpenBSD.
1997-09-10 02:20:35 +00:00
one by default). If it doesn't, or if you require more than one tun
interface, you'll need to rebuild your kernel with the following line in
your kernel configuration 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
.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 pseudo-device tun N
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
where
.Ar N
is the maximum number of
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
connections you wish to support.
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
Check your
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 /dev
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
directory for the tunnel device entries
.Pa /dev/tunN ,
where
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
.Sq N
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
represents the number of the tun device, starting at zero.
If they don't exist, you can create them by running "sh ./MAKEDEV tunN".
This will create tun devices 0 through
.Ar N .
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
Make sure that your system has a group named
.Dq network
in the
.Pa /etc/group
file and that that group contains the names of all users expected to use
.Nm ppp .
Refer to the
.Xr group 5
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
manual page for details. Each of these users must also be given access
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
using the
.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
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
uses
.Xr syslog 3
to log information. A common log file name is
.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 .
Don't forget to send a
.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
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 ppp Ns No s
operation, you should configure your resolver so that it works correctly.
This can be done by configuring a local DNS
.Pq using Xr named 8
or by adding the correct
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
.Sq name-server
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
automatically. Refer to the
.Dq enable dns
command 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
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
.Dq passwd
command. This only ever happens if you connect to a running version of
.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
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
ppp ON awfulhak> set device /dev/cuaa0
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
Normally, hardware flow control (CTS/RTS) is used. However, under
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
come. Thus, if you have a direct line and can't seem to make a
connection, try turning CTS/RTS off with
.Dq set ctsrts off .
If you need to do this, check the
.Dq set accmap
description below too - you'll probably need to
.Dq set accmap 000a0000 .
.Pp
Usually, parity is set to
.Dq none ,
and this is
.Nm ppp Ns No s
default. Parity is a rather archaic error checking mechanism that is no
longer used because modern modems do their own error checking, and most
link-layer protocols (that's what
.Nm
is) use much more reliable checking mechanisms. Parity has a relatively
huge overhead (a 12.5% increase in traffic) and as a result, it is always
disabled
.Pq set to Dq none
when
.Dv PPP
is opened. However, some ISPs (Internet Service Providers) may use
specific parity settings at connection time (before
.Dv PPP
is opened). Notably, Compuserve insist
on even parity when logging in:
.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:
Device List: /dev/cuaa0
Characteristics: 38400bps, cs8, even parity, CTS/RTS on
Connect time: 0 secs
0 octets in, 0 octets out
Overall 0 bytes/sec
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
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
If it does not, it's probable that the peer is waiting for your end to
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
login/password authentication. To set things up properly, drop back to
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
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
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
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
a peer connection. If only some of the three Ps go uppercase, wait until
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
either everything is uppercase or lowercase. If they revert to lowercase,
it means that
.Nm
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
couldn't successfully negotiate with the peer. A good first step
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 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
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
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 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
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 *
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
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
At this point, your machine has a host route to the peer. This means
that you can only make a connection with the host on the other side
of the link. If you want to add a default route entry (telling your
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
route using
.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
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
You can now use your network applications (ping, telnet, ftp 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
in other windows or terminals on your machine. If you wish to reuse
the current terminal, you can put
.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 #
Mention that leading whitespace is ignored when identifying comments.
1997-12-21 02:34:27 +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
.Sq !include .
It must have one argument - the file to include. You may wish to
.Dq !include ~/.ppp.conf
for compatibility with older versions of
.Nm 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
.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.
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
section. This section is always executed. It should also contain
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
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 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
Commands associated with the
.Dq default
label are executed, followed by those associated with the destination
label provided. When
.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
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
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
after a section is loaded, whether it's the result of passing a label on
the command line or using the
.Dq load
command. Only the commands specified for that label in the configuration
file are executed. However, when invoking
.Nm
with the
.Fl background ,
.Fl ddial ,
or
.Fl dedicated
switches, the link mode tells
.Nm
to establish a connection. Refer to the
.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
has entered the authentication phase. The PPp prompt indicates that
.Nm
has entered the network phase. The PPP prompt indicates that
.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
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
connection is established. See the provided
.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
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
commands below for a description of possible substitution strings). Similarly,
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
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
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
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
.Nm ppp ,
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
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 supports
.Sq sticky routes ,
where all routes that contain the
.Dv HISADDR
or
.Dv MYADDR
literals will automatically be updated when the values of
.Dv HISADDR
and/or
.Dv MYADDR
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
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
attempts to establish the connection immediately. If multiple phone
numbers are specified, each phone number will be tried once. If the
attempt fails,
.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
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
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
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 use. It must contain the
.Dq set ifaddr
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
command to define the remote peers IP address. (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 ,
.Pq for example, Dq set server +3000 mypasswd
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
itself. If the diagnostic socket is closed or changed to a different
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
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
with the peer. In
.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
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.No set redial Ar secs Ns Xo
.Oo + Ns Ar inc Ns
.Op - Ns Ar max Ns
.Oc Op . Ns Ar next
.Op Ar attempts
.Xc
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
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
to connect again. If the argument is the literal string
.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
should be incremented each time a new dial attempt is made. The timeout
reverts to
.Ar secs
only after a successful connection is established. The default value for
.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
Extend the ``set redial'' command to allow incremental redial timeouts.
1999-03-04 17:42:15 +00:00
command). The default is 3 seconds. Again, if the argument is the literal
string
.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
that triggers a dial. The previous value is unchanged if this parameter
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
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
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
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
delay after all numbers have been tried. If multiple phone numbers
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,
.Pp
.Bd -literal -offset indent
set redial 10+10-5.3 20
.Ed
.Pp
tells
.Nm
to attempt to connect 20 times. After the first attempt,
.Nm
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
.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
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
may be lost at inappropriate times. It is possible to have
.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
seconds before each try. For example,
.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
seconds before attempting to reconnect. This may happen up to
.Ar 5
times before
.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
gives up. The default value of ntries is zero (no reconnect). Care
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
should be taken with this option. If the local timeout is slightly
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.
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
NOTE: In this context, losing too many LQRs constitutes a loss of
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
a connection is made. The next number redial period specified with
the
.Dq set 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
command is honoured, as is the reconnect tries value. If your redial
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
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
.Dl ttyd1 "/usr/libexec/getty std.38400" 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
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
Don't forget to send a
.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
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
Refer a bit to pppctl. Suggested (far to subtly for his own good) by: joerg
1997-10-05 14:27:08 +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
.Nm 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
.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
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
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 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 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
.Nm ppp
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
.Pq or both
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
that either PAP or CHAP are enabled as above. If they are not, you are
allowing anybody to establish ppp session with your machine
.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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +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 ,
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
.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
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
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +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
when authenticating. If the client does not offer a suitable
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
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
.Pq if specified
is used when negotiating IP numbers. See the
.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 ,
the client will be called back on the given number. If CBCP is being used,
.Ar callback-number
may also contain a list of numbers or a
.Dq \&* ,
as if passed to the
.Dq set cbcp
command. The value will be used in
.Nm ppp Ns No s
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
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
socket. It should be noted however that
.Nm
doesn't use the telnet protocol and will be unable to negotiate
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
with a telnet server. You should set up a port for receiving this
.Em PPP
connection on the receiving machine (ui-gate). This is
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
done by first updating
.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
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
Don't forget to send a
.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
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
after you've updated
.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
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 10.0.1.0/24 10.0.4.2
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +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
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
You may also want to enable PAP or CHAP for security. To enable PAP, add
the following line:
.Bd -literal -offset indent
enable PAP
.Ed
.Pp
You'll also need to create the following entry in
.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
.Pq Dq * ,
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
set log Phase Chat Connect hdlc LCP IPCP 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
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 10.0.2.0/24 10.0.4.1
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
.Ed
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
.Pp
Again, if you're enabling PAP, you'll also need:
.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
Document ppp over tcp (how to tunnel)
1997-06-13 00:04:58 +00:00
We're assigning the address of 10.0.4.1 to ui-gate, and the address
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
link - probably TCP again. If packets are lost, both levels will
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
from "tcp" to "udp". When using UDP as a transport,
.Nm
will operate in synchronous mode. This is another gain as the incoming
data does not have to be rearranged into packets.
.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
.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
.Pq \&or Fl alias
command line option enables network address translation (a.k.a. packet
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
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 local area network. Outgoing IP packets are aliased so that
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
they appear to come from the
.Nm
host, and incoming packets are de-aliased so that they are routed
to the correct machine on the local area network.
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
Packet aliasing allows computers on private, unregistered
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
subnets to have Internet access, although they are invisible
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
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.
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +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
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
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
Correct filter docs. PR: 3464 Submitted by: Stephen J. Roznowski <sjr1@flash.net>
1997-06-16 13:52:10 +00:00
This implementation supports packet filtering. There are four kinds 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
filters; the
.Em in
filter, the
.Em out
filter, the
.Em dial
filter and the
.Em alive
filter. Here are the basics:
.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
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 \&!
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
.Oo Ar proto Op src Ar cmp port
.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
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.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
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
specifying the rule number. Rules are specified in numeric order according to
.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
rule number greater than the current rule. In this case, if a given
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
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
.Pq Dq ! ,
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
are the source and destination IP number specifications. If
.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
.Dv MYADDR
or
.Dv HISADDR
(refer to the description of the
.Dq bg
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
.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
must be one of
.Sq icmp ,
Support `igmp' filters. Mostly submitted by: Timo Geusch <freebsd@sleepycat.ukpeople.net>
1999-06-23 16:48:24 +00:00
.Sq igmp ,
Mention that ospf is a possible filter protocol.
1999-08-02 21:45:36 +00:00
.Sq ospf ,
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 udp
or
.Sq tcp .
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.
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,
ie. the default is to allow everything through.
.It
If no rule is matched to a packet, that packet will be discarded
(blocked).
.It
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
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 timeout period is measured in seconds, the default value for which
is 180 seconds
.Pq 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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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
program itself remains running. Another trigger packet will cause it 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
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
.Pq or requests them .
The deflate protocol is preferred by
.Nm ppp .
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
.Pq assuming that the peer supports both algorithms .
.Pp
By default, when negotiating DEFLATE,
.Nm
will use a window size of 15. Refer to the
.Dq set deflate
command if you wish to change this behaviour.
.Pp
A special algorithm called DEFLATE24 is also available, and is disabled
and denied by default. This is exactly the same as DEFLATE except that
it uses CCP ID 24 to negotiate. This allows
.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
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
uses IPCP to negotiate IP addresses. Each side of the connection
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
specifies the IP address that it's 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
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
returns ACK to the requester. 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
returns NAK to suggest that the peer use a different IP address. When
both sides of the connection agree to accept the received request (and
send ACK), IPCP is set to the open state and a network level connection
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:
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
.Bd -literal -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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
smaller than the default. The usual value is 255.255.255.255, as
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
may be used to specify this IP number. This will not affect the
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
address and won't permit the use of any IP address but 192.244.177.2.
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
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
all IP addresses and the other side should go along with it. In order
to allow more flexible behaviour, the
.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 /
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
I'd like to use 192.244.177.38 as my address if it is possible, but I'll
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
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
I'd like to make him use 192.244.177.2 as his own address, but I'll also
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
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
preferred IP address and will obey the remote peers selection. 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
using zero, no routing table entries will be made until a connection
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
192.244.177.2/0 means that I'll accept/permit any IP address but I'll
try to insist that 192.244.177.2 be used first.
.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
.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
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
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 \&: :
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
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.No set phone Ar telno Ns Xo
.Oo \&| Ns Ar backupnumber
.Oc Ns ... Ns Oo : Ns Ar nextnumber
.Oc Ns ...
.Xc
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
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
previous number was used in a failed dial or login script. Numbers
separated by a colon are used sequentially, irrespective of what happened
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
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
Here, the 1234567 number is attempted. If the dial or login script fails,
the 2345678 number is used next time, but *only* if the dial or login script
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
(although a given site would usually prefer to use either the pipe or the
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
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
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
commands. The
.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
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
Expect OK. If that's not received within the 4 second timeout, send ATZ
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
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
Once the connection is established, the login script is executed. This
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
script is written in the same style as the dial script, but care should
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
Expect "login:". If it's not received, send a carriage return and expect
"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
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +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;
.Sq ******** Ns
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
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
Login scripts vary greatly between ISPs. If you're setting one up
for the first time,
.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
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
set device /dev/cuaa0
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
Cosmetic: Remove unused variables and build on OpenBSD.
1997-09-10 02:20:35 +00:00
Cuaa0 is the first serial port on FreeBSD. If you're running
.Nm
on OpenBSD, 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
command to define the IP address.
.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
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
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 .
This will force your ISP to assign a number. (The third argument will
be ignored as it is less restrictive than the default mask for your
.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
An example for a connection where you don't know your IP number or your
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
In most cases, your ISP will also be your default router. If this 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
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 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 .
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
.Pq 10.0.0.2 in this example .
This route is
.Sq sticky ,
meaning that should the value of
.Dv HISADDR
change, the route will be updated accordingly.
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
Previous versions of
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
required a similar entry in the
.Pa /etc/ppp/ppp.linkup
file. Since the advent of
.Sq sticky routes ,
Fix a few typos Submitted by: Forgotten (sorry)
1998-11-08 13:05:30 +00:00
this is no longer required.
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
Do
.Em NOT
do this if you are running an local DNS, as
.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
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
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
.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 ,
.Sq login
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.
.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.
.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
Output to the terminal device. If there is currently no terminal,
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
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
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
It is also possible to log directly to the screen. The syntax is
the same except that the word
.Dq local
should immediately follow
.Dq set log .
The default is
.Dq set log local
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
(ie. 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:
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
(if any). This will cause
.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.
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.
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
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
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
protocol. Refer to RFC 1990 for specification details.
.Pp
The peer is identified using a combination of his
.Dq endpoint discriminator
and his
.Dq authentication id .
Either or both of these may be specified. It is recommended that
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
confusing lock-ups may result. Locally, these identification variables
are specified using the
.Dq set enddisc
and
.Dq set authname
commands. The
.Sq authname
.Pq and Sq authkey
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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
command (set maximum reconstructed receive unit). Once 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
is enabled,
.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
.Pq called Sq deflink .
To create more links, the
.Dq clone
command is used. This command will clone existing links, where all
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
link. It's mode may subsequently be changed using the
.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
Once a new link has been created, command usage varies. All link
specific commands must be prefixed with the
.Dq link Ar name
command, specifying on which link the command is to be applied. When
only a single link is available,
.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
level. For example, once two or more links are available, the command
.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:
.Pp
.Bd -literal -offset indent
mp:
set timeout 0
set log phase chat
set device /dev/cuaa0 /dev/cuaa1 /dev/cuaa2
set phone "123456789"
set dial "ABORT BUSY ABORT NO\\sCARRIER TIMEOUT 5 \\"\\" ATZ \e
OK-AT-OK \\\\dATDT\\\\T TIMEOUT 45 CONNECT"
set login
set ifaddr 10.0.0.1/0 10.0.0.2/0
set authname ppp
set authkey ppppassword
set mrru 1500
clone 1,2,3
link deflink remove
.Ed
.Pp
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
to be up all the time, you can add the following line to the end of your
configuration.
.Pp
.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:
.Pp
.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:
.Pp
.Bd -literal -offset indent
link 1 set device /dev/cuaa0
link 2 set device /dev/cuaa1
link 3 set device /dev/cuaa2
.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
directory. This socket is used to pass link information (including
the actual link file descriptor) between different
.Nm
invocations. This facilitates
.Nm ppp Ns No s
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
line. Once
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
already running process. If there is no already running process,
.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
This section lists the available commands and their effect. They are
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
usable either from an interactive
.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.
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
how to negotiate the initial connection with the peer. Each
.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:
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
Default: Enabled and Accepted. ACFComp stands for Address and Control
Mention ``show mp''. Describe ACFComp correctly.
1999-05-02 08:52:50 +00:00
Field Compression. Non LCP packets will usually have an address
field of 0xff (the All-Stations address) and a control field of
0x03 (the Unnumbered Information command). If this option is
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
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
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
passwords are sent across the connection.
A challenge is made when the connection is first made. Subsequent
Document the use of PAP/CHAP properly.
1997-09-09 21:01:53 +00:00
challenges may occur. If you want to have your peer authenticate
itself, you must
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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
Default: Enabled and Accepted. This option decides if deflate
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
.Xr pppd 8
- 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
.Pa rfc1975 Ns 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
.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
Default: Disabled and Denied. This is a variance of the
.Ar deflate
option, allowing negotiation with the
.Xr pppd 8
program. Refer to the
.Ar deflate
section above for details. It is disabled by default as it violates
.Pa rfc1975 .
.It dns
`dns' option defaults to disabled, not enabled.
1998-08-09 23:40:31 +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
them. The answer is taken from
.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
Default: Enabled and Accepted. This option allows control over whether we
negotiate an endpoint discriminator. We only send our discriminator if
.Dq set enddisc
is used and
.Ar enddisc
is enabled. We reject the peers discriminator if
.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
Default: Disabled and Accepted. The use of this authentication protocol
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
Default: Disabled and Accepted. This option decides if Link Quality
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
carrier detect. When LQR is enabled,
.Nm
sends the
.Em QUALPROTO
option (see
.Dq set lqrperiod
below) as part of the LCP request. If the peer agrees, both sides will
exchange LQR packets at the agreed frequency, allowing detailed link
quality monitoring by enabling LQM logging. If the peer doesn't agree,
ppp will send ECHO LQR requests instead. These packets pass no
information of interest, but they
.Em MUST
be replied to by the peer.
.Pp
Whether using LQR or ECHO LQR,
.Nm
will abruptly drop the connection if 5 unacknowledged packets have been
sent rather than sending a 6th. A message is logged at the
.Em PHASE
level, and any appropriate
.Dq reconnect
values are honoured as if the peer were responsible for dropping the
connection.
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
Default: Disabled and Accepted. The use of this authentication protocol
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). It is very similar to standard CHAP (type 0x05)
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
standard MD5 mechanism. CHAP type 0x80 for LANMan is also supported - see
.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
one of the two protocols. This gives the peer a chance to attempt using
both protocols.
.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
Note: If only LANMan is enabled,
.Xr pppd 8
(version 2.3.5) misbehaves when acting as authenticatee. It provides both
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
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
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
Default: Enabled and Accepted. This option is used to negotiate
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
Default: Enabled and Accepted. This option determines if
.Nm
will request and accept requests for short
.Pq 12 bit
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
Default: Enabled and Accepted. This option determines if Van Jacobson
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
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.
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
Default: Enabled. When
.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
field, reporting the fact at the respective log level. If
.Ar idcheck
is disabled,
.Nm
will ignore the identifier field.
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
Default: Disabled. When
.Nm
runs as a Multi-link server, a different
.Nm
instance initially receives each connection. After determining that
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
.Nm ppp Ns No 's
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
from exiting due to the death of its child. As
.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
Default: Enabled. When
.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
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. If disabled,
.Nm
will send the packet, probably resulting in an ICMP redirect from
the other end. It is convenient to have this option enabled when
the interface is also the default route as it avoids the necessity
of a loopback route.
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
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
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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
is always checked first. If you wish to use passwords from
.Xr passwd 5 ,
but also to specify an IP number or label for a given client, use
.Dq \&*
as the client password in
.Pa /etc/ppp/ppp.secret .
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
Default: Disabled. Enabling this option will tell
.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
to proxy ARP for the peer. This means that
.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
appears. The proxy entry cannot be made unless
.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
Default: Disabled. Enabling this will tell
.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
command. No proxy arp entries are made for the interface address itself
(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
Default: Enabled. When the
.Dq add
command is used with the
.Dv HISADDR
or
.Dv MYADDR
values, entries are stored in the
.Sq stick route
list. Each time
.Dv HISADDR
or
.Dv MYADDR
change, this list is re-applied to the routing table.
.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.
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
to gather throughput statistics. Input and output is sampled over
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
a rolling 5 second window, and current, best and total figures are
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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
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
Default: Enabled. Normally, when a user is authenticated using PAP or
CHAP, and when
.Nm
is running in
.Fl direct
mode, an entry is made in the utmp and wtmp files for that user. Disabling
o Spelling police. o Emphasize ``PPP'' o x-ref other programs o Some minor clarifications
1997-11-06 00:25:33 +00:00
this option will tell
.Nm
not to make any utmp or wtmp entries. This is usually only necessary if
you require the user to both login and authenticate themselves.
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-alias
Default: Enabled if
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
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 specified. This option simply tells
.Nm
to add new interface addresses to the interface rather than replacing them.
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 option can only be enabled if network address translation is enabled
.Pq Dq nat enable yes .
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
With this option enabled,
.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
will pass traffic for old interface addresses through the NAT engine
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
.Pq see Xr libalias 5 ,
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
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
Disabling NAT with
.Dq nat enable no
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
will also disable
.Sq iface-alias .
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
.Op \&!
.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
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 destination IP address. The netmask is specified either as a
number of bits with
.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
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
machine/network. Refer to the
.Xr route 8
command for further details.
.Pp
It is possible to use the symbolic names
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
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 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 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
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
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
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 replaced with the interface address 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
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 replaced with the interface destination (peer) 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
.Ar add!
command is 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
.Pq 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
.Dq HISADDR
or
.Dq MYADDR
constants are considered
.Sq sticky .
They are stored in a list (use
.Dq show ipcp
to see the list), and each time the value of
.Dv HISADDR
or
.Dv MYADDR
changes, the appropriate routing table entries are updated. This facility
may be disabled using
.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
and its configuration files. It is possible to allow user-level access,
depending on the configuration file label and on the mode that
.Nm
is being run in. For example, you may wish to configure
.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.
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
.Nm ppp .
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
command is found. The
.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
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
loaded at startup). Each successive
.Dq allow users
command overrides the previous one, so it's possible to allow users access
to everything except a given label by specifying default users in the
.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
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 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
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 ppp .
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
For backwards compatibility, the word
.Dq alias
may be used in place of
.Dq nat .
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:
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
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
If set to yes, this command will refuse all incoming connections
by dropping the packets in much the same way as a firewall would.
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
This file name is likely to change in the near future.
.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
.Oc 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
A range of port numbers may be specified as shown above. The ranges
must be of the same size.
.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
.Pq indicating any source port
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.
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 pptp Op Ar addr
Support PPTP via libalias (``alias pptp addr'').
1999-03-07 18:13:44 +00:00
This tells
.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
to translate any
Support PPTP via libalias (``alias pptp addr'').
1999-03-07 18:13:44 +00:00
.Em G Ns No eneral
.Em R Ns No outing
.Em E Ns No encapsulated
.Pq Dv IPPROTO_GRE
packets using
.Ar addr
rather than the local interface address. This allows the uses of the
.Em P Ns No oint
to
.Em P Ns No oint
.Em T Ns No unneling
.Em P Ns No rotocol
on a machine on the internal network.
.Pp
If
.Ar addr
is not specified,
.Dv PPTP
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
address translation is disabled.
.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
to proxy certain connections, redirecting them to a given server. Refer
to the description of
.Fn PacketAliasProxyRule
in
.Xr libalias 3
for details of the available 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 same_ports yes|no
When enabled, this command will tell the network address translation engine to
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.
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
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
Only alter outgoing packets with an unregistered source ad-
dress. According to RFC 1918, unregistered source addresses
are 10.0.0.0/8, 172.16.0.0/12 and 192.168.0.0/16.
.El
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
.Pa README.alias
which comes with the source distribution.
.Pp
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It Op \&! Ns Xo
.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:
.Bl -tag -width PEER_ENDDISC
.It Li AUTHNAME
This is replaced with the local
.Ar authname
value. See the
.Dq set authname
command below.
.It Li ENDDISC
This is replaced with the local endpoint discriminator value. See the
.Dq set enddisc
command below.
.It Li HISADDR
This is replaced with the peers IP number.
.It Li INTERFACE
This is replaced with the name of the interface that's in use.
.It Li LABEL
This is replaced with the last label name used. A label may be specified
on the
.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.
.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 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
CHAP. Normally, this variable is assigned only in -direct mode. This value
is available irrespective of whether utmp logging is enabled.
.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
.Dq set proctitle
command.
.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 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 clear physical|ipcp 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 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
or
.Dq ipcp
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
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
argument(s). This command must be used from the
.Dq link
command below unless you've only got a single link (in which case that
link becomes the default). Links may be removed using the
.Dq remove
command below.
.Pp
The default link name is
.Dq deflink .
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +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
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
will not bring the link offline. It is subsequently possible to use
.Dq term
.Pq see below
to talk to the peer machine if, for example, something like
.Dq slirp
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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
is specified, only the relevant compression layer is closed. 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 \&!
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
further CCP negotiation. In any event, this command does not disconnect
the user from
.Nm
or exit
.Nm ppp .
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
.Op \&!
.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
IP address. If
.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
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
.Ar delete!
command is 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
.Pq 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.
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
.It dial|call Op Ar label Ns Xo
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
had become unavailable. It's not considered polite to use this command on
a Finite State Machine that's in the OPEN state. If no arguments are
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
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
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 not closed. If
.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
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
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.
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
.Nm ppp .
.Ar Command
may be one of the following:
.Bl -tag -width XX
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
.Op \&!
.Ar addr Ns Op / Ns Ar bits
.Op Ar peer
.Xc
.It iface add Ns Xo
.Op \&!
.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
combination to the interface. Instead of specifying
.Ar mask ,
.Ar /bits
can be used
.Pq with no space between \&it and Ar addr .
If the given address already exists, the command fails unless the
.Dq \&!
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.
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 clear
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
mode, all addresses except for the IPCP negotiated address are deleted
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
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
.Op \&! Ns
.No |rm Ns Op \&!
.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
from the interface. If the
.Dq \&!
is used, no error is given if the address isn't currently assigned to
the interface (and no deletion takes place).
.It iface show
Shows the current state and current addresses for the interface. It is
much the same as running
.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
sub-commands and a brief synopsis for each. When invoked with
.Ar sub-command ,
only the synopsis for the given sub-command is shown.
.El
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It Op data Ns Xo
.No link
.Ar name Ns Op , Ns Ar name Ns
.No ... Ar command Op Ar args
.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
specify which link the command should affect. This is only
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
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
specifies the name of an existing link. If
.Ar name
is a comma separated list,
.Ar command
is executed on each link. If
.Ar name
is
.Dq * ,
.Ar command
is executed on all links.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It load Op Ar label Ns Xo
.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
file. If
.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.
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
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. All closed links are immediately brought up apart from second
and subsequent
.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
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
can be used to put them into effect. After renegotiating LCP,
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
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
argument is used, the relevant compression layer is opened. Again,
if it is already open, it will be renegotiated.
.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
like this as it's possible that the peer will not behave correctly.
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
Don't log the actual password when command-logging "passwd xxxx".
1997-12-18 00:28:36 +00:00
command set. This password is required when connecting to the diagnostic
port (see the
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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,
ppp will exit after closing all connections. Otherwise, if the user
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
This command removes the given link. It is only really useful in
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
multi-link mode. A link must 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
in the
.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 ,
.Sq cuaa0
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.
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.
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
.No Op up
.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:
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +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 .
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set Op auth Ns Xo
.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
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
PAP or CHAP negotiation to the given value. It also specifies the
password to be used in the dial or login scripts in place of the
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
.Sq \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\P
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
is an exclaimation mark
.Pq Dq \&! ,
.Nm
treats the remainder of the string as a program that must be executed
to determine the
.Dq authname
and
.Dq authkey
values.
.Pp
Ignoring the
.Dq \&! ,
.Ar value
is parsed as a program to execute in the same was as the
.Dq !bg
command above, substituting special names in the same manner. Once executed,
.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
Correct spelling : ascii -> ASCII PR: docs/13702 Submitted by: Stephen J. Roznowski <sjr@home.com> Reviewed by: mpp
1999-09-20 09:15:23 +00:00
in this manner, it's expected that the host challenge is a series of ASCII
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
digits or characters. An encryption device or Secure ID card is usually
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
.Pq also known as Fl auto
mode link is available, only the first link is made active when
.Nm
first reads data from the tun device. The next
.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
seconds. When the current bundle throughput decreases to
.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
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 brought down as long as it's not the last active
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.
.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
must be greater than zero. It is currently only used by the
.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
.Ar option Ns No ).
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
request one of them. If you wish callback to be optional, you must include
.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):
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
.Bl -tag
.It auth
The callee is expected to decide the callback number based on
authentication. If
.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
Microsofts callback control protocol is used. See
.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 \&* ,
meaning any number is permitted. If
.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
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
the connection. This is required (in addition to one or more other callback
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
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set cbcp Oo Xo
.No *| Ns Ar number Ns No
.Oo
.No , Ns Ar number Ns
.Oc
.No ...
.Op Ar delay Op Ar retry
.Oc
.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
If no arguments are given, CBCP (Microsofts CallBack Control Protocol)
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.
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
.It set cd Ar seconds Ns Op \&!
Normally,
.Nm
checks for the existence of carrier one second after the login script is
complete. If it's not set,
.Nm
assumes that this is because the device doesn't 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
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
for carrier. However, some modems take some time to assert the carrier
signal, resulting in
.Nm ppp Ns No s
inability to detect when the link is dropped.
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
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
specifies the number of seconds that
.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
.Nm
will not proceed to the login script until either carrier is detected
or until
.Ar seconds
has elapsed.
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
is followed immediately by an exclaimation mark
.Pq Dq \&! ,
.Nm
will
.Em require
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
carrier. If carrier is not detected after
.Ar seconds
seconds, the link will be disconnected.
.Pp
For ISDN devices,
.Nm
will always insist on carrier. Carrier is raised by the i4brbchX device
driver only after the call has connected. It is therefore wise to set
a reasonable value such as
.Ar 6
seconds.
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
Carrier
.Em require Ns No ment
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 ignored for all other device types.
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
isn't specified, it is set to the default value of
.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
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
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
This sets hardware flow control. Hardware flow control is
.Ar on
by default.
.It set deflate Ar out-winsize Op Ar in-winsize
This sets the DEFLATE algorithms default outgoing and incoming window
sizes. Both
.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
command. Refer to the
.Dq accept
command description above for details. This command does not affect the
IP numbers requested using
.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
All ISDN and 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/ .
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
ISDN devices are usually called
.Pa i4brbchX
and serial devices are usually called
.Pa cuaaX .
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pq Dq \&!
or be of the format
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
.Dq host:port Ns Op Ns /proto .
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
is opened. Standard input, output and error are fed back to
.Nm
and are read and written as if they were a regular device.
.Pp
If a
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 host:port Ns Op /tcp|/udp
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
.Dq host
on the given
.Dq port .
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
If a tcp or udp specification is not given, the default is tcp. Refer to
the section on
.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
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
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
command below. Refer to
.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:
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
.Bd -unfilled -offset indent
.It Li \\\\\\\\\\\\\\\\c
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.
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 \\\\\\\\\\\\\\\\d
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.
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 \\\\\\\\\\\\\\\\p
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.
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 \\\\\\\\\\\\\\\\n
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.
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 \\\\\\\\\\\\\\\\r
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.
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 \\\\\\\\\\\\\\\\s
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.
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 \\\\\\\\\\\\\\\\t
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.
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 \\\\\\\\\\\\\\\\T
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).
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 \\\\\\\\\\\\\\\\P
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).
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 \\\\\\\\\\\\\\\\U
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).
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
.Ed
.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
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
.Pq Dq \&! .
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
and substituted as the expect or send string. If
.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
For example (wrapped for readability);
.Bd -literal -offset indent
set login "TIMEOUT 5 \\"\\" \\"\\" login:--login: ppp \e
word: ppp \\"!sh \\\\\\\\-c \\\\\\"echo \\\\\\\\-n label: >&2\\\\\\"\\" \e
\\"!/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!
Chat: Expecting:
Chat: Sending:
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
Chat: Sending:
Chat: Expecting: HELLO
Chat: Wait for (5): HELLO
login OK!
.Ed
.Pp
Note (again) the use of the escape character, allowing many levels of
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
important that the
.Dq \&-
signs are escaped, otherwise this parser will see them as constituting
an expect-send-expect sequence. When the
.Dq \&!
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
command rather than using the internal one. See
.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
This command sets our local endpoint discriminator. If set prior to
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
LCP negotiation, and if no
.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
option. The following discriminators may be set:
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
.Bd -unfilled -offset indent
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +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
Describe why a ``magic'' enddisc is not always a good idea.
1999-06-11 11:27:18 +00:00
A 20 digit random number is used. Care should be taken when using magic
numbers as restarting
.Nm
or creating a link using a different
.Nm
invocation will also use a different magic number and will therefore not
be recognised by the peer as belonging to the same bundle. This makes it
unsuitable for
.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.
.Ed
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
option above. It allows the user to specify a set of characters that
Replace hardcoded quoting with Sq or Dq.
1999-03-19 01:42:45 +00:00
will be
.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
.Op \&!
.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
Mention that ospf is a possible filter protocol.
1999-08-02 21:45:36 +00:00
.Oc Oo tcp|udp|ospf|igmp|icmp 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
.Oc
.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
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 four filter sets. The
.Em alive
filter specifies packets that keep the connection alive - reseting the
idle timer. The
.Em dial
filter specifies packets that cause
.Nm
to dial when in
.Fl auto
mode. The
.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
be done by the NAT engine on incoming packets. By default all filter
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
sets allow all packets to pass. Rules are processed in order according to
.Ar rule-no
(unless skipped by specifying a rule number as the
.Ar action ) .
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
Up to 40 rules may be given for each set. If a packet doesn't match
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
any of the rules in a given set, it is discarded. In the case of
.Em in
and
.Em out
filters, this means that the packet is dropped. In the case of
.Em alive
filters it means that the packet will not reset the idle timer and in
the case of
.Em dial
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
before it is closed. It should not normally be necessary, but can
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
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
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +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
Remove all remaining [ and ] characters (and do things properly).
1999-03-18 21:50:52 +00:00
.Bd -literal -offset indent
.Ar \&IP Ns Oo \&- Ns Ar \&IP Ns Xo
.Oc Oo , Ns Ar \&IP Ns
.Op \&- Ns Ar \&IP Ns
.Oc No ...
.Xc
.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
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
numbers to the peer. If the peer requests one of these numbers,
and that number is not already in use,
.Nm
will grant the peers request. This is useful if the peer wants
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
If the peer requests an IP number that's 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
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
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
range will be accepted. This is useful when negotiating with some
.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
line in the config file. In any other mode, these values are just
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
used for IPCP negotiations, and the interface isn't configured
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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
.Pq if PAP or CHAP are Dq enabled .
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.
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
.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
no reply from the peer before giving up. The default is 5 attempts for
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
peers response. The default is 3 attempts. Authentication protocols are
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
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
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
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.
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 lqrperiod Ar frequency
This command sets the
.Ar frequency
in seconds at which
.Em LQR
or
.Em ECHO LQR
packets are sent. The default is 30 seconds. You must also use the
.Dq enable lqr
command if you wish to send LQR requests to the peer.
.It set mode Ar interactive|auto|ddial|background
This command allows you to change the
.Sq mode
Some documentation corrections & typo fixes....
1998-05-29 18:32:41 +00:00
of the specified link. This is normally only useful in multi-link mode,
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
afterwards. This will allow
.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.
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
Multi-link Protocol or MP. There is no default MRRU (Maximum
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
Reconstructed Receive Unit) value. If no argument is given, multi-link
mode is disabled.
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
.It set mru Op 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 default MRU (Maximum Receive Unit) is 1500. If it is increased, the
other side *may* increase its mtu. 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
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
protocol *must* be able to accept packets of at least 1500 octets. If
no argument is given, 1500 is assumed.
.It set mtu Op 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 default MTU is 1500. At negotiation time,
.Nm
will accept whatever MRU or MRRU that the peer wants (assuming it's
not less than 296 bytes). If the MTU is set,
.Nm
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
will not accept MRU/MRRU values less than
.Ar value .
When negotiations are complete, the MTU is assigned to the interface, even
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 the peer requested a higher value MRU/MRRU. This can be useful for
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
If no
.Ar value
is given, 1500, or whatever the peer asks for is 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
.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
values to be returned at the peers request. If no values are given,
.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
comes up. If you want to wait for the peer to initiate negotiations, you
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
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 allows the line parity to be set. The default value is
.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
.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
below. In
.Fl background
mode, each number is attempted at most once.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It set Op proc Ns Xo
.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
is not specified, the original process title is restored. All the
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
This command enables RADIUS support (if it's compiled in).
.Ar config-file
refers to the radius client configuration file as described in
.Xr radius.conf 5 .
If PAP or CHAP are
.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
If neither PAP or CHAP are enabled,
.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.
.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
RADIUS routes override configured routes. This also applies for RADIUS
routes that don't include the
.Dv MYADDR
or
.Dv HISADDR
keywords.
.Pp
.El
Values received from the RADIUS server may be viewed using
.Dq show bundle .
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
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
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
This sets the routing table RECVPIPE value. The optimum value is
just over twice the MTU value. If
.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
.Op - Ns Ar max Ns
.Oc Op . Ns Ar next
.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
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
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
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 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
is taken before starting at the first number again. A literal value of
.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
done nothing. If an immediate dial is required, a
.Dq \&!
should immediately follow the
.Dq open
keyword. See the
.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
This sets the routing table SENDPIPE value. The optimum value is
just over twice the MTU value. If
.Ar value
is unspecified or zero, the default kernel controlled value is 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
.It set server|socket Ar TcpPort|LocalName|none password Op Ar mask
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
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 none
instructs
.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 socket.
.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
Correctly drop existing connections when reopening the diagnostic socket.
1999-03-07 11:54:43 +00:00
to be the name or number of a TCP port. You must specify the octal umask
that should be used with local domain sockets as a four character octal
number beginning with
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
.Sq 0 .
Refer to
.Xr umask 2
for umask details. Refer to
.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
command above) when connecting to this socket. If the password is
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
interface unit number. This is useful when you wish to use the same
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
command is the preferred mechanism of communications. Currently,
.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
Refer a bit to pppctl. Suggested (far to subtly for his own good) by: joerg
1997-10-05 14:27:08 +00:00
should not be relied upon.
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
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
This sets the speed of the serial device. If speed is specified as
.Dq sync ,
.Nm
treats the device as a synchronous device.
.Pp
Certain device types will know whether they should be specified as
synchronous or asynchronous. These devices will override incorrect
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
acknowledgement. This is also useful if you wish to
.Dq set openmode passive
and time out if the peer doesn't send a Configure Request within the
given time. Use
.Dq set log +lcp +ccp
to make
.Nm
log the appropriate state transitions.
.Pp
The default value is zero, where
.Nm
doesn't time out in the stopped state.
.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
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 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
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
.Op tcp|udp
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
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
prioritizes when transmitting data. The default priority TCP ports
are ports 21 (ftp control), 22 (ssh), 23 (telnet), 513 (login), 514 (shell),
543 (klogin) and 544 (kshell). There are no priority UDP ports by default.
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
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.
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
whether it should attempt to negotiate VJ slot compression. By default,
slot compression is turned
.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
command above). It defaults to a value of 16.
.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
MFMP: Make ppp multilink capable. See the file README.changes, and re-read the man page.
1998-05-21 21:49:08 +00:00
environment variable. Otherwise, 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. Word replacement is done in the same way as for the
.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
Use of the ! character
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
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:
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
List the current rules for the given filter. If
.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
.Pq 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.
Remove all hardcoded [...] syntax. With help from: Daniel C. Sobral <dcs@newsguy.com>
1999-03-17 00:25:43 +00:00
.It show Op data Ns Xo
.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 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
.Nm 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
.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
Go into terminal mode. Characters typed at the keyboard are sent to
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 device. Characters read from the device are displayed on the
screen. When a remote
.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
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
.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
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
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 ,
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 ? ,
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
.Dq enable ? ,
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 ?
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
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
.Dq show ?
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 get online information about what's available.
.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
http://www.FreeBSD.org/FAQ/userppp.html
.It
http://www.FreeBSD.org/handbook/userppp.html
.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
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
.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.
Don't use ``-width 20'', it's misleading. Use ``-width XX'' instead.
1998-08-29 23:02:45 +00:00
.Bl -tag -width XX
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
Logging and debugging information file. Note, this name is specified in
.Pa /etc/syslogd.conf .
See
.Xr syslog.conf 5
for further details.
.It Pa /var/spool/lock/LCK..*
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
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
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 tun interface used by this port. Again, this file is only created in
.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
.Nm 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
.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
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 ,
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 libalias 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 ,
.Xr crontab 5 ,
.Xr group 5 ,
.Xr passwd 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 ,
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
.Xr isdn 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 ,
Correct the files section for tunX.pid and ttyXX.if
1997-05-13 09:31:05 +00:00
.Xr pppd 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