usr.sbin/isdn/isdnd/isdnd.acct.5

   1 .\" $NetBSD: isdnd.acct.5,v 1.3 2002/01/19 03:17:08 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1997, 1999 Hellmuth Michaelis. All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\"
  14 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24 .\" SUCH DAMAGE.
  25 .\"
  26 .\"     $Id: isdnd.acct.5,v 1.4 2003/06/27 19:09:02 wiz Exp $
  27 .\"
  28 .\" $FreeBSD$
  29 .\"
  30 .\"     last edit-date: [Mon Dec 13 22:58:12 1999]
  31 .\"
  32 .Dd September 11, 1998
  33 .Dt ISDND.ACCT 5
  34 .Os
  35 .Sh NAME
  36 .Nm isdnd.acct
  37 .Nd isdn4bsd ISDN management daemon accounting file format
  38 .Sh DESCRIPTION
  39 The file
  40 .Pa isdnd.acct
  41 contains accounting information which is written if the variable
  42 .Em useacctfile
  43 in the
  44 .Xr isdnd 8
  45 configuration file
  46 .Xr isdnd.rc 5
  47 is set to
  48 .Em on
  49 and charging information transmission has been subscribed for the
  50 ISDN connection (AOCD or AOCE).
  51 .Pp
  52 If the variable
  53 .Em acctall
  54 is set to
  55 .Em on ,
  56 accounting information is written even if the local site was not charged
  57 or no charging information is available or is not subscribed.
  58 .Pp
  59 The general format of an accounting line is as follows:
  60 .Pp
  61 .Dl FROM - UNTIL NAME UNITS (SECONDS) (INBYTES/OUTBYTES)
  62 .Pp
  63 .Em FROM
  64 is the time the connection was established in the format
  65 .Dl Day.Month.Year Hour:Minutes:seconds
  66 .Pp
  67 .Em UNTIL
  68 is the time the connection was closed.
  69 The format is the same as
  70 described for
  71 .Em FROM
  72 above.
  73 .Pp
  74 .Em NAME
  75 is the symbolic name got from the
  76 .Em name
  77 entry of the
  78 .Xr isdnd.rc 5
  79 config file for this connection.
  80 .Pp
  81 .Em UNITS
  82 is the amount of charging units billed for the connection.
  83 .Pp
  84 .Em SECONDS
  85 is the number of seconds the connection lasted.
  86 .Pp
  87 .Em INBYTES
  88 and
  89 .Em OUTBYTES
  90 is the (optional) number of bytes that were transferred.
  91 .Sh FILES
  92 .Bl -tag -width /var/log/isdnd.acct -compact
  93 .It Pa /var/log/isdnd.acct
  94 The default accounting information file for the
  95 .Nm isdnd
  96 ISDN daemon.
  97 .El
  98 .Sh EXAMPLES
  99 This is a typical accounting line:
 100 .Pp
 101 .Dl 12.06.97 10:41:37 - 12.06.97 10:45:18 GROGGY 2 (65) (4711/1147)
 102 .Sh SEE ALSO
 103 .Xr isdnd.rc 5 ,
 104 .Xr isdnd 8
 105 .Sh AUTHORS
 106 The
 107 .Xr isdnd 8
 108 daemon and this manual page were written by
 109 .An Hellmuth Michaelis Aq hm@kts.org .