diff options
Diffstat (limited to 'usr.sbin/i4b/ispppcontrol/ispppcontrol.8')
-rw-r--r-- | usr.sbin/i4b/ispppcontrol/ispppcontrol.8 | 244 |
1 files changed, 0 insertions, 244 deletions
diff --git a/usr.sbin/i4b/ispppcontrol/ispppcontrol.8 b/usr.sbin/i4b/ispppcontrol/ispppcontrol.8 deleted file mode 100644 index 5eb939f..0000000 --- a/usr.sbin/i4b/ispppcontrol/ispppcontrol.8 +++ /dev/null @@ -1,244 +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. -.\" -.\" From: spppcontrol.1,v 1.1.1.1 1997/10/11 11:30:30 joerg Exp -.\" -.\" $Id: ispppcontrol.8,v 1.2 2000/08/31 08:51:06 hm Exp $ -.\" -.\" $FreeBSD$ -.\" -.\" last edit-date: [Mon Oct 9 16:20:25 2000] -.\" -.Dd August 31, 2000 -.Os -.Dt ISPPPCONTROL 8 -.Sh NAME -.Nm ispppcontrol -.Nd display or set parameters for an isdn4bsd isp interface -.Sh SYNOPSIS -.Nm -.Op Fl v -.Ar ifname -.Op Ar parameter Ns Op \&= Ns Ar value -.Op Ar ... -.Sh DESCRIPTION -The -.Xr i4bisppp 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 plaintext -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. -.It Ar lcp-timeout Ns \&= Ns Em timeout-value -Allows to change the value of the LCP timeout. The default value of the -LCP timeout is currently set to 3 seconds which is too high for some -remote PPP implentations. The timeout-value must specified in milliseconds. -.It Ar enable-vj -Enable negotiation of Van Jacobsen header compression. -.It Ar disable-vj -Disable negotiation of Van Jacobsen header compression. -.El -.Sh EXAMPLES -.Bd -literal -# ispppcontrol isp0 -isp0: phase=dead - myauthproto=chap myauthname="uriah" - hisauthproto=chap hisauthname="ifb-gw" norechallenge - lcp timeout: 3.000 s - enable_vj: on -.Ed -.Pp -Display the settings for isp0. 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 -# ispppcontrol isp0 \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 i4bisppp 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 is based on the -.Xr spppcontrol 8 -utility which appeared in -.Fx 3.0 . -.Sh AUTHORS -The program was written by -.An J\(:org Wunsch , -Dresden. |