usr.sbin/i4b/man/i4bisppp.4

   1 .\"
   2 .\" Copyright (c) 1997, 2000 Hellmuth Michaelis. All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\"
  13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  23 .\" SUCH DAMAGE.
  24 .\"
  25 .\"     $Id: i4bisppp.4,v 1.13 2000/08/31 08:45:07 hm Exp $
  26 .\"
  27 .\" $FreeBSD: src/usr.sbin/i4b/man/i4bisppp.4,v 1.7.2.7 2003/03/13 03:10:59 trhodes Exp $
  28 .\" $DragonFly: src/usr.sbin/i4b/man/i4bisppp.4,v 1.2 2003/06/17 04:29:55 dillon Exp $
  29 .\"
  30 .\"     last edit-date: [Thu Aug 31 10:40:17 2000]
  31 .\"
  32 .Dd August 31, 2000
  33 .Dt I4BISPPP 4
  34 .Os
  35 .Sh NAME
  36 .Nm i4bisppp
  37 .Nd isdn4bsd synchronous PPP over ISDN B-channel network driver
  38 .Sh FreeBSD SYNOPSIS
  39 .Cd pseudo-device \&"i4bisppp\&" Op count
  40 .Sh NetBSD SYNOPSIS
  41 none
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 driver interfaces the IP subsystem of the operating system with the
  46 isdn4bsd package so that a transport of IP packets over an ISDN link
  47 is possible.
  48 .Pp
  49 The driver is just a glue layer between Serge Vakulenko's sppp
  50 backend and the ISDN4BSD package.
  51 .Pp
  52 Beginning with i4b version 0.95 (and only for
  53 .Fx ) ,
  54 the sppp
  55 subsystem was integrated into the
  56 .Nm
  57 driver to support more i4b/ISDN specific options. As a consequence it is no
  58 longer necessary to add a "options sppp" to your kernel
  59 .Xr config 8
  60 file. For configuration of the i4bsppp driver, either the
  61 .Xr ispppcontrol 8
  62 utility is used or it is configured via
  63 .Xr isdnd 1
  64 and its associated
  65 .Xr isdnd.rc 5
  66 file.
  67 .Pp
  68 In case an IP packet for a remote side arrives in the driver and no
  69 connection is established yet, the driver communicates with the
  70 .Xr isdnd 8
  71 daemon to establish a connection.
  72 .Pp
  73 The driver has support for interfacing to the
  74 .Xr bpf 4
  75 subsystem for using
  76 .Xr tcpdump 1
  77 with the
  78 .Nm isp
  79 interfaces.
  80 .Pp
  81 The
  82 .Xr ispppcontrol 8
  83 utility is used to configure all aspects of PPP required to connect to a
  84 remote site.
  85 .Sh LINK0 and LINK1
  86 The
  87 .Em link0
  88 and
  89 .Em link1
  90 flags given as parameters to
  91 .Xr ifconfig 8
  92 have the following meaning for the
  93 .Nm isp
  94 devices:
  95 .Bl -tag -width link0 -compact
  96 .Pp
  97 .It Li link0
  98 wait passively for connection
  99 .Pp
 100 .It Li link1
 101 auto-dial on output
 102 .El
 103 .Pp
 104 The
 105 .Em link0
 106 and
 107 .Em link1
 108 flags are set to
 109 .Em off
 110 by default.
 111 .Pp
 112 See
 113 .Xr sppp 4
 114 for a more detailed discussion of the flags,
 115 .Sh SEE ALSO
 116 .Xr tcpdump 1 ,
 117 .Xr bpf 4 ,
 118 .Xr sppp 4 ,
 119 .Xr isdnd.rc 5 ,
 120 .Xr isdnd 8 ,
 121 .Xr ispppcontrol 8
 122 .Sh AUTHORS
 123 .An -nosplit
 124 The
 125 .Nm
 126 device driver was written by
 127 .An Joerg Wunsch Aq joerg@FreeBSD.org
 128 and then added to ISDN4BSD by
 129 .An Gary Jennejohn Aq gj@FreeBSD.org .
 130 .Pp
 131 This manpage was written by
 132 .An Hellmuth Michaelis Aq hm@FreeBSD.org .