Provided by: isdnlog_3.12.20071127-0ubuntu11_i386 bug

NAME

       /etc/isdn/isdnlog.users - user base isdnlog config file

DESCRIPTION

       This  file  is  only  needed  if  isdnlog  is  started with the "-xX" /
       "xisdn=" option. If this file does not exist,  isdnlog  will  create  a
       default  file and print a warning. This file contains information about
       which users are permitted  to  use  isdnlog  clients,  and  what  their
       privileges  are.   This  file  is  checked  every  time a connection to
       isdnlog is made; thus, it is possible to edit this file  and  have  the
       changes effective immediately without having to stop and start isdnlog.

       For  now  there  are  no  real usable clients for isdnlog, so this file
       isn't very useful at the moment.

FORMAT

       Warning: the format of this file may change in the future.

       Blank lines are ignored. If a line has a "#", this char and the rest of
       the  line is ignored as comment. If the last char of a line is a " line
       and the next line  are  considered  one  line.   These  characters  are
       considered special: "$@#,;

       The  file  consists of lines; each line begins with the name of a user.
       After the user's name the privileges given to this user  are  specified
       (on the same line). The following privileges are possible, separated by
       semicolons ";" :

       ALL All of the privileges below are given.  Should  only  be  given  to
           root.

       MSN=msn[,msn...]
           Only  information  about  events  concerning  the specified msns is
           given.  This includes incoming and  outgoing  calls,  and  protocol
           information.   Any  number of msns may be given. Wildcards (such as
           used in  isdn.conf)  are  permitted.  With  "MSN=*"  all  msns  are
           allowed.
           Unknown  numbers  (e.g. from outgoing calls from other isdn devices
           or incoming calls from analog connections) cannot be specified with
           MSN=.   The  only  way to allow these calls to be seen is by giving
           "MSN=*".

       PROTOCOL
           The  information  specified  to  isdnlog  by  the  -xX  flag   (see
           isdnlog(8)) is allowed.

       I4LCONF (planned)
           This  gives permission to change isdn4linux properties. This should
           only be allowed to root.

       ADDRESSBOOK (planned)
           This makes it possible to retrieve  /  store  information  about  a
           caller or called number.

       Users
       At  the  beginning  of  the  file  it is possible to specify users with
       hostnames:

           fred@vom.jupiter MSN=4711?
           root@host1.at.home ALL

       Here the user  "fred"  can  only  connect  to  isdnlog  from  the  host
       "vom.jupiter".  Similarly, the user "root" is only allowed when on host
       "host1.at.home".

       Groups
       After the lines with hostnames, it is  possible  to  define  groups  of
       users  and  hostnames.  A  group  looks  like a section as described in
       isdn.conf(5). It begins with a line such as:

           [My_Group]

       and ends with the beginning of the next group or the end of  the  file.
       Group  names  are  not  case  sensitive.  In  fact, group names are not
       actually used (except for [world], see below).

       In a group, lines consist of a username or a  hostname.  Lines  with  a
       username  must  also  contain  those  privileges that the user has.  No
       privileges can be listed with a hostname.

           heinz MSN=*;PROTOCOL
           @host1
           @host2
           otto MSN=47111,47112
           @host3

       The above example allows the users heinz and otto to connect  from  any
       of the hosts host1, host2 and host3. The user heinz can see information
       about all msns, user otto can only see information about msns 47111 and
       47112.

       If  anyone is allowed to do anything, then it is enough to put only the
       following line into the file "isdnlog.users":

           [world]

FILES

       /etc/isdn/isdnlog.users
              This file.

SEE ALSO

       isdnlog(1)

AUTHOR

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