NAME¶

isdnrep - report ISDN activity

DESCRIPTION¶

Isdnrep reads the isdnlog log files, generates reports, does statistics, and other things. It can also generate HTML output for use with a web server.

OPTIONS¶

-V

show version information and exit.

-a all

Show all connections registered. If this option is not given, show only the connections made today.

-S Summary

Show a summary (no individual calls) for selected date range. If this option is given twice, the summaries per day are hidden too. Don't use with -h

-h no header

There will be no header for each day, nor will the summary at the end of each day and at the end of the report be generated. This is useful if the output is to be processed by another program.

This option doesn't work if the -wX is also given.

-n numbers

Display numbers instead of the aliases for those numbers.

-fFILE

The file from which to generate the report. This is usually /var/log/isdn.log, or whatever is configured in /etc/isdn/isdn.conf as LOGFILE = . The -f option will override the setting in /etc/isdn/isdn.conf.

-t time span time="time span"

With this option a specific time span covered by the log file can be displayed, e.g. all calls in November 1995, or on January 3rd 1996 between 03:00 and 09:45.

The format in which times are given is described below. The time span has the following syntax:

-d -time delete="time"

Delete entries from the log file up to (but not including) the specified time. The format is the same as for the -t option. The minus before the time must be given! It is not possible to define begin and end times; entries are always deleted from the beginning up to the time given.

Warning! Entries are really deleted from the file. Careless use can result in all entries being deleted, e.g. with "isdnrep -d -".

-E print Errors

Display all connections and connection attempts. Without this option, only successful connections are displayed.

-v verbose

Display warnings on start-up.

-c ignore default options

Do not append the "REPOPTIONS" setting from /etc/isdn/isdn.conf to the command line.

-p [n][m]'number'[,[m]'number'...] phonenumber

Display only selected phone numbers.

"number" is specified in the same format as in configuration files (see isdn.conf(5)). E.g. wildcards can be used.

If the flag 'm' is given, the corresponding MSN is meant. E.g.: "m2" means MSN#2. If "m0" is given, all numbers are to be displayed.

If the flag 'n' is given, the given number is not to be displayed.

-U [_][.]'number' default source number

Use 'number' as source number for outgoing calls with an unknown source number ("?"). '.' is replaced by country and area code from isdn.conf.

With '_' the default source number is used internally (e.g. for fetching the right zone names from the ratefile) but it is not displayed.

-i incoming

Only incoming connections are displayed.

-o outgoing

Only outgoing connections are displayed.

-xX include/exclude calls

Select calls by day and/or hour. The following selections are possible and can specified in any combination and quantity using : as separator:

daylist and timelist have the same syntax as described in rate-files(5). If a day or an hour is included and excluded it will be excluded.

Example:

This will display all calls on Tuesdays, Wednesdays, or Thursdays that are not holidays with a start time between 09:00 and 12:00 or 15:00 and 17:00.

-u unknown caller

At the end of the report, all numbers not aliased in callerid.conf or ~/.isdn are displayed. This option is unavailable when HTML output is requested.

-LX summary lists

Select the summaries in the footer by any combination of the following letters:

Upper case letters deselect, lower case letters select a summary. With at least one lower case letter, only the selected summaries are shown, as long as they are not also deselected. -LiI for example will show no summary at all. Per default all summaries are displayed.

-rPROV recompute

Recompute the connection fees with the current ratefile instead of showing the amounts stored in the logfile as usual. The provider PROV for recomputation is selected in one of the following ways:

-m[*|/]number modify call costs

Multiply (*) or divide (/) the stored or recalculated call costs by number before displaying them. If neither * nor / is given, multiply.

-wX WWW

isdnrep can give its output in HTML format; this is switched on with this option. Two modes are possible:

-sX format string

The output generated by isdnrep can be modified by specifying the format of the line generated for each connection. The syntax is similar to that used by printf. The following parameters are possible (the x where given means that a width for the field, also known as the precision, must be given):

The default format string for (non-HTML output) is

With the following string all the important data is displayed while keeping the total length to 80:

The above string is put into isdn.conf at installation as REPFMTSHORT and can be used with -Fshort.

Without showing the transferred bytes, this string also fits into 80 chars:

