isdnmonitor(8) [netbsd man page]
ISDNMONITOR(8) BSD System Manager's Manual ISDNMONITOR(8) NAME
isdnmonitor -- isdn4bsd / isdnd remote monitoring tool SYNOPSIS
isdnmonitor [-c] [-d debuglevel] [-f filename] [-h hostspec] [-l pathname] [-p portspec] DESCRIPTION
isdnmonitor is used to remotely monitor the operation of the ISDN demon, isdnd(8), which manages all ISDN related connection and disconnec- tion of ISDN devices supported by the isdn4bsd package. The options are as follows: -c Switch to (curses-) fullscreen mode of operation. In this mode, isdnmonitor behaves nearly exactly as isdnd(8) in fullscreen mode. In fullscreen mode, entering the control character Control-L causes the display to be refreshed and entering Carriage-Return or Enter will pop-up a command window. Because isdnmonitor will not listen to messages while the command window is active, this command window will disappear automatically after 5 seconds without any command key press. While the command window is active, Tab or Space advances to the next menu item. To execute a command, press Return or Enter for the highlighted menu item, or enter the number corresponding to the item to be executed or enter the capitalized character in the menu item description. -d If debugging support is compiled into isdnmonitor this option is used to specify the debugging level. In addition, this option accepts also the character 'n' as an argument to disable displaying debug messages on the full-screen dis- play. -f Specifying this option causes isdnmonitor to write its normal output and - if enabled - debugging output to a file which name is specified as the argument. -l is used to specify a Unix local domain socket name to be used for communication between isdnd(8) and isdnmonitor -h is used to specify a hostname or a dotted-quad IP address of a machine where an isdnd(8) is running which should be monitored. -p This option may be used to specify a remote port number in conjunction with the -h option. ENVIRONMENT
The following environment variables affect the execution of isdnmonitor: TERM The terminal type when running in full-screen display mode. See environ(7) for more information. EXAMPLES
For a first try, the following command should be used to start isdnmonitor to monitor a locally running isdnd: isdnmonitor -h localhost DIAGNOSTICS
Exit status is 0 on success, 1 on error. SEE ALSO
isdnd(8) AUTHORS
The isdnmonitor utility was written by Martin Husemann and Hellmuth Michaelis. This manual page was written by Hellmuth Michaelis <hm@kts.org>. BSD
September 25, 1999 BSD
Check Out this Related Man Page
ISDNTRACE(8) BSD System Manager's Manual ISDNTRACE(8) NAME
isdntrace -- isdn4bsd ISDN protocol trace utility SYNOPSIS
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] DESCRIPTION
isdntrace is part of the isdn4bsd package and is used to provide the user with a mnemonic display of the layers 1, 2 and 3 protocol activi- ties 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 provid- ing S0 bus analyzer features. The isdntrace utility is only available for passive supported cards. Note All filenames, user specified or default, get a date and time stamp string added in the form -yymmdd-hhmmss: a hyphen, two digits year, month, day, a hyphen and two digits hour, minutes and seconds. Trace files no longer get overwritten. In case a new filename is needed within a second, the filename-generating mechanism sleeps one second. In case the program is sent a USR1 signal, a new user specified or default filename with a new date and time stamp 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 preceding 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 discriminator. (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 available 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 mode. 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 following 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.) isdntrace automatically detects the layer 3 protocol being used by looking at the Protocol Discriminator (see: Q.931/1993 pp. 53). FILES
/dev/isdntrc<n> The device file(s) used to get the trace messages for ISDN card unit <n> out of the kernel. EXAMPLES
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-yymmdd-hhmmss (where yymmdd and hhmmss are replaced by the current date and time values). SEE ALSO
isdnd(8) STANDARDS
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 AUTHORS
The isdntrace utility was written by Gary Jennejohn and Hellmuth Michaelis. This manual page was written by Hellmuth Michaelis <hm@kts.org>. BSD
February 13, 2000 BSD