lyskomd.8 3.52 KB
Newer Older
Linus Tolke's avatar
Linus Tolke committed
1
<.\" $Id: lyskomd.8,v 1.6 1991/10/29 05:41:58 linus Exp $
Linus Tolke's avatar
Linus Tolke committed
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
.\" 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. 
.\"
Linus Tolke's avatar
Linus Tolke committed
24
25
.\" $Id: lyskomd.8,v 1.6 1991/10/29 05:41:58 linus Exp $
.\" $Date: 1991/10/29 05:41:58 $
26
.TH lyskomd 8 "August 22, 1991"
Linus Tolke's avatar
Linus Tolke committed
27
.SH NAME
28
lyskomd - LysKOM server
Linus Tolke's avatar
Linus Tolke committed
29
.SH SYNOPSIS
30
.B /usr/lyskom/bin/lyskomd 
Linus Tolke's avatar
Linus Tolke committed
31
32
33
34
35
36
37
[
.B -d
] [
.B -q
] [
.BI -D database-directory
] [
Linus Tolke's avatar
Linus Tolke committed
38
.BI -p client_port
Linus Tolke's avatar
Linus Tolke committed
39
] [
Linus Tolke's avatar
Linus Tolke committed
40
.BI -P mux_port
Linus Tolke's avatar
Linus Tolke committed
41
42
43
44
45
46
] [
.B -a
]
.SH DESCRIPTION
This program runs a LysKOM server.
.PP
Linus Tolke's avatar
Linus Tolke committed
47
It listens for connections on the given ports (defaults are 4894
Linus Tolke's avatar
Linus Tolke committed
48
for the 
Linus Tolke's avatar
Linus Tolke committed
49
.I client_port
Linus Tolke's avatar
Linus Tolke committed
50
and 4787 for the
Linus Tolke's avatar
Linus Tolke committed
51
.IR mux_port ).
Linus Tolke's avatar
Linus Tolke committed
52
53
54
55
56
.SH OPTIONS
.TP
.B \-d
Adds one to the debug-level i.e. increases the amount of output on the
stderr from the process.
Linus Tolke's avatar
Linus Tolke committed
57

Linus Tolke's avatar
Linus Tolke committed
58
59
60
61
62
Using one
.B \-d
make the process print a
.I >
for every timeout, a message for every person that is connecting or
Linus Tolke's avatar
Linus Tolke committed
63
disconnecting and a message for every successful or unsuccessful
Linus Tolke's avatar
Linus Tolke committed
64
65
66
67
68
communication to the process.
.TP
.B \-q
Never save the database.
.TP
Linus Tolke's avatar
Linus Tolke committed
69
.BI \-D database-directory
Linus Tolke's avatar
Linus Tolke committed
70
71
72
73
Use the database in the
.I database-directory.
.br
Example: If your database is in
Linus Tolke's avatar
Linus Tolke committed
74
.B $HOME/lyskom/db
Linus Tolke's avatar
Linus Tolke committed
75
you should use the option
Linus Tolke's avatar
Linus Tolke committed
76
.B \-D$HOME/lyskom
Linus Tolke's avatar
Linus Tolke committed
77
.TP
Linus Tolke's avatar
Linus Tolke committed
78
.BI \-p client_port
Linus Tolke's avatar
Linus Tolke committed
79
listens for clients on the port number
Linus Tolke's avatar
Linus Tolke committed
80
.I client_port.
Linus Tolke's avatar
Linus Tolke committed
81
.TP
Linus Tolke's avatar
Linus Tolke committed
82
.BI \-P mux_port
Linus Tolke's avatar
Linus Tolke committed
83
listens for mux connections on the port number
Linus Tolke's avatar
Linus Tolke committed
84
85
.I mux_port.
A mux connection is a connection using a special protocol to allow
Linus Tolke's avatar
Linus Tolke committed
86
87
88
89
90
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.
Linus Tolke's avatar
Linus Tolke committed
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
.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.)
Linus Tolke's avatar
Linus Tolke committed
110
111
112
113
114
.SH FILES
.TP 20
.B /usr/lyskom
Default database directory.
.TP
115
.IB database-directory /db/lyskomd-data
Linus Tolke's avatar
Linus Tolke committed
116
117
File with all the elements and pointers.
.TP
118
.IB database-directory /db/lyskomd-texts
Linus Tolke's avatar
Linus Tolke committed
119
120
File with the texts.
.TP
Linus Tolke's avatar
Linus Tolke committed
121
.IB database-directory /etc/pid
Linus Tolke's avatar
Linus Tolke committed
122
123
File with the pid of the lyskom-process.
.TP
124
.IB database-directory /db/lyskomd-backup
Linus Tolke's avatar
Linus Tolke committed
125
126
Backup file with all data.
.SH BUGS
Linus Tolke's avatar
Linus Tolke committed
127
128
129
130
131
132
133
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.
Linus Tolke's avatar
Linus Tolke committed
134
135
.SH AUTHOR
Per Cederqvist <ceder@lysator.liu.se>
Linus Tolke's avatar
Linus Tolke committed
136
137
.SH NOTE
Version 2.0 on its way.