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.8 2008/05/01 22:06:06 swildner 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 SYNOPSIS
  39 .Cd pseudo-device \&"i4bisppp\&" Op count
  40 .Sh DESCRIPTION
  41 The
  42 .Nm
  43 driver interfaces the IP subsystem of the operating system with the
  44 isdn4bsd package so that a transport of IP packets over an ISDN link
  45 is possible.
  46 .Pp
  47 The driver is just a glue layer between Serge Vakulenko's sppp
  48 backend and the ISDN4BSD package.
  49 .Pp
  50 Beginning with i4b version 0.95 (and only for
  51 .Fx
  52 and
  53 .Ns Dx ) ,
  54 the sppp subsystem was integrated into the
  55 .Nm
  56 driver to support more i4b/ISDN specific options. As a consequence it is no
  57 longer necessary to add a "options sppp" to your kernel
  58 .Xr config 8
  59 file. For configuration of the i4bsppp driver, either the
  60 .Xr spppcontrol 8
  61 utility is used or it is configured via
  62 .Xr isdnd 8
  63 and its associated
  64 .Xr isdnd.rc 5
  65 file.
  66 .Pp
  67 In case an IP packet for a remote side arrives in the driver and no
  68 connection is established yet, the driver communicates with the
  69 .Xr isdnd 8
  70 daemon to establish a connection.
  71 .Pp
  72 The driver has support for interfacing to the
  73 .Xr bpf 4
  74 subsystem for using
  75 .Xr tcpdump 1
  76 with the
  77 .Nm isp
  78 interfaces.
  79 .Pp
  80 The
  81 .Xr spppcontrol 8
  82 utility is used to configure all aspects of PPP required to connect to a
  83 remote site.
  84 .Sh LINK0 and LINK1
  85 The
  86 .Em link0
  87 and
  88 .Em link1
  89 flags given as parameters to
  90 .Xr ifconfig 8
  91 have the following meaning for the
  92 .Nm isp
  93 devices:
  94 .Pp
  95 .Bl -tag -width link0 -compact
  96 .It Li link0
  97 wait passively for connection
  98 .Pp
  99 .It Li link1
 100 auto-dial on output
 101 .El
 102 .Pp
 103 The
 104 .Em link0
 105 and
 106 .Em link1
 107 flags are set to
 108 .Em off
 109 by default.
 110 .Pp
 111 See
 112 .Xr sppp 4
 113 for a more detailed discussion of the flags,
 114 .Sh SEE ALSO
 115 .Xr tcpdump 1 ,
 116 .Xr bpf 4 ,
 117 .Xr sppp 4 ,
 118 .Xr isdnd.rc 5 ,
 119 .Xr isdnd 8 ,
 120 .Xr spppcontrol 8
 121 .Sh AUTHORS
 122 .An -nosplit
 123 The
 124 .Nm
 125 device driver was written by
 126 .An Joerg Wunsch Aq joerg@FreeBSD.org
 127 and then added to ISDN4BSD by
 128 .An Gary Jennejohn Aq gj@FreeBSD.org .
 129 .Pp
 130 This manpage was written by
 131 .An Hellmuth Michaelis Aq hm@FreeBSD.org .