From 14b5e52c8a979dea4deddd3cccac6727752707a7 Mon Sep 17 00:00:00 2001 From: Stephen L Johnson Date: Fri, 18 Feb 2000 20:35:45 +0000 Subject: [PATCH] updated and corrected documenation. Added documenation for connection timeouts --- www/docs/spong-server.html | 61 +++++++++++++++++++++----------------- 1 file changed, 34 insertions(+), 27 deletions(-) diff --git a/www/docs/spong-server.html b/www/docs/spong-server.html index d563e10..74bc7f2 100755 --- a/www/docs/spong-server.html +++ b/www/docs/spong-server.html @@ -25,28 +25,20 @@ spong clients (specifically the spong-network and various spong-client programs running). It takes the information reported by the various spong clients and does the following: 
-    * Check for valid messages, and discards any invalid ones.
-
-    * If the message is something worth notifying someone about, it calls
-
-      the spong-message program and lets it determine how/if to contact 
-
-      someone about the problem.
-
-    * Check to see if the color of this message is different then it
-
-      used to be, and if so generate a history item indicating the change.
-
-    * Save the information in the $SPONGSTATUS directory.
+    * Check for valid messages, and discards any invalid ones.
 
+    * If the message is something worth notifying someone about, it calls
+      the spong-message program and lets it determine how/if to contact
+      someone about the problem.
 
+    * Check to see if the color of this message is different then it
+      used to be, and if so generate a history item indicating the change.
 
+    * Save the information in the $SPONGDB directory.
 
+    * Answers database queries from Spong Interface Clients
-Each time a message comes in, a child process is forked off to handle the -above tasks, while the main spong-server program goes back to waiting for -more status reports.

You should start this program in your system startup file, and it should be running constantly. If you provide the --debug flag, then debugging information will be printed to stdout, otherwise output will only be produced @@ -91,16 +83,29 @@ value is ``CHANGE'', then spong-message is only called when there is a change of state (going from green to red, and then again going from red to green). If its value is ``NONE'', then spong-message is never called. - +

-$SPONGPORT, $SPONGSTATUS, $SPONGHISTORY, $SPONGNOTES
+$SPONG_UPDATE_PORT
- The port number that the server should be listening at, and some -directory locations where status information, history information, and -host specific documentation are kept.
+The port number that the server should be listening at for receiving update messages +

+

$SPONG_QUERY_PORT + +
+The port number that the server should be listening at for answering database queries from the various spong interface clients. +

+

$SPONG_BB_UPDATE_PORT +
The port that the server should be listeningat for receiving Big Brother status update messages. This is the Big Brother server emulation feature. +

+

$SPONG_SPONG_ALARM +
The is the amount of time (in seconds) a connection from a Spong Client to spong-server is allowed. After the timeout period +elaspes the connection is closed. + + + -
+

DATA MODULES

@@ -177,14 +182,16 @@ authentication to protect against bogus data.

SEE ALSO

-the spong-network manpage , the spong-client manpage , the -spong-display manpage , the spong-message manpage , spong.hosts, -spong.conf +the spong-network manpage , the spong-client manpage , the spong-message manpage , +spong.hosts, spong.conf

-AUTHOR

-Ed Hill (ed-hill@uiowa.edu), Unix +AUTHORS +
Stephen L Johnson (stephen.johnson@mail.state.ar.us) +or (sjohnson@monsters.org), +Unix System Administator, DIS - State of Arkansas +
Ed Hill (ed-hill@uiowa.edu), Unix System Administrator, The University of Iowa

Based on code/ideas from Sean MacGuire (BB), and Helen Harrison (Pong). -- 2.30.2