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

FreeBSD Manual Pages


home | help
ISDNTRACE(8)		  BSD 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	de-
     fault 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

     -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 de-
	     sired.  (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.  (NO-
		   TICE: 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	re-
     placed 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.

BSD			       November	1, 2000				   BSD


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

home | help