Welcome to Linux Knowledge Base and Tutorial
"The place where you learn linux"

 Create an AccountHome | Submit News | Your Account  

Tutorial Menu
Linux Tutorial Home
Table of Contents

· Introduction to Operating Systems
· Linux Basics
· Working with the System
· Shells and Utilities
· Editing Files
· Basic Administration
· The Operating System
· The X Windowing System
· The Computer Itself
· Networking
· System Monitoring
· Solving Problems
· Security
· Installing and Upgrading
· Linux and Windows

Glossary
MoreInfo
Man Pages
Linux Topics
Test Your Knowledge

Site Menu
Site Map
FAQ
Copyright Info
Terms of Use
Privacy Info
Disclaimer
WorkBoard
Thanks
Donations
Advertising
Masthead / Impressum
Your Account

Communication
Feedback
Forums
Private Messages
Surveys

Features
HOWTOs
News Archive
Submit News
Topics
User Articles
Web Links

Google
Google


The Web
linux-tutorial.info

Who's Online
There are currently, 189 guest(s) and 0 member(s) that are online.

You are an Anonymous user. You can register for free by clicking here

  

isdnrep



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 sum­
              maries 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 out­
              put 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  config­
              ured  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:

              time-time display from begin time up to end time
              time-     display from given time up to "now"
              -time     display  from beginning of log file up to
                        given time
              time      display the given month, day, hour, ...

       -d -time  delete="time"
              Delete entries from the log file  up  to  (but  not

       -v   verbose
              Display warnings on startup.

       -p [n][m]'number'[,[m]'number'...] phonenumber
              Display only selected phone numbers.

              "number" is specified in the same format as in con­
              figuration 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.

       -i   incoming
              Only incoming connections are displayed.

       -o   outgoing
              Only outgoing connections are displayed.

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

       -wX  WWW
              isdnrep can give its output in HTML format; this is
              switched on with this option. Two modes are  possi­
              ble:

              0      The HTML header is suppressed. Useful if the
                     output is to be included  into  an  existing
                     page.
              1      A complete HTML page is generated.

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

              %X  time without date
                  e.g. 23:54:06
              %x  the date
                  e.g. 25/07/97

              %xL the  town  corresponding  to  the  local MSN if
                  known; an empty string otherwise
              %xl the town corresponding to the remote number  if
                  known; an empty string otherwise
              %T  an  arrow  indicating the direction of the con­
                  nection ("->" outgoing or "<-"  incoming);  the
                  local  MSN should be displayed on the left side
                  of this.
              %t  an arrow indicating the direction of  the  con­
                  nection, reversed ("<-" outgoing or "->" incom­
                  ing); the local MSN should be displayed on  the
                  right side of this.
              %xu the charge units, if known
                  e.g. 6 EH
              %U  the cost, if known
                  e.g. 2,28 DM
              %I  amount of INPUT data
              %O  amount of OUTPUT data
              %P  INPUT throughput (bps)
              %p  OUTPUT throughput (bps)
              %S  Service Indicator
              %G  displays  a HTTP link to the corresponding fax,
                  when a fax was received by mgetty. This fax can
                  be  displayed  by  using  the  link  in  a HTTP
                  browser.
                  This option is only valid when used  with  -wx,
                  see below for more information.
              %C  displays a HTTP link to the corresponding voice
                  file, when a call was recorded by  vbox.   This
                  option  is  only  valid when used with -wx, see
                  below for more information.

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

                  "  %X %D %15.15H %T %-15.15F %7u %U %I %O"

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

                  "%X%D %10.10H%T%-14.14F%U%I %O"

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

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

       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  con­
       figured  in  the browser. Alternatively, a conversion pro­
       gram 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, isd­
       nrep 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

               type=audio/x-wav    \
               desc="auWAV Audio"  \
               exts="wav"

           ~/.mailcap
               audio/x-wav;/usr/bin/auplay %s

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

       Now,  when  the  browser is started, it will recognize WAV
       files and start the corresponding program to handle these.
       The  WAV format has been chosen as this 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 ansering 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:

           ~/.mime.types
               type=application/x-faxg3  \
               desc="G3-Fax Format"      \
               exts="fax,g3"

           ~/.mailcap
               pplication/x-faxg3;/usr/X11/bin/g3view %s

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

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


           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  clar­
       ity):

   $ 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*
   ======================================================================

   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
         (1) "xxx  <-  xxx" was an incoming call, so doesn't cost
             anything
         (2) "xxx -> xxx" was an outgoing call lasting  203  sec­
             onds,  so for City zone, off-peak time (Saturday), 3
             charge units = DM 0,36
         (3) there was no connection, as  the  called  party  was
             busy
         (4) there  was no connection, as the called party didn't
             pick up the phone
         (5) "the number you have dialled is not connected.  Hang
             up and dial again. ..."
         (6) total time for incoming calls
         (7) total time for outgoing calls
         (8) 3 calls failed; busy (3), no answer (4) and error in
             dialing (5)
         (9) total charge units incurred for one day
        (10) total costs incurred for one day
        (11) outgoing calls grouped per number
        (12) incoming calls grouped per number
        (13) outgoing and incoming calls grouped per tariff zone

       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]
              specifes the month or day.

              Examples:

              7/        July of the current year
              8/1996    August 1996
              29/6/95   June 29th 1995
              6/6/      error,  is  not  June  6th of the current
                        year; it's June 1906

       [D]D   day of current month

       [MM]DD[hhmm[[CC]YY][.ss]]
              specifies an  exact  time.  Unspecified  parts  are
              defined  as 0 when interpreted as a begin time, and
                     12th of the current year at 19:95,  so  it's
                     garbage.

              Examples of time spans and their meaning:

              6/95-081214381996.25
                     all  entries  between June 1st 1995 00:00:00
                     and August 12th 14:38:25
              0912030495.20-12/95
                     all  entries  between  September  12th  1995
                     03:04:20 and December 31st 1995 23:59:59
              7/95   all  entries  between July 1st 1995 00:00:00
                     and July 31st 1995 23:59:59
              0908   all entries between  September  8th  in  the
                     current  year  00:00:00 and September 8th in
                     the current year 23:59:59
              3      third day of the current month


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)


