Provided by: linesrv-mysql_2.1.21-2ubuntu1_i386 bug

NAME

       linesrv.conf - Linesrv configuration file

DESCRIPTION

       This linesrv.conf configuration file is read by the Linesrv daemon upon
       starting. In this file  it  is  possible  to  specify  all  the  daemon
       properties  such  as  binding  address,  start  and  stop  command  for
       connection.  This manual page was  written  for  the  Debian  GNU/Linux
       distribution  because the original program does not have a manual page.

       linesrv is a program that...

GENERAL OPTIONS

       The different configuration options are:

       bind_to <ip addres>
              the IP the server is listening on (currently only one ip).

       port <port>
              Used to specify the port used to listen to clients. The port may
              be specified as a number.UDP port 16007 is default.

       user_accounting <yes|no>
              If  set  to  .Iyes  only LCP3 (LineControl Protocol 3.x) clients
              will have access.  You can  control  user  access  via  the  PAM
              system.  See /etc/pam.d/linecontrol and /etc/pam.d/lcshutdown to
              know how limit access

       pidfile <filename>
              This file contains the linesrver pid. This file is never removed
              when  shutting  down the server, but is always over-written when
              the server restart.

LOGGING

       Linesrv let you to log connection time on per-user base, per-line base,
       and  let  you  to  calculate the costs. Furthermore the server logs the
       same without IP when the connection gets closed (either by ’server’  or
       ’manually’)  remember  that  multiple clients can use the connection at
       the same time. So the sum of the secs of the clients is not the one  of
       the  ’line  ...’  entries! (evidentelly... :) You can access the log by
       means of cgi-bin lclog or by inserting logs into a mysql db.   You  can
       find   an   example   dump  for  the  db  in  /usr/share/linesrv/mysql-
       linesrv.dump. To read the db you can use a php tool  you  can  find  in
       lclog-mysql. These scritps don’t come with this package.

       logfile <filename>
              With  this  option  you  can specify the file from the logparser
              read from.  The  default  is  /var/log/linesrv/dialsrv.log  With
              ’logfile’ you can log the ip, from time, to time and the seconds
              a client used the connection. You can  parse  the  logfile  with
              lclog, by pointing your web browser to http://<server-name>/cgi-
              bin/lclog

       db_host <servername>
              Specify host on which the db is located

       db_port <port>
              Mysql connection port. The default il 3306

       db_user
              The username for accessing the database

       db_passwd
              The passwd for db_user

       db_name
              db_name

       html_status <pipename>
              This is a new feature in version 2.1.0.  linesrv has to be  able
              to  write/read  to/from  that named pipe utility with htmlstatus
              which you can find in /usr/lib/cgi-bin/htmlstatus can read  from
              that  pipe.  Attention:  htmlstatus  has to be run with the same
              user id set as the linesrv process so it can send a  SIGUSR1  to
              linesrv.  It  could  be  ran  as  root.   htmlstatus  will  read
              /etc/linesrv/linesrv.conf (compiled in for security reasons) and
              then  look  for  the  two keywords ’pid_file’ and ’html_status’.
              Without these it won’t work.

FILTERS

       with filters you may decide whether a certain client may use dialsrv or
       not.   if  filter_type is allow, all clients in the list have access to
       the server, others don’t. If it’s deny, all but those in the list  have
       access.   Remember  that UDP/IP is extremely easy to spoof. Use Clients
       without user accounting only on a trusted subnet and block  the  ’port’
       at your firewall.

       filter_type allow
              The only option is allow. For the moment it cannot not be used

       filter_mask <ip> <bit-mask>

       filter_ip <from> <to>
              This options defines a netmask or a range of ip numbers that can
              connect to the server. It is possible  to  use  more  than  once
              these keyword.

       script_shutdown <filename>
              Linesrv has a nice feature that permits to shutdown remotely the
              box  running  it.  It  can  be  made  by   using   the   keyword
              script_shutdown.  This keyword does not support command line, so
              you can use a wrapper found in /usr/sbin/halt-wrapper.

       limit_shutdown_ip <from> <to>

       limit_shutdown_mask <ip> <bit-mask>
              LineControl does also  support  TCP  connections.  They’re  much
              harder to spoof... but some bad boy can just take your own IP...
              You don’t have to use filter_type or so again. The type  of  the
              shutdown-filter  is  always ’allow’. Only listed IPs are allowed
              to execute the script. The host has  to  pass  the  by  filter_*
              specified  list.  So this list is additional and doesn’t replace
              the other one.

LINE CONFIGURATION

       With Linesrv you can configure several modem (or isdn) connection  with
       several  ISP. Every connection is know as "Line". Each Line has his own
       section.

       line <name>
              Define the start of Line <name>.

       interface <interface>
              specifies  the  network  interface  to  watch  to  generate  the
              throughput messages.

       con_type <netdev|isdn|file>
              How  can  we  determine  the status of the connection (only up /
              down).  working with pppd. The network device (ex.  ppp0)  tells
              us  about  the  connection status. If it’s up, the connection is
              considered as up. If not, we believe that  the  con  is  closed.
              scans  /dev/isdninfo  for  the  connection  status.  You have to
              supply some more information about your isdn conf.   see  below.
              file  exists  the  connection is considered as established.  Let
              your script delete it after  it  closed  the  connection.   This
              should  be  useful  for people with a cablemodem. The problem is
              that you will get bad throughput messages  if  not  all  of  the
              traffic goes through the ’interface’ you specified. Probably you
              will specify ’eth0’ as a dummy...  because you have  to  specify
              an interface.

       script_up <script_up>

       script_dn <script_dn>
              These  directive  shows  the  scripts  that  are used to get the
              interface up and down.

       allow_manually yes
              allow_manually defines whether linesrv should close a connection
              that  got established without that linesrv called the script_up.
              So if you have for example a cron job which checks for a running
              linesrv,  you can say "allow_manually no". This way linesrv will
              close a line that it left open before a crash. So the line  gets
              closed  when linesrv gets restarted.  attention: if you have two
              lines with the same con_type and the same thing  that  tells  us
              whether  a  line is up or down linesrv will consider one line as
              established  by  the  server  and  the  other  one   established
              manually. In this case you HAVE TO SET "allow_manually yes".  If
              not, linesrv won’t work well (it’s a bug.).

       script_esc <script_off>
              after ’con_timeout’ seconds This  script  should  establish  the
              basic constellation so we can call script_up again.

       con_status_file <file>
              If  you  selected cont_type_file your up/dn scripts will have to
              create/remove this file. Change the filename to suit your needs.
              It doesn disturb as long as you’re not using ’con_type file’.

       con_timeout <secs>
              set  con_timeout to something like 15 if you’re using isdn after
              #  secs,  the  connection-establishment  gets  abortet  if   the
              connection didn’t get established.

       send_throughput yes
              DON’T  set  the  following  to  ’no’!  (Your  clients  won’t run
              well...)  probably  this  keyword  will  disapear  in  a  coming
              version.

SEE ALSO

       linesrv.conf(1)

AUTHOR

       This  manual  page was written by Marco Presi <mpresi@lugroma.org>, for
       the Debian GNU/Linux system (but may be used by others).

                               January  12, 2002               LINESRV.CONF(5)