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

 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, 52 guest(s) and 0 member(s) that are online.

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

  

isdnlog



DESCRIPTION

       Isdnlog gets information from your isdn card, decodes this
       information, and can do anything with it, such as logging,
       starting programs, and more. All options to isdnlog can be
       given as command line flags, or you  can  specify  a  file
       with options (recommended).


RESTRICTION

       Isdnlog only works with the HiSax isdn driver. Other cards
       with their own driver are not supported. Additionally  you
       need  to  enable d-channel logging (you can use "hisaxctrl
       <DriverId> 1 4" to do that, e.g. "hisaxctrl line0  1  4").
       Isdnlog  can  only  log outgoing calls that originate from
       your isdn card, and incoming  calls.  To  get  information
       about  outgoing  calls from other isdn devices (e.g. tele­
       phones), you need a second Teles isdn card,  with  crossed
       lines.  Such  a  card is not usable for communicating, but
       can log outgoing calls from any device  (see  dual  option
       below).


GENERAL OPTIONS

       -V     show version information and exit.

       -fFILE read  options from the config file FILE.  The first
              line should be "[options]". You may use blank lines
              and comments (starting with a #).  All config files
              for  isdnlog   have   the   format   described   in
              isdn.conf(5).   Debug  options must be given on the
              command line, they cannot be stored in a file.

       /dev/DEVICE
              isdnlog  will  read  from  this  device  and   from
              /dev/isdninfo.  You  should give /dev/isdnctrl0 for
              the first isdn card (or /dev/isdnctrl2 for the sec­
              ond).

              Isdnlog  has a replay mode for debugging, where you
              can simulate previous recorded events. In that case
              use "-" instead of a device.

       -Ax  amt="value"
              Set  digits  necessary to get an outside line, when
              connected through a PABX.   You  can  give  several
              codes padded with a ":" (e.g. -A0:80:81:82).

       -Bvbn     vbn="value"
              Set  the  provider preselection to the given value.
              More prefixes may be separated by a ":".
              Values are e.g. "010" for DE, "10" for AT,  "16:17"
              for NL, "9" for FR.

       -Rprefix  preselected="value"
              is used for both incoming and outgoing calls.
              Don't  use  this in combination with the -A option!
              This will confuse the system (and possibly you).

              Example: a PABX in Germany shows the number  of  an
              incoming  call  from  Hamburg  as "00040...".  When
              calling out to Hamburg,  it  shows  the  number  as
              "0040...".   This  means  that  on  incoming calls,
              three zeroes must be removed, and on outgoing calls
              two zeroes must be removed (the number must be nor­
              malized to be without any  leading  zeroes  in  the
              case  of  a  national number; international numbers
              must have one leading zero). So, in this case,  the
              option -03:2 would be correct.

       -ix  internS0="value"
              Telefon number shorter then value are considered to
              be internal numbers on your PABX.

       -o   other={yes|no}
              Normally "causes" (e.g. "non-selected  user  clear­
              ing") for other connected ISDN devices are not dis­
              played, only those which are related to the connec­
              tion will be shown. With this option the causes for
              the other devices are also displayed.

       -ux  ignoreRR="value"
              Ignore "housekeeping" frames.  x may be  1  (ignore
              RR=Receiver ready) or 2 (ignore EMP=Euracom Manage­
              ment Protokoll) frames.

       -Ux  ignoreCOLP="value"
              Ignore COLP/CLIP frames when value is 1 or greater.
              Value 0 is default, and tells isdnlog to not ignore
              COLP/CLIP frames.
              Sometimes the COLP number is a number in a  differ­
              ent  areacode  to  the number that was dialled, and
              then the cost calculation would be wrong.
              With value 2 the ignored COLP number is  displayed.

       -2x  dual="value"
              Enable  dual mode. You need this if you have a sec­
              ond isdn card attached with crossed lines so it can
              listen  to  what other isdn devices like telephones
              are doing. With x=2 you can increase the debug out­
              put - every single digit will be displayed.

              Some  setups  may  require workarounds for reliable
              logging.  These workarounds are enabled by addition
              of  the  following numbers to the dual value.  They
              are intended for the dualmode but may also be  use­
              ful without.  In this case, specify only the sum of
                     without a source number (own MSN).

              0x400  Enable this when unanswered  incoming  calls
                     are  logged multiple times (revealed by isd­
                     nrep -E).

       -1     A HFC-based card is used for echo mode. Enable echo
              mode for the HFC card with
              hisaxctrl id 10 1
              hisaxctrl id 12 1


DEBUG MODULE

       -r     Replay  a  debug file (e.g. /tmp/isdnctrl0) to find
              bugs. With this flag you  should  give  a  filename
              with the debug information instead of a device.  It
              will also work with files not  created  by  isdnlog
              (e.g.  "cat /dev/isdnctrl0").

       -n   newline={yes|no}
              Display  throughput messages on the same line (only
              useful with logging to stderr or a console device).

       -WX  width="value"
              Limit all messages to X characters per line.

       -vX  log=X
              Isdnlog  can  copy  all  information to /tmp/DEVICE
              (e.g. /tmp/isdnctrl0 if you  started  isdnlog  with
              /dev/isdnctrl0).  Choose  what  debugging  you want
              from the following list, add the corresponding num­
              bers together and use that for X:

              1      copy  all  "HEX:"  lines from the hisax isdn
                     device driver.
              2      copy  /dev/isdnctrl  output   (or   whatever
                     device you specified).
              4      copy /dev/isdninfo output
              8      copy transfer values ("ibyte","obyte").

              Isdnlog  will  close  and  reopen this file after a
              "kill -HUP".

       -s   flush={yes|no}
              Isdnlog will flush the debug file /tmp/DEVICE (e.g.
              /tmp/isdnctrl0) after each write access.

       -P   pipe={yes|no}
              Copy  the debug information to stdout. This way you
              can run isdnlog  as  the  source  of  a  pipe  like
              "isdnlog -P /dev/isdnctrl0 |prog ... ".

       -D   daemon={yes|no}


NUMBER REWRITE MODULE

       You can define aliases for  telephone  numbers  (see  cal­
       lerid.conf(5)  and  isdn.conf(5)  for  more  information).
       Isdnlog will compare all numbers to the list  of  aliases,
       and  when a match is found, the alias is displayed instead
       of the number.


LOG MODULE

       Isdnlog can log information via  syslog,  to  stdout,  and
       send  information  to  x11  clients. Calculate a code from
       these numbers by adding them, and  activate  logging  with
       -s,  -m  or -x. You can use normal numbers or hex numbers.
       Default is stderr mode -m, unless daemon mode is  enabled;
       then it's syslog mode -l.

       0x1    Errors

       0x2    Warnings

       0x4    Notice

       0x8    Log messages to /tmp/DEVICE (e.g. /tmp/isdnctrl0 if
              isdnlog is started with /dev/isdnctrl0)

       0x10   Show telephone numbers immediately.

       0x20   Show charge int  and  telephone  costs  with  every
              charge  signal (in Germany, and perhaps other coun­
              tries, you have to pay to get these signals).

       0x40   Show connect messages.

       0x80   Show hang up messages.

       0x100  Show cause message on hang up.

       0x200  Show time messages.

       0x400  Show throughput in bytes (every -wX seconds).

       0x800  Show state of B-channels (use with -M monitor).

       0x1000 Show service indicator.
              You should log  at  least  0x7  (errors,  warnings,
              notice) messages.

       0x2000 Log estimated time till next charge signal.

       0x4000 Show chargemax.

       0x8000 Enable core file on SIGSEGV.

       -C X      console="path"
              Log  to console X instead of stderr. You can use -O
              and -C together, so that isdnlog copies  output  to
              both.  Specify  a  full pathname.  Beware: you must
              put a space between -C and X !

       -M   monitor={yes|no}
              With this flag, isdnlog will  generate  output  for
              monitor programs like imon, imontty or isdnmon. You
              must also give -m with 0x800 enabled.

       -lX  syslog="value"
              Log to syslog. X is the log code. You  can  log  to
              syslog and to stdout at the same time.

       -xX  xisdn="value"
              Pass  information to x11 client. X is the log code.
              You can pass information to x11 clients and log  to
              syslog and/or stdout at the same time.

       -pPORT port="value"
              Pass information to x11 client on this PORT.

       -cX  calls="value"
              Only with -xX : save the last X calls and pass this
              information to an x11 client. Default value is 100.

       -LX  xlog="value"
              Only  with  -xX : save the last X messages and pass
              this information to an x11 client. Default value is
              500.

       -wX  thruput="value"
              If  you enabled throughput logging (0x400), isdnlog
              will log the throughput every X seconds.

       -Ix:y     ciinterval="value[:value]"
              Interval for printing of charge messages (0x20).
              The first value is the interval for the  calculated
              CI,  the  second value for the EH (AOC-D) messages.
              If only one value is given, both intervals are  set
              to this value.


LCR

       -dx  abclcr="value"
              Value is a bitmap:
              0 ... off
              1 ... calls to different area / country
              2 ... local calls too
              4 ... special numbers e.g. ISP
              This  needs  a  kernel patch to work. If the kernel


TIME MODULE

       -tX  time={0|1|2}
              Isdnlog will set your local system time to the time
              transmitted by your isdn service  provider:  -t1  =
              once, -t2 = every time.


CHARGEHUP MODULE

       -hX  hangup="value"
              The  isdn  kernel system has a chargehup system, so
              it will hang up  a  few  seconds  before  the  next
              charge  signal.  If  you  don't get a charge signal
              from your phone company, isdnlog can emulate it.

              On every outgoing connection, isdnlog  will  calcu­
              late  the charge time from day of week, time of day
              and the distance zone of the connection.

              The kernel needs to know how long the  charge  time
              is,  and  how  many  seconds before the next charge
              signal it should hang up. You have to set the  sec­
              ond  parameter  with  X  in  the form number:number
              (hang up seconds  before  next  charge  signal  for
              charge  times greater than or equal to 20 seconds :
              for charge times of less than 20 seconds).

              With this information, isdnlog will call  "isdnctrl
              chargeint  <device>  <charge  time>"  and "isdnctrl
              huptimeout <device> <seconds before charge signal>"
              (it actually communicates directly with isdn, with­
              out calling isdnctrl, but this would have the  same
              effect).

              You should run isdnlog with -t1 or better with -t2,
              so isdnlog sets the local time in sync  with  tele­
              phone switching office.

              If  there  is  a third number in value, this is the
              minimum connection time for  providers  charging  a
              basic rate per connection.
              e.g. hangup 3:5:60


START MODULE

       isdnlog  can  react  on any event and start programs. This
       feature is disabled unless you activate it with:

       -S   start={yes|no}
              active   "START"   feature.   Please   read    cal­
              lerid.conf(5) for more information.

       running. Look at /var/run for  a  file  isdnlog.DEVICE.pid
       with  the process id of isdnlog, and kill that. After that
       you should be able to unload your isdn kernel modules.


FILES

       /dev/DEVICE
              isdnlog requires a device as a  parameter  to  read
              from  (e.g.  /dev/isdnctrl0 for the 1st isdn card).

       /tmp/DEVICE
              isdnlog can copy everything it reads to  this  file
              as  debug  information  (e.g. /tmp/isdnctrl0 if you
              started isdnlog with /dev/isdnctrl0).

       /var/run/isdnlog.DEVICE.pid
              isdnlog creates this file with its process id. Use­
              ful to see if isdnlog is running.

       /var/lock/LCK..DEVICE
              isdnlog  creates  a lock file for the device, so no
              other processes will access that device.

       /etc/isdn/isdn.conf
              isdnlog config file.  Options  to  isdnlog  can  be
              given  on  the  command line, can be stored in this
              file  in  [options]  (with  command   line   option
              -f/etc/isdn/isdn.conf),  or  in  a different config
              file, but isdnlog will look at this file  for  sec­
              tions [global] [variables] [isdnlog].


SIGNALS

       SIGHUP (-1)
              On  SIGHUP  isdnlog  restarts,  and  does therefore
              reread it's config files.

       SIGINT (-2), SIGTERM (-15), SIGQUIT (-3)
              Isdnlog quits gracefully on receiving these  termi­
              nation signals.

       SIGSEGV (-11)
              If  the log level contains 0x8000 (and your ulimits
              permit this)  isdlog  will  generate  a  core  file
              before terminating.


EXAMPLE

       I   start   isdnlog  with  "isdnlog  -f/etc/isdn/isdn.conf
       /dev/isdnctrl0".  This file contains a [options] section:

       [options]
       #newline=no     # show all throughput messages in one line.
       #width=80       # limit log messages to 80 characters per line
       #amt=0:80:81    # digits to get a line through your PABX
       #hangup=        # simulate charge signals
       start=yes       # enable starting programs


SEE ALSO

       isdnconf(1) isdn.conf(5) callerid.conf(5)
       isdnlog(5) isdnrep(1) rate-files(5) isdnrate(1)


AUTHOR

       This  manual  page  was  written  by  Andreas  Jellinghaus
       <aj@dungeon.inka.de>, for Debian GNU/Linux and isdn4linux,
       updated by Leopold Toetsch <lt@toetsch.at>.

ISDN 4 Linux 3.3            2003/08/14                 isdnlog(8)
  
Help us cut cost by not downloading the whole site!
Use of automated download sofware ("harvesters") such as wget, httrack, etc. causes the site to quickly exceed its bandwidth limitation and therefore is expressedly prohibited. For more details on this, take a look here

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