Commit a07f6fcd authored by David Byers's avatar David Byers
Browse files

Merged lyskomdb.texi inteo lyskomd.texi

Removed outdated files.
parent 252f41b7
Administrating a LysKOM site
============================
For lyskomd 1.9.0
This document is a short description of how to administrate a LysKOM
database on your site.
The first thing you will have to do is to follow the instructions in
the file INSTALL. This will set up the LysKOM system with a database
containing a few necessary conferences and one person - the
administrator.
Once the LysKOM system is running, there is not much you will have
to do to keep it that way. One thing to remember is that the current
release of the server has an incomplete handling of garbage collection
of the database. The database is split into two files, the
information file and the text file. Newly written texts are
concatenated to the text file and old texts are never removed. The
information file contains information about conferences, users and
where in the text file the texts are. This file is properly garbage
collected, but not the text file.
There is a program called dbck (Data Base Check) which is used to
check the consistency of the LysKOM database. This program can also
be used to shrink the text file. To do this, just type `dbck -g' in
the database directory, or give additional switches to dbck to use the
correct directory. See further the manual page for dbck. When dbck
is to be run on the database, the LysKOM server *must* be stopped, or
unrepairable damage may result. See below for a description on how to
stop the server.
There is a program called updateLysKOM which is used to ensure
continuous operation. This program is run with certain intervals and
if the LysKOM server has died for some reason, updateLysKOM restarts
it. If the server is still running properly, updateLysKOM sends a
signal (SIGUSR1) to it, which causes the server to write some
statistics to a file named etc/lyskomd-log in the lyskom directory.
Taking the server down cleanly can be done in two ways: through the
use of the LysKOM protocol on a socket, preferably through the use of
a suitable client, or by sending the signal SIGHUP to it. This will
cause the server to save the database and close all client
connections. It will also create a file named etc/memory-usage in
which the memory usage of the server is reported.
To prevent updateLysKOM from restarting a server, create a file
named /usr/lyskom/etc/status. The file should contain a valid mail
address on the first line. UpdateLysKOM will not restart the server
as long as that file exists. In addition, if the file is between 1
and 2 hours old an email will be sent to the mail address found in the
file. If the file is older than that, an error message will be
printed on stderr and updateLysKOM will exit with a non-zero exit
status. cron is expected to deliver the error message to an operator.
The shell script komrunning can be used to start and stop the LysKOM
server. With no arguments, it will report the status.
komrunning off
will shut down the server, creating the file /usr/lyskom/etc/status,
while
komrunning on
will restart it. The actual stopping and starting of the server will
be done by updateLysKOM the next time it is run. komrunning only
creates the lock file.
1990-11-25 ceder@lysator.liu.se 000056
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version:
----------------------------------------------------------------------
Det b|r finnas n}got s{tta att st{nga av asynkrona meddelanden (t ex
n{r man k|r r}tt).
----------------------------------------------------------------------
1991-02-15 ceder@Lysator.LiU.SE 000070
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version:
Orsak:
----------------------------------------------------------------------
add_recipient med m}nga flera skickar ej ut n}got asynkront meddelande.
----------------------------------------------------------------------
1991-02-15 ceder@Lysator.LiU.SE 000069
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version:
Orsak:
----------------------------------------------------------------------
Det ska, genom att g|ra g|ra add_recipient, g} att {ndra en recpt till
cc_recpt (och inte bara }t andra h}llet). En mottagare ska, precis som
nu, inte f} vara b}de recpt och cc_recpt.
----------------------------------------------------------------------
1991-02-08 ceder@Lysator.LiU.SE 000068
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version:
Orsak:
----------------------------------------------------------------------
kom_info, som bl a inneh}ller motd_of_lyskom, sparas inte. N{r man
startar om servern {r all info gl|md.
----------------------------------------------------------------------
1991-12-16 ceder@Lysator.LiU.Se 000074
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 0.34.3
Orsak: Brist p} f|rutseende.
----------------------------------------------------------------------
N{r en text skapas, som har mottagare som {r b}de hemliga och |ppna,
censureras inte listan av mottagare.
----------------------------------------------------------------------
1991-01-13 ceder@Lysator.LiU.SE 000066
----------------------------------------------------------------------
]tg{rdat av: ceder
Program: elisp-klient, servern
Till version: Servern 0.09
Orsak: servern ger en lista tillbaka inneh}llande nollor
----------------------------------------------------------------------
Om man f|rs|ker }terse raderade texter s} visas "Texten finns inte."
Det {r lite jobbigt om man t ex g|r "]terse alla av Pell Pell Pell".
----------------------------------------------------------------------
1991-01-04 Bellman@Lysator.LiU.SE 000064
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 0.08 - klart
----------------------------------------------------------------------
Ett inl{gg kan kommentera ett annat flera g}nger.
----------------------------------------------------------------------
1990-12-18 Bellman@Lysator.LiU.SE 000062
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: servern
Till version: 0.07 - klart
----------------------------------------------------------------------
Add-recipient tycks alltid s{tta mottagaren som vanlig mottagare {ven
om man anger cc-recpt.
----------------------------------------------------------------------
1990-12-09 linus@Lysator.LiU.SE 000058
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: Elisp-klienten
Till version: 0.18.1 - klart
Orsak: LUNATIX
----------------------------------------------------------------------
Nanny klarar inte av att skicka paket som {r l{ngre {n 2048 tecken.
Elisp-klienten borde inte skicka st|rre paket utan borde dela p} l}nga
texter.
----------------------------------------------------------------------
1990-12-06 linus@lysator.liu.se 000057
----------------------------------------------------------------------
]tg{rdas av: linus@lysator.liu.se
Program: Elisp-klienten
Till version: 0.18 - fixat
----------------------------------------------------------------------
Filterna lyskom-init-filter och lyskom-filter gl|mmer i vissa fall att
s{tta tillbaka current buffer. Detta resulterar i ganska m}nga
Buffer is read-only *nanny*
I synnerhet p} fr}gan {r detta f|rsta g}ngen du k|r lyskom (yes/no):
----------------------------------------------------------------------
1990-11-20 ceder@lysator.liu.se 000054
----------------------------------------------------------------------
]tg{rdas av: Inge Wallin
Program: elisp-klienten
Till version: 0.18.1
----------------------------------------------------------------------
N{r man skriver en presentation av ett m|te markeras den inte (alltid)
som presentation av servern.
----------------------------------------------------------------------
1990-11-14 linus@lysator.liu.se 000051
----------------------------------------------------------------------
]tg{rdas av: Ingen }tg{rd. Felaktig buggrapport.
Program: elisp-klient
Till version:
----------------------------------------------------------------------
N{r jag l{ser med djup-f|rst flaggan satt och har l{st ett inl{gg som
har kommentarer s} l{ggs dessa ol{sta kommentarer upp i en egen
to-read-info.
N{r jag nu g|r n{sta m|te eller g}r till n}got annat m|te (utan att ha
l{st slut dessa kommentarer) f|rsvinner denna to-read-info.
Den borde flyttas med till lyskom-to-do-list s} att man kommer in i
samma kommentarkedja n{sta g}ng man kommer till m|tet.
----------------------------------------------------------------------
1990-11-12 ceder@lysator.liu.se 000050
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version: fixat /ceder
----------------------------------------------------------------------
Text-garbningen tar inte h{nsyn till om inl{gg {r skickade "nyss". Om
dom {r tillr{ckligt gamla s} raderas de {nd}. Felet ligger i
garb_text() i text-garb.c.
----------------------------------------------------------------------
1990-11-11 ceder@lysator.liu.se 000049
----------------------------------------------------------------------
]tg{rdas av: (Ingen }tg{rd. F|rdelen med ett m{nniskol{sbart format
{r stora, och dessutom tj{nar man inte s} mycket.)
Program: protokoll
Till version: B
----------------------------------------------------------------------
Ca dubbelt s} mycket data |verf|rs via TCP som det man f}r ut ur
anv{ndarinterfacet. Protokoll B b|r nog anv{nda r}a bytes, och inte
skicka tal i ASCII.
----------------------------------------------------------------------
1990-11-11 ceder@lysator.liu.se 000047
----------------------------------------------------------------------
]tg{rdas av: pen
Program: server
Till version: 0.07 - klart
Orsak: Blocking writes.
----------------------------------------------------------------------
Servern h{nger sig i flera minuter ibland, utan k{nd orsak. Efter upp
till 10 minuter hoppar den ig}ng igen av sig sj{lv.
----------------------------------------------------------------------
1990-11-04 ceder@lysator.liu.se 000042
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: elisp-klienten
Till version: 0.18.1 - klart
----------------------------------------------------------------------
Det finns inget "endast"-kommando i elisp-klienten.
----------------------------------------------------------------------
1990-10-28 ceder@lysator.liu.se 000040
----------------------------------------------------------------------
]tg{rdas av: linus@lysator.liu.se
Program: elisp-klienten
Till version: 0.12
----------------------------------------------------------------------
Subject: L{gga in en text. BUGFIX
Jag k|r med
kom-write-texts-in-other-window t
och har retat mig p} att det alltid l{mnar 2 f|nster ({ven om jag bara
hade ett).
N{r jag skulle fixa det m{rkte jag att det den gjorde egentligen var
ganska komplicerat och jag vill h{vda att min l|sning {r snyggare.
Jag har i koden i detta brev markerat var skillnaderna finns.
Kod utan markeringarna (och oindenterat) finns i
~linus/.el/lyskom-write.el.
Dessa {r min tv} funktioner att ers{tta dem i lyskom.el:
(defun lyskom-edit-text (proc misc-list subject &optional handler &rest data)
"Edit a text in a new buffer.
PROC is the associated process.
MISC-LIST is the default misc-list.
SUBJECT is subject (a string).
HANDLER is a function to call when the text has been created.
DATA is extra data to send to the function. HANDLER is called with
(apply HANDLER text-no DATA)
where text-no is the number of the text."
(setq lyskom-is-writing t)
(lyskom-end-of-command)
(let
((buffer (generate-new-buffer
(concat (buffer-name (process-buffer proc)) "-edit")))
(config (current-window-configuration)))
(cond
(kom-write-texts-in-other-window
(switch-to-buffer-other-window buffer))
(t (switch-to-buffer buffer)))
(lyskom-edit-mode)
(setq lyskom-proc proc)
(make-local-variable 'lyskom-edit-handler)
(make-local-variable 'lyskom-edit-handler-data)
> (make-local-variable 'lyskom-edit-return-to-configuration)
(setq lyskom-edit-handler handler)
(setq lyskom-edit-handler-data data)
> (setq lyskom-edit-return-to-configuration config)
(lyskom-edit-insert-miscs misc-list subject)
(message "Tryck C-c C-c f|r att skicka in texten."))
(set-buffer (process-buffer lyskom-proc)))
(defun lyskom-create-text-handler (text-no edit-buffer)
"Handle an attempt to write a text."
(lyskom-tell-server "")
(cond
((null text-no)
(lyskom-insert
(format "\nTexten kunde ej skapas. Felkod: %d.\n" lyskom-errno))
(ding)
(message "Texten kunde ej skapas. Felkod: %d." lyskom-errno))
(t
(lyskom-insert (format "\nText nummer %d skapad.\n" text-no))
;; Immediately mark the text as read if kom-created-texts-are-read is set.
(cond
(kom-created-texts-are-read
(lyskom-is-read text-no)
(initiate-get-text-stat 'background 'lyskom-mark-as-read
text-no)
(lyskom-run 'background 'set 'lyskom-dont-change-prompt nil)))
(set-buffer edit-buffer) ;Need local variables.
> ;; Select the old configuration.
> (set-window-configuration lyskom-edit-return-to-configuration)
;; Apply handler.
(if lyskom-edit-handler
(let ((hnd lyskom-edit-handler)
(dta lyskom-edit-handler-data))
(set-buffer (process-buffer lyskom-proc))
(apply hnd text-no dta)))
(set-buffer (process-buffer lyskom-proc))
;; Kill the edit-buffer.
(kill-buffer edit-buffer)))
(lyskom-end-of-command))
----------------------------------------------------------------------
1990-10-25 mattias@lysator.liu.se 000036
----------------------------------------------------------------------
]tg{rdas av: ???
Program: elispklienten och servern???
Till version: ???
----------------------------------------------------------------------
Tomma texter fungerar inte s} bra.
----------------------------------------------------------------------
1990-10-21 ceder@lysator.liu.se 000027
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: klart sedan l{nge
----------------------------------------------------------------------
En person som {r raderad raderas inte helt. Man kan fortfarande skapa
texter med personen som mottagare. De f}r ett lokalt nummer i m|tet.
Suck. Allvarligt!
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000018
----------------------------------------------------------------------
]tg{rdas av:
Program: elisp-klient
Till version: klart sedan l{nge
----------------------------------------------------------------------
Det g}r inte att l{sa i kommentarsordning. "}k" {r inte generellt.
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000017
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 6 - klart
----------------------------------------------------------------------
Det g}r inte att markera texter. Det fattas kod i servern.
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000016
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 6 - klart
----------------------------------------------------------------------
Gamla inl{gg raderas aldrig. B|r }tg{rdas snarast!
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000015
----------------------------------------------------------------------
]tg{rdas av: linus??
Program: server
Till version: ???
----------------------------------------------------------------------
Asynkrona meddelanden {r inte f{rdigimplementerat.
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000012
----------------------------------------------------------------------
]tg{rdas av: Linus
Program: elisp-klient
Till version: 0.16 - klart
----------------------------------------------------------------------
Elisp-klienten borde skriva ut "Kommentar till text 289 av
<f|rfattare>". "Kommentar i text 435 av <f|rfattare>" borde skrivas
efter texten.
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000011
----------------------------------------------------------------------
]tg{rdas av: Inge Wallin
Program: elisp-klient
Till version: ???
----------------------------------------------------------------------
Elisp-klienten borde skriva ut vilket kommando den h}ller p} att g|ra
s} fort man har startat det.
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000009
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 0.04 - klart
Program: elisp-klient
Till version: 0.10 - klart
Program: libyskom.a
Till version: () - klart
----------------------------------------------------------------------
who_is_on borde s{nda med en connection.
----------------------------------------------------------------------
1990-10-20 ceder@lysator.liu.se 000008
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 0.04 - klart
Program: elisp-klient
Till version: 0.10 - klart
Program: libyskom.a
Till version: () - klart
Program: tty-klient (}tg{rdas av Bellman)
Till version:
----------------------------------------------------------------------
get_conf_stat och get_person_stat beh|ver inte flaggan 'mask' l{ngre.
Den b|r tas bort.
----------------------------------------------------------------------
1990-10-20 Bellman@Lysator.LiU.SE 000007
----------------------------------------------------------------------
]tg{rdas av: Bellman
Program: elisp-klient
Till version: 0.10 - klart
----------------------------------------------------------------------
Elisp-klienten: N{r man h}ller p} att skriva en text, borde den
tycka att raden "--- Skriv texten nedanf|r denna rad ---" skiljer
tv} stycken }t. Denna str{ng b|r f | vara en variabel, inte en
magisk str{ng mitt inne i k{llkoden.
----------------------------------------------------------------------
1990-10-20 Bellman@Lysator.LiU.SE 000006
----------------------------------------------------------------------
]tg{rdas av: Bellman
Program: elisp-klient
Till version: 0.10 - klart
----------------------------------------------------------------------
Elisp-klienten: Implementera "personligt (svar)". Borde vara
ganska enkelt.
----------------------------------------------------------------------
1990-10-20 Bellman@Lysator.LiU.SE 000005
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: elisp-klient
Till version: klart sedan l{nge
----------------------------------------------------------------------
Elisp-klienten: f|r att ange att man vill kommentera ett annat
inl{gg {n det man nyss l{st, anger man inl{ggsnumret som argument
med C-u till k. Dvs n}got s}nt h{r:
(defun kom-write-comment (&optional arg)
(interactive "P")
(let ((text-to-comment (and arg lyskom-current-text)))
...))
eller vad variablerna nu heter.
----------------------------------------------------------------------
1990-10-19 ingwa@isy.liu.se 000003
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: elisp-klient
Till version: 0.11 - klart
----------------------------------------------------------------------
Elisp-klienten b|r byta prompt n{r man st}r och v{ntar, fr}n
"(Se) tiden" till "(G} till) n{sta m|te"
----------------------------------------------------------------------
1990-10-19 Tommy Persson @ LysKOM 000002
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: elisp-klient
Till version: 0.10 - klart
----------------------------------------------------------------------
703 1990-10-19 11:00 /20 rader/ Tommy Persson
Mottagare: LysKOM Elisp-klient; buggar, nyheter och annat. <41>
[rende: ]terse kommenterad
--------------------------------------------------------
H{r kommer ett }terse kommenterat kommando:
(defun kom-view-commented-text ()
(interactive)
(let ((text-no nil))
(save-excursion
(re-search-backward "/.*rader/" nil t)
(if (search-forward "Kommentar till text" nil t)
(setq text-no (read
(buffer-substring (point)
(save-excursion
(forward-word 1)
(point)))))))
(if text-no
(progn
(lyskom-start-of-command)
(lyskom-insert (format "]terse text nummer %d.\n" text-no))
(lyskom-view-text text-no)))))
(703) -----------------------------------------------------
----------------------------------------------------------------------
1990-10-18 Aronsson@Lysator.LiU.SE 000001
----------------------------------------------------------------------
]tg{rdas av: ceder
Program: server
Till version: 0.04 - klart
Orsak: Aronsson var inloggad p} flera sessioner. N{r han
raderade sig sj{lv skulle han ha blivit utloggad fr}n
alla sessioner.
----------------------------------------------------------------------
Jag k|rde r} telnet. Skrev kommandot 11 11 (delete-conf) 8 (Lars
Aronsson). Detta var i o.f.s. ett misstag, jag hade t{nkt g|ra 13
(get-conf-stat). Men f|ljden blev att hela servern kraschade.
----------------------------------------------------------------------
Filen inneh}ller bugrapporter, ideer och andra f|rslag till
f|rb{ttringar p} LysKOM och dess ing}ende program. L{gg nya buggar
f|rst i filen. En mall f|r en buggrapport kan s{ttas in med C-x g m.
1991-09-02 rjan@Lysator.LiU.Se 000073
----------------------------------------------------------------------
]tg{rdas av:
Program: server, klienter
Till version:
Orsak:
----------------------------------------------------------------------
L}t f|rfattaren av en text addera andras texter som fotn|tter.
ceder says: bra ide.
----------------------------------------------------------------------
1991-03-03 ceder@lysator.liu.se 000072
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version:
Orsak:
----------------------------------------------------------------------
isc_getnextevent borde anv{nda ett write-set i select(). Som det {r nu
kan en klient f} v{nta 2 sekunder p} data.
----------------------------------------------------------------------
1991-02-28 Bellman@Lysator.LiU.Se 000071
----------------------------------------------------------------------
]tg{rdas av:
Program: elisp-klient
Till version:
Orsak:
----------------------------------------------------------------------
Version 0.28. Ibland f}r man prompten "L{sa n{sta text", trots att
man borde f}tt "G} till n{sta m|te" f|ljt av "L{sa n{sta text".
----------------------------------------------------------------------
1991-02-05 linus@Lysator.LiU.SE 000067
----------------------------------------------------------------------
]tg{rdas av:
Program: elispklienten och emacs 18.56
Till version:
Orsak:
----------------------------------------------------------------------
O{ndlig loop n}gonstans n{r filterfunktionerna anv{nds f}r Emacs 18.56
att h{nga sig h}rt. (G}r ej att bryta med C-G utan forts{tter att k|ra
n{r jag svara jag p} fr}gan continuing?
Jag har m{rkt det n{r
- Jag skapade ett nytt m|te (fick inte skriva presentation f|r den
h{ngde sig innan.)
- N{r jag skrev ett inl{gg och var i en annan buffert innan den fick
svar.
----------------------------------------------------------------------
1991-02-01 ceder@Lysator.LiU.SE 000066
----------------------------------------------------------------------
]tg{rdas av:
Program: server
Till version:
Orsak:
----------------------------------------------------------------------
Det finns ingen gr{ns p} hur mycket man kan lagra i en utk| i
isc-rutinerna.
----------------------------------------------------------------------
1991-01-10 Bellman@Lysator.LiU.SE 000065
----------------------------------------------------------------------
]tg{rdas av:
Program: server