Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
ISDNTRACE(8)            FreeBSD System Manager's Manual           ISDNTRACE(8)

     isdntrace -- isdn4bsd ISDN protocol trace utility

     isdntrace [-a] [-b] [-d] [-f filename] [-h] [-i] [-l] [-n number] [-o]
               [-p filename] [-r] [-u number] [-x] [-B] [-F] [-P] [-R unit]
               [-T unit]

     The isdntrace utility is part of the isdn4bsd package and is used to pro-
     vide the user with a mnemonic display of the layers 1, 2 and 3 protocol
     activities on the D channel and hex dump of the B channel(s) activities.

     Together with two passive supported cards and an easy to build cable it
     can also be used to monitor the complete traffic on a S0 bus providing S0
     bus analyzer features.

     The isdntrace utility is only available for passive supported cards.


     All filenames, user specified or default, get a date and time stamp
     string added in the form -yyyymmdd-hhmmss: a hyphen, four digits year,
     two digits month and day, a hyphen and two digits hour, minutes and sec-
     onds.  Tracefiles no longer get overwritten.  In case a new filename is
     needed within a second, the filename-generating mechanism sleeps one sec-

     In case the program is sent a USR1 signal, a new user specified or
     default filename with a new date and timestamp is generated and opened.

     The following options can be used:

     -a      Run isdntrace in analyzer mode by using two passive cards and a
             custom cable which can be build as described in the file
             cable.txt in the isdn4bsd source distribution.  One card acts as
             a receiver for the transmitting direction on the S0 bus while the
             other card acts as a receiver for the receiving direction on the
             S0 bus.  Complete traffic monitoring is possible using this set-

     -b      switch B channel tracing on (default off).

     -d      switch D channel tracing off (default on).

     -f      Use filename as the name of a file into which to write tracing
             output (default filename is isdntrace<n> where n is the number of
             the unit to trace).

     -h      switch display of header off (default on).

     -i      print layer 1 (I.430) INFO signals to monitor layer 1 activity
             (default off).

     -l      switch displaying of Layer 2 (Q.921) frames off (default on).

     -n      This option takes a numeric argument specifying the minimum frame
             size in octets a frame must have to be displayed.  (default 0)

     -o      switch off writing trace output to a file (default on).

     -p      Use filename as the name of a file used for the -B and -P options
             (default filename is isdntracebin<n> where n is the number of the
             unit to trace).

     -r      Switch off printing a raw hexadecimal dump of the packets preced-
             ing the decoded protocol information (default on).

     -u      Use number as the unit number of the controller card to trace
             (default 0).

     -x      Switch on printing of packets with a non-Q.931 protocol discrimi-
             nator.  (default off).

     -B      Write undecoded binary trace data to a file for later or remote
             analyzing (default off).

     -F      This option can only be used when option -P (playback from binary
             data file) is used.  The -F option causes playback not to stop at
             end of file but rather to wait for additional data to be avail-
             able from the input file.

             This option is useful when trace data is accumulated in binary
             format (to save disk space) but a monitoring functionality is
             desired.  (default off).

     -P      Read undecoded binary trace data from file instead from device
             (default off).

     -R      Use unit as the receiving interface unit number in analyze mode.

     -T      Use unit as the transmitting interface unit number in analyze

     When the USR1 signal is sent to a isdntrace process, the currently used
     logfiles are reopened, so that logfile rotation becomes possible.

     The trace output should be obvious.  It is very handy to have the follow-
     ing standard texts available when tracing ISDN protocols:

           I.430   ISDN BRI layer 1 protocol description.
           Q.921   ISDN D-channel layer 2 protocol description.
           Q.931   ISDN D-channel layer 3 protocol description.
           1TR6    German-specific ISDN layer 3 protocol description.
                   (NOTICE: decoding of the 1TR6 protocol is included but not
                   supported since i dont have any longer access to a 1TR6
                   based ISDN installation.)

     The isdntrace utility automatically detects the layer 3 protocol being
     used by looking at the Protocol Discriminator (see: Q.931/1993 pp. 53).

               The devicefile(s) used to get the trace messages for ISDN card
               unit <n> out of the kernel.

     The command:

           isdntrace -f /var/tmp/isdn.trace

     will start D channel tracing on passive controller 0 with all except B
     channel tracing enabled and logs everything into the output file
     /var/tmp/isdn.trace-yyyymmdd-hhmmss (where yyyymmdd and hhmmss are
     replaced by the current date and time values).


     ITU Recommendations I.430, Q.920, Q.921, Q.930, Q.931

     FTZ Richtlinie 1TR3, Band III

     ITU Recommendation Q.932 (03/93), Q.950 (03/93)

     ETSI Recommendation ETS 300 179 (10/92), ETS 300 180 (10/92)

     ETSI Recommendation ETS 300 181 (04/93), ETS 300 182 (04/93)

     ITU Recommendation X.208, X.209

     The isdntrace utility was written by Gary Jennejohn <> and
     Hellmuth Michaelis <>.

     This manual page was written by Hellmuth Michaelis.

     Still some or more left.

FreeBSD 6.2                    November 1, 2000                    FreeBSD 6.2


Want to link to this manual page? Use this URL:

home | help