It is included as REPFMTNIO.

-FX format

format strings can be specified in isdn.conf; this option is used to select one of these. Entries can be defined in the section [ISDNLOG] with names beginning with "REPFMT". The string after the -F option is added to REPFMT to find the correct entry. Case is not sensitive. E.g.:

REPFMT1        = ... # -> isdnrep -F1
REPFMTMYSTRING = ... # -> isdnrep -Fmystring or


                          isdnrep -F MYSTRING

HTML USE¶

isdnrep can generate a HTML page containing links to files generated by vbox and mgetty (faxes), so that the messages and faxes can be heard or seen from within a browser. However, a couple of things need to be configured first.

answering machine messages

The %C can be used in the isdnrep output format to make a link to a voice recording file. For this to work, the following entry is needed in the [ISDNLOG] section in isdn.conf:

    VBOXPATH= /var/spool/vbox/fred/incoming # incoming directory pathname

Now isdnrep can find the file correctly. Clicking on this link will cause the file to be sent. These files are in ZyXEL format; the browser cannot use these directly. The type is given by isdnrep as follows:

    Content-Type: application/x-zyxel4

The correct application (helper) for this has to be configured in the browser. Alternatively, a conversion program can be specified to isdnrep which will convert the ZyXEL format. The pathname of the file to convert is given as a parameter to the program.

In the [ISDNLOG] section of isdn.conf an entry as follows specifies which conversion program to use:

    VBOXCMD1 = /usr/bin/program1
for versions 0.x and 1.x of vbox, and


    VBOXCMD2 = /usr/bin/program2

for versions 2.x of vbox. Both entries can be given, isdnrep recognizes which version created the recording.

The program must first output a line with the content-type, followed by the data itself. To convert the ZyXEL format into a WAV file, the following script may be used:

#! /bin/sh
##
## script to play voice messages from vbox-2.0
##
## WARNING! If the paths are not set correctly,
## netscape may simply crash!
PATH=$PATH:"path to sox":"path to pvftools":"path to vbox"
FILENAME1=/tmp/voxplay.$$.voc
FILENAME2=/tmp/voxplay.$$.wav
VOLUME=8
vboxtoau <$1             | \


          autopvf        | \


          pvfamp $VOLUME | \


          pvfcut 0.20    | \


                pvftovoc > $FILENAME1
sox $FILENAME1 $FILENAME2
echo Content-Type: audio/x-wav
echo
cat $FILENAME2
rm -f $FILENAME1 $FILENAME2

The NAS (Network Audio System) package may be needed.

Now, when the browser is started, it will recognize WAV files and start the corresponding program to handle them. The WAV format has been chosen as it can also be played from a Windows PC.

faxes received by mgetty

When %G is used in the isdnrep output format, any faxes received by mgetty will be accessible via a HTML link, in the same manner as the answering machine messages.

For the faxes the following entry in the [ISDNLOG] section in isdn.conf is needed:

    MGETTYPATH = /var/spool/fax/incoming

WARNING: if isdnrep doesn't have permission to read the files, they will not be displayed; there will be no error message.

When isdnrep passes these files back to the browser, they have the G3 format. The following header is used to notify the browser of this:

    Content-Type: application/x-faxg3

As the browser probably doesn't understand this format, the following changes to the files listed are needed:

The program g3view has to be installed for this to work.

If now the link is clicked on, the browser will automatically start the external g3view to handle this data.

If you prefer another format (instead of G3) such as JPEG, the format has to be converted. The following entry in the [ISDNLOG] section of isdn.conf takes care of this:

VBOXCMD = /usr/bin/g3tojpeg # example

The script g3tojpeg can be something like this:

#! /bin/sh
##
## command to display faxes in a browser
##
## WARNING! If the paths are not set correctly,
## netscape may simply crash!
export PATH=$PATH:"path to g3topbm":"path to convert"
echo Content-Type: image/jpeg
echo
g3topbm < $1 | convert pbm:- jpeg:-

The packages ImageMagick and mgetty are needed. Mgetty is probably already installed if you want to use this feature :-)

The advantage of the JPEG format is that it can also be displayed by a browser running on a Windows PC.

summary

