bionic (5) isdnlog.users.5.gz

Provided by: isdnlog_3.25+dfsg1-9ubuntu2_amd64 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.