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.