linesrv.conf - Linesrv configuration file

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...

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.

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.

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.

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.

linesrv.conf(1)

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