linesrv.conf(5)

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 pro

gram 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/lcshut

down 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 ex

ample 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 ex

tremely 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 gener

ate 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 con

nection 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 traf

fic goes through the 'interface' you specified. Probably you will

specify 'eth0' as a dummy... because you have to specify an in

terface.

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 es

tablish 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 us

ing 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 com

ing version.

SEE ALSO

linesrv.conf(1)

AUTHOR

This manual page was written by Marco Presi <mpresi@lugro

ma.org>, for the Debian GNU/Linux system (but may be used by oth

ers).

January 12, 2002

LINESRV.CONF(5)