AUTHOR

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

ISDN 4 Linux 3.3            2000/11/06                 isdnrep(1)
  




Login
Nickname

Password

Security Code
Security Code
Type Security Code


Don't have an account yet? You can create one. As a registered user you have some advantages like theme manager, comments configuration and post comments with your name.

Help if you can!


Amazon Wish List

Did You Know?
You can get all the latest Site and Linux news by checking out our news page.


Friends



Tell a Friend About Us

Bookmark and Share



Web site powered by PHP-Nuke

Is this information useful? At the very least you can help by spreading the word to your favorite newsgroups, mailing lists and forums.
All logos and trademarks in this site are property of their respective owner. The comments are property of their posters. Articles are the property of their respective owners. Unless otherwise stated in the body of the article, article content (C) 1994-2013 by James Mohr. All rights reserved. The stylized page/paper, as well as the terms "The Linux Tutorial", "The Linux Server Tutorial", "The Linux Knowledge Base and Tutorial" and "The place where you learn Linux" are service marks of James Mohr. All rights reserved.
The Linux Knowledge Base and Tutorial may contain links to sites on the Internet, which are owned and operated by third parties. The Linux Tutorial is not responsible for the content of any such third-party site. By viewing/utilizing this web site, you have agreed to our disclaimer, terms of use and privacy policy. Use of automated download software ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and are therefore expressly prohibited. For more details on this, take a look here

PHP-Nuke Copyright © 2004 by Francisco Burzi. This is free software, and you may redistribute it under the GPL. PHP-Nuke comes with absolutely no warranty, for details, see the license.
Page Generation: 0.09 Seconds