usr.sbin/i4b/isdndecode/isdndecode.8

   1 .\"
   2 .\" Copyright (c) 1998, 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: isdndecode.8,v 1.9 2000/02/21 15:17:17 hm Exp $
  26 .\"
  27 .\"     last edit-date: [Mon Feb 21 16:15:09 2000]
  28 .\"
  29 .\" $FreeBSD: src/usr.sbin/i4b/isdndecode/isdndecode.8,v 1.9.2.5 2003/03/11 21:13:49 trhodes Exp $
  30 .\"
  31 .Dd February 21, 2000
  32 .Dt ISDNDECODE 8
  33 .Os
  34 .Sh NAME
  35 .Nm isdndecode
  36 .Nd isdn4bsd ISDN protocol decode utility
  37 .Sh SYNOPSIS
  38 .Nm
  39 .Op Fl a
  40 .Op Fl b
  41 .Op Fl d
  42 .Op Fl f Ar filename
  43 .Op Fl h
  44 .Op Fl i
  45 .Op Fl l
  46 .Op Fl o
  47 .Op Fl p Ar filename
  48 .Op Fl u Ar number
  49 .Op Fl x
  50 .Op Fl B
  51 .Op Fl P
  52 .Op Fl R Ar unit
  53 .Op Fl T Ar unit
  54 .Sh DESCRIPTION
  55 The
  56 .Nm
  57 utility is part of the isdn4bsd package and is used to provide the user with a
  58 detailed mnemonic display of the layers 1, 2 and 3 protocol activities on
  59 the D channel and hex dump of the B channel(s) activities.
  60 .Pp
  61 Together with two passive supported cards and an easy to build cable it can
  62 also be used to monitor the complete traffic on a S0 bus providing S0 bus
  63 analyzer features.
  64 .Pp
  65 The
  66 .Nm
  67 utility is only available for passive supported cards.
  68 .Pp
  69 The following options can be used:
  70 .Bl -tag -width Ds
  71 .It Fl a
  72 Run
  73 .Nm
  74 in analyzer mode by using two passive cards and a custom cable which can
  75 be build as described in the file
  76 .Em cable.txt
  77 in the isdn4bsd source distribution. One card acts as a receiver for the
  78 transmitting direction on the S0 bus while the other card acts as a receiver
  79 for the receiving direction on the S0 bus. Complete traffic monitoring is
  80 possible using this setup.
  81 .It Fl b
  82 switch B channel tracing on (default off).
  83 .It Fl d
  84 switch D channel tracing off (default on).
  85 .It Fl f
  86 Use
  87 .Ar filename
  88 as the name of a file into which to write tracing output (default filename is
  89 isdndecode<n> where n is the number of the unit to decode).
  90 .It Fl h
  91 switch display of header off (default on).
  92 .It Fl i
  93 print layer 1 (I.430) INFO signals to monitor layer 1 activity (default off).
  94 .It Fl l
  95 switch displaying of Layer 2 (Q.921) frames off (default on).
  96 .It Fl o
  97 switch off writing decode output to a file (default on).
  98 .It Fl p
  99 Use
 100 .Ar filename
 101 as the name of a file used for the -B and -P options (default filename
 102 is isdntracebin<n> where n is the number of the unit to decode).
 103 .It Fl u
 104 Use
 105 .Ar number
 106 as the unit number of the controller card to decode (default 0).
 107 .It Fl x
 108 Decode Layer 3 packets with an unknown protocol discriminator.
 109 .It Fl B
 110 Write undecoded binary decode data to a file for later or remote
 111 analyzing (default off).
 112 .It Fl P
 113 Read undecoded binary decode data from file instead from device (default off).
 114 .It Fl R
 115 Use
 116 .Ar unit
 117 as the receiving interface unit number in analyze mode.
 118 .It Fl T
 119 Use
 120 .Ar unit
 121 as the transmitting interface unit number in analyze mode.
 122 .El
 123 .Pp
 124 When the USR1 signal is sent to a
 125 .Nm
 126 process, the currently used logfiles are reopened, so that logfile
 127 rotation becomes possible.
 128 .Pp
 129 The decode output should be obvious. It is very handy to have the following
 130 standard texts available when tracing ISDN protocols:
 131 .Pp
 132 .Bl -tag -width Ds -compact -offset indent
 133 .It Ar I.430
 134 ISDN BRI layer 1 protocol description.
 135 .It Ar Q.921
 136 ISDN D-channel layer 2 protocol description.
 137 .It Ar Q.931
 138 ISDN D-channel layer 3 protocol description.
 139 .El
 140 .Sh FILES
 141 .Bl -tag -width daddeldi -compact
 142 .It Pa /dev/i4btrc<n>
 143 The devicefile(s) used to get the decode messages for ISDN card unit <n>
 144 out of the kernel.
 145 .El
 146 .Sh EXAMPLES
 147 The command:
 148 .Bd -literal -offset indent
 149 isdndecode -f /var/tmp/isdn.decode
 150 .Ed
 151 .Pp
 152 will start D channel tracing on passive controller 0 with all except B
 153 channel tracing enabled and logs everything into the output file
 154 /var/tmp/isdn.decode.
 155 .Sh SEE ALSO
 156 .Xr isdnd 8
 157 .Sh BUGS
 158 Still one left.
 159 .Sh STANDARDS
 160 ITU Recommendations I.430, Q.920, Q.921, Q.930, Q.931
 161 .Pp
 162 ITU Recommendation Q.932 (03/93), Q.950 (03/93)
 163 .Pp
 164 ETSI Recommendation ETS 300 179 (10/92), ETS 300 180 (10/92)
 165 .Pp
 166 ETSI Recommendation ETS 300 181 (04/93), ETS 300 182 (04/93)
 167 .Pp
 168 ITU Recommendation X.208, X.209
 169 .Sh AUTHORS
 170 The
 171 .Nm
 172 utility and this manual page were written by
 173 .An Hellmuth Michaelis Aq hm@kts.org .