lyskomd.8

<.\" $Id: lyskomd.8,v 1.6 1991/10/29 05:41:58 linus Exp $
.\" Copyright (C) 1991  Lysator Academic Computer Association.
.\"
.\" This file is part of the LysKOM server.
.\" 
.\" LysKOM is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by 
.\" the Free Software Foundation; either version 1, or (at your option) 
.\" any later version.
.\" 
.\" LysKOM is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\" 
.\" You should have received a copy of the GNU General Public License
.\" along with LysKOM; see the file COPYING.  If not, write to
.\" Lysator, c/o ISY, Linkoping University, S-581 83 Linkoping, SWEDEN,
.\" or the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, 
.\" MA 02139, USA.
.\"
.\" Please mail bug reports to bug-lyskom@lysator.liu.se. 
.\"
.\" $Id: lyskomd.8,v 1.6 1991/10/29 05:41:58 linus Exp $
.\" $Date: 1991/10/29 05:41:58 $
.TH lyskomd 8 "August 22, 1991"
.SH NAME
lyskomd - LysKOM server
.SH SYNOPSIS
.B /usr/lyskom/bin/lyskomd 
[
.B -d
] [
.B -q
] [
.BI -D database-directory
] [
.BI -p client_port
] [
.BI -P mux_port
] [
.B -a
]
.SH DESCRIPTION
This program runs a LysKOM server.
.PP
It listens for connections on the given ports (defaults are 4894
for the 
.I client_port
and 4787 for the
.IR mux_port ).
.SH OPTIONS
.TP
.B \-d
Adds one to the debug-level i.e. increases the amount of output on the
stderr from the process.

Using one
.B \-d
make the process print a
.I >
for every timeout, a message for every person that is connecting or
disconnecting and a message for every successful or unsuccessful
communication to the process.
.TP
.B \-q
Never save the database.
.TP
.BI \-D database-directory
Use the database in the
.I database-directory.
.br
Example: If your database is in
.B $HOME/lyskom/db
you should use the option
.B \-D$HOME/lyskom
.TP
.BI \-p client_port
listens for clients on the port number
.I client_port.
.TP
.BI \-P mux_port
listens for mux connections on the port number
.I mux_port.
A mux connection is a connection using a special protocol to allow
several sessions within one connection.
.TP
.B \-a
Do not send any non-requested messages. This disables the sending of
messages about events in the server to all connections.
.SH SIGNALS
There are some signals that have a special meaning to the LysKOM
server.
.TP
.B SIGHUP
Logs out all sessions, saves the database and exits normally.
.TP 
.B SIGQUIT
Saves the database and dump core. (This should only be used for
debugging purposes.)
.TP
.B SIGUSR1
Print statistics about how often different commands have been used
since the process started.
.TP
.B SIGUSR2
Forks a child that immediately dumps core. The main process just waits
until the child is done and then continues. (This does not work on
Suns.)
.SH FILES
.TP 20
.B /usr/lyskom
Default database directory.
.TP
.IB database-directory /db/lyskomd-data
File with all the elements and pointers.
.TP
.IB database-directory /db/lyskomd-texts
File with the texts.
.TP
.IB database-directory /etc/pid
File with the pid of the lyskom-process.
.TP
.IB database-directory /db/lyskomd-backup
Backup file with all data.
.SH BUGS
Small memory leak.
.PP
There is no practical handling of security.
.PP
The choice of asynchronously issued messages is not very good.
.PP
The so called "data base" is a joke.
.SH AUTHOR
Per Cederqvist <ceder@lysator.liu.se>
.SH NOTE
Version 2.0 on its way.