share/man/man4/ippp.4

   1 .\" $NetBSD: ippp.4,v 1.7 2005/06/23 12:47:38 peter Exp $
   2 .\"
   3 .\" Copyright (c) 1997, 2000 Hellmuth Michaelis. All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\"     $Id: ippp.4,v 1.8 2009/03/15 10:31:04 joerg Exp $
  27 .\"
  28 .\" $FreeBSD$
  29 .\"
  30 .\"     last edit-date: [Thu Aug 31 10:40:17 2000]
  31 .\"
  32 .Dd August 31, 2000
  33 .Dt IPPP 4
  34 .Os
  35 .Sh NAME
  36 .Nm ippp
  37 .Nd ISDN synchronous PPP network driver
  38 .Sh SYNOPSIS
  39 .Cd "pseudo-device ippp" Ar count
  40 .Sh DESCRIPTION
  41 The
  42 .Nm
  43 driver interfaces the IP subsystem of the operating system with the
  44 ISDN layer so that a transport of IP packets over an ISDN link
  45 is possible.
  46 .Pp
  47 For configuration of the
  48 .Nm
  49 driver, either the
  50 .Xr ipppctl 8
  51 utility is used or it is configured via
  52 .Xr isdnd 8
  53 and its associated
  54 .Xr isdnd.rc 5
  55 file.
  56 .Pp
  57 In case an IP packet for a remote side arrives in the driver and no
  58 connection is established yet, the driver communicates with the
  59 .Xr isdnd 8
  60 daemon to establish a connection.
  61 .Pp
  62 The driver has support for interfacing to the
  63 .Xr bpf 4
  64 subsystem for using
  65 .Xr tcpdump 8
  66 with the
  67 .Nm
  68 interfaces.
  69 .Pp
  70 The
  71 .Xr ipppctl 8
  72 utility is used to configure all aspects of PPP required to connect to a
  73 remote site.
  74 .Ss LINK0 and LINK1
  75 The
  76 .Em link0
  77 and
  78 .Em link1
  79 flags given as parameters to
  80 .Xr ifconfig 8
  81 have the following meaning for the
  82 .Nm
  83 devices:
  84 .Bl -tag -width link0
  85 .It Li link0
  86 Wait passively for connection.
  87 The administrative
  88 .Em Open
  89 event to the Link Control Protocol (LCP) layer will be delayed until
  90 after the lower layers signal an
  91 .Em Up
  92 event (rise of
  93 .Dq carrier ) .
  94 This can be used by lower layers to support a dial-in connection where
  95 the physical layer isn't available immediately at startup, but only
  96 after some external event arrives.
  97 Receipt of a
  98 .Em Down
  99 event from the lower layer will not take the interface completely down
 100 in this case.
 101 .It Li link1
 102 Dial-on-demand mode.
 103 The administrative
 104 .Em Open
 105 event to the LCP layer will be delayed until either an outbound
 106 network packet arrives, or until the lower layer signals an
 107 .Em Up
 108 event, indicating an inbound connection.
 109 As with passive mode, receipt of a
 110 .Em Down
 111 event (loss of carrier) will not automatically take the interface
 112 down, thus it remains available for further connections.
 113 .El
 114 .Pp
 115 The
 116 .Em link0
 117 flag is set to
 118 .Em off
 119 by default, the
 120 .Em link1
 121 flag to
 122 .Em on .
 123 .Sh SEE ALSO
 124 .Xr bpf 4 ,
 125 .Xr isdnd.rc 5 ,
 126 .Xr ipppctl 8 ,
 127 .Xr isdnd 8 ,
 128 .Xr tcpdump 8
 129 .Sh AUTHORS
 130 .An -nosplit
 131 The
 132 .Nm
 133 device driver was written by
 134 .An Joerg Wunsch Aq joerg@freebsd.org
 135 and then added to ISDN4BSD by
 136 .An Gary Jennejohn Aq gary@freebsd.org .
 137 .Pp
 138 This man page was written by
 139 .An Hellmuth Michaelis Aq hm@kts.org .