Rename spppcontrol.1 to spppcontrol.8. The latter file was created

by repository copy.

2 files changed, 1 insertions, 227 deletions

diff --git a/sbin/spppcontrol/Makefile b/sbin/spppcontrol/Makefile
index 3909d3d..86eceac 100644
--- a/sbin/spppcontrol/Makefile
+++ b/sbin/spppcontrol/Makefile
@@ -1,3 +1,4 @@
 PROG=	spppcontrol
+MAN8=	spppcontrol.8
 
 .include <bsd.prog.mk>
diff --git a/sbin/spppcontrol/spppcontrol.1 b/sbin/spppcontrol/spppcontrol.1
deleted file mode 100644
index 2c538c4..0000000
--- a/sbin/spppcontrol/spppcontrol.1
+++ /dev/null
@@ -1,227 +0,0 @@
-.\" Copyright (C) 1997 by Joerg Wunsch, Dresden
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
-.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-.\" DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
-.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
-.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
-.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
-.\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.\" $Id: spppcontrol.1,v 1.2 1998/03/19 07:46:04 charnier Exp $
-.\"
-.Dd October 11, 1997
-.Os
-.Dt SPPPCONTROL 8
-.Sh NAME
-.Nm spppcontrol
-.Nd display or set parameters for an sppp interface
-.Sh SYNOPSIS
-.Nm spppcontrol
-.Op Fl v
-.Ar ifname
-.Op Ar parameter Ns Op \&= Ns Ar value
-.Op Ar ...
-.Sh DESCRIPTION
-The
-.Xr sppp 4
-driver might require a number of additional arguments or optional
-parameters besides the settings that can be adjusted with
-.Xr ifconfig 8 .
-These are things like authentication protocol parameters, but also
-other tunable configuration variables.  The
-.Nm
-utility can be used to display the current settings, or adjust these
-parameters as required.
-.Pp
-For whatever intent
-.Nm
-is being called, at least the parameter
-.Ar ifname
-needs to be specified, naming the interface for which the settings
-are to be performed or displayed.  Use
-.Xr ifconfig 8 ,
-or
-.Xr netstat 1
-to see which interfaces are available.
-.Pp
-If no other parameter is given,
-.Nm
-will just list the current settings for
-.Ar ifname
-and exit.  The reported settings include the current PPP phase the
-interface is in, which can be one of the names
-.Em dead ,
-.Em establish ,
-.Em authenticate ,
-.Em network ,
-or
-.Em terminate .
-If an authentication protocol is configured for the interface, the
-name of the protocol to be used, as well as the system name to be used
-or expected will be displayed, plus any possible options to the
-authentication protocol if applicable.  Note that the authentication
-secrets (sometimes also called
-.Em keys )
-are not being returned by the underlying system call, and are thus not
-displayed.
-.Pp
-If any additional parameter is supplied, superuser privileges are
-required, and the command works in
-.Ql set
-mode.  This is normally done quietly, unless the option
-.Fl v
-is also enabled, which will cause a final printout of the settings as
-described above once all other actions have been taken.  Use of this
-mode will be rejected if the interface is currently in any other phase
-than
-.Em dead .
-Note that you can force an interface into
-.Em dead
-phase by calling
-.Xr ifconfig 8
-with the parameter
-.Ql down .
-.Pp
-The currently supported parameters include:
-.Bl -tag -offset indent -width indent
-.It Ar authproto Ns \&= Ns Em protoname
-Set both, his and my authentication protocol to
-.Em protoname .
-The protocol name can be one of
-.Ql chap ,
-.Ql pap ,
-or
-.Ql none .
-In the latter case, the use of an authentication protocol will be
-turned off for the named interface.  This has the side-effect of
-clearing the other authentication-related parameters for this
-interface as well (i.e. system name and authentication secret will
-be forgotten).
-.It Ar myauthproto Ns \&= Ns Em protoname
-Same as above, but only for my end of the link. I.e. this is the
-protocol when remote is authenticator, and I am the peer required to
-authenticate.
-.It Ar hisauthproto Ns \&= Ns Em protoname
-Same as above, but only for his end of the link.
-.It Ar myauthname Ns \&= Ns Em name
-Set my system name for the authentication protocol.
-.It Ar hisauthname Ns \&= Ns Em name
-Set his system name for the authentication protocol.  For CHAP, this
-will only be used as a hint, causing a warning message if remote did
-supply a different name.  For PAP, it's the name remote must use to
-authenticate himself (in connection with his secret).
-.It Ar myauthsecret Ns \&= Ns Em secret
-Set my secret (key, password) for use in the authentication phase.
-For CHAP, this will be used to compute the response hash value, based
-on remote's challenge.  For PAP, it will be transmitted as plain text
-together with the system name.  Don't forget to quote the secrets from
-the shell if they contain shell metacharacters (or white space).
-.It Ar myauthkey Ns \&= Ns Em secret
-Same as above.
-.It Ar hisauthsecret Ns \&= Ns Em secret
-Same as above, to be used if we are authenticator and the remote peer
-needs to authenticate.
-.It Ar hisauthkey Ns \&= Ns Em secret
-Same as above.
-.It Ar callin
-Require remote to authenticate himself only when he's calling in, but
-not when we are caller.  This is required for some peers that do not
-implement the authentication protocols symmetrically (like Ascend
-routers, for example).
-.It Ar always
-The opposite of
-.Ar callin .
-Require remote to always authenticate, regardless of which side is
-placing the call.  This is the default, and will not be explicitly
-displayed in
-.Ql list
-mode.
-.It Ar norechallenge
-Only meaningful with CHAP.  Do not re-challenge peer once the initial
-CHAP handshake was successful.  Used to work around broken peer
-implementations that can't grok being re-challenged once the
-connection is up.
-.It Ar rechallenge
-With CHAP, send re-challenges at random intervals while the connection
-is in network phase.  (The intervals are currently in the range of 300
-through approximately 800 seconds.)  This is the default, and will not
-be explicitly displayed in
-.Ql list
-mode.
-.El
-.Sh EXAMPLES
-.Bd -literal
-# spppcontrol bppp0
-bppp0:	phase=dead
-	myauthproto=chap myauthname="uriah"
-	hisauthproto=chap hisauthname="ifb-gw" norechallenge
-.Ed
-.Pp
-Display the settings for bppp0.  The interface is currently in
-.Em dead
-phase, i.e. the LCP layer is down, and no traffic is possible.  Both
-ends of the connection use the CHAP protocol, my end tells remote the
-system name
-.Ql uriah ,
-and remote is expected to authenticate by the name
-.Ql ifb-gw .
-Once the initial CHAP handshake was successful, no further CHAP
-challenges will be transmitted.  There are supposedly some known CHAP
-secrets for both ends of the link which are not being shown.
-.Pp
-.Bd -literal
-# spppcontrol bppp0 \e
-	authproto=chap \e
-	myauthname=uriah myauthsecret='some secret' \e
-	hisauthname=ifb-gw hisauthsecret='another' \e
-	norechallenge
-.Ed
-.Pp
-A possible call to
-.Nm
-that could have been used to bring the interface into the state shown
-by the previous example.
-.Sh SEE ALSO
-.Xr netstat 1 ,
-.Xr sppp 4 ,
-.Xr ifconfig 8
-.Rs
-.%A B. Lloyd,  W. Simpson
-.%T "PPP Authentication Protocols"
-.%O RFC 1334
-.Re
-.Rs
-.%A W. Simpson, Editor
-.%T "The Point-to-Point Protocol (PPP)"
-.%O RFC 1661
-.Re
-.Rs
-.%A W. Simpson
-.%T "PPP Challenge Handshake Authentication Protocol (CHAP)"
-.%O RFC 1994
-.Re
-.Sh HISTORY
-The
-.Nm
-utility appeared in
-.Fx 3.0 .
-.Sh AUTHORS
-The program was written by
-.ie t J\(:org Wunsch,
-.el Joerg Wunsch,
-Dresden.