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	setup.

     -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

     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).


     Still some	or more	left.

     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.

FreeBSD	11.1		       November	1, 2000			  FreeBSD 11.1


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

home | help