A suitable value for REPFMTWWW is

    REPFMTWWW = "%X %D %17.17H %T %-17.17F %-20.20l SI: %S %9u %U %I %O %G %C"

Netscape 3.0 Gold and Arena have been tested, and both work fine with isdnrep's HTML output, although Arena's display is not as colourful as Netscape's.

A known problem (which is impossible to solve completely) is determining the relationship between an isdn connection and a fax or vbox recording. Unfortunately the times for isdnrep, mgetty and vbox differ. Isdnrep tries to make the best guess, but it's always possible that e.g. a fax is connected to the wrong isdn connection.

EXAMPLE OUTPUT¶

With the default configuration the following output can be generated on stdout (whitespace slightly edited for clarity):

$ isdnrep -v -t 6/1/96
I S D N  Connection Report  -  Tue Aug 26 22:21:19 1997
Sat Jan  6 1996


  00:54:19                 UNKNOWN -> UNKNOWN     No user responding      (4)
[...]


  16:33:24  0:03:23        UNKNOWN -> UNKNOWN        7 EH      0,84 DM


  17:33:47                 UNKNOWN -> UNKNOWN     Unallocated (unassigned)(5)


                                                  number


  20:02:28  0:02:37     Phone/HDLC <- UNKNOWN                             (1)


  20:09:53  0:07:01     Modem/X.75 -> T-Online       3 EH      0,36 DM    (2)


  21:27:56                 UNKNOWN -> UNKNOWN     User busy               (3)


  22:09:41  0:29:36        UNKNOWN -> UNKNOWN       43 EH      9,89 DM*
======================================================================


  1 IN= 0:02:37,  13 OUT= 3:40:14,   3 failed      210 EH     25,20 DM
(6)^^^^^^^^^^^^  (7)^^^^^^^^^^^^^  (8)^^^^^^^   (9)^^^^^^ (10)^^^^^^^^
DIALOUT Summary for Sat Jan  6 1996                                      (11)
-----------------------------------------------------------
T-Online         1 call(s)  0:07:01     3 EH    0,36 DM
UNKNOWN         11 call(s)  0:17:00    20 EH    2,40 DM
DIALIN Summary for Sat Jan  6 1996                                       (12)
-----------------------------------------------------------
UNKNOWN          1 call(s)  0:02:37
Zone 1 : City              2 call(s)  2:23:13     50 EH    6,00 DM       (13)
Zone x : UNKNOWN          11 call(s)  0:17:00     20 EH    2,40 DM

Notes

If the charge units are marked with "*", the PTT switch did not give charge info; these are the number of units guestimated by isdnrep.

TIME FORMAT¶

For the -d and -t options, the time is specified in the following formats:

[DD/][M]M/[[YY]YY]

specifies the month or day.

Examples:

[D]D

day of current month

[D]D.[M]M.[[[CC]Y]Y]

specifies a day. If century or year and century are missing, they will be taken from the current date.

Examples:

[MM]DD[hhmm[[CC]YY][.ss]]

specifies an exact time. Unspecified parts are defined as 0 when interpreted as a begin time, and 23 or 59 when interpreted as an end time.

If a year is to be specified, the hours and minutes must also be specified.

The format is copied from the date command.

Examples:

[CC]YY-MM-DDThh:mm:ss

specifies a year, a moment, or something between. Each separator ´-', 'T', and ':' can be omitted or not. If the first '-' is missing, the century must be given.

This notation cannot be combined with the above notations. Time spans are noted with '--' instead of '-'. If no '--' is given, ´i' must be noted after the -t option.

Examples:

"y"

yesterday,

"yy"

the day before yesterday,

"yyy"

three days ago and so on. For time spans these can also be used in conjunction with the notations explained above.

FILES¶

/var/log/isdn.log or /var/lib/isdn/calls

isdnlog log file with information about all calls.

/etc/isdn/isdn.conf

general configuration

/etc/isdn/callerid.conf

aliases for telephone numbers

SEE ALSO¶

isdnlog(5) isdnlog(8) isdn.conf(5)

AUTHOR¶

This manual page was adapted from isdnlog/README by Paul Slootman <paul@isdn4linux.de>, for Debian GNU/Linux and isdn4linux.