* Documentation update: update citadel.html for new syslog logging

diff --git a/citadel/ChangeLog b/citadel/ChangeLog
index 4c90500e8d31413f8f156fe59d231db5f5ecc36d..ff2a48b1a553e27fba5cb0b01a1b1d2fd36572ee 100644 (file)
--- a/citadel/ChangeLog
+++ b/citadel/ChangeLog
@@ -1,4 +1,7 @@
  $Log$
+ Revision 614.80  2004/03/15 16:48:22  error
+ * Documentation update: update citadel.html for new syslog logging
+
  Revision 614.79  2004/03/15 16:47:04  error
  * msgbase.c: cmd_move(): Fix the security logic for non-aides trying to
    move or copy messages.  The logic should do the following:
@@ -5524,3 +5527,4 @@ Sat Jul 11 00:20:48 EDT 1998 Nathan Bryant <bryant@cs.usm.maine.edu>
 
 Fri Jul 10 1998 Art Cancro <ajc@uncensored.citadel.org>
        * Initial CVS import
+

diff --git a/citadel/docs/citadel.html b/citadel/docs/citadel.html
index 2d0dba4f78d36818f3dcb43d6c65ab2a885d8487..4bbcaee2dbcefda5db668aaaa50bb4a80b9db122 100644 (file)
--- a/citadel/docs/citadel.html
+++ b/citadel/docs/citadel.html
@@ -844,16 +844,19 @@ program against to set up some data files. If a directory is not
 specified, the directory
 name which was specified in the <tt>Makefile</tt> will be used.</p>
 <p><tt>-xDebugLevel</tt> - Set the verbosity of trace messages printed.
-The
-available debugging levels are: </p>
+When -x is used, it will suppress messages sent to syslog (see below).  In
+other words, syslog will never see certain messages if -x is used.  Normally
+you should configure logging through syslog, but -x may still be useful in
+some circumstances.  The available debugging levels are: </p>
 <ul>
-  <li>1 - Internal errors (failed thread creation, malloc problems,
-etc.) </li>
-  <li>2 - Network errors (broken sockets, failed socket creation) </li>
-  <li>3 - Begin and end of sessions, startup/shutdown of server </li>
-  <li>5 - Server commands being sent from clients </li>
-  <li>7 - Entry and exit of various functions </li>
-  <li>9 - Various debugging checkpoints (insanely verbose) </li>
+  <li>0 - Emergency condition; Citadel will exit immediately </li>
+  <li>1 - Severe errors; Citadel may be unable to continue without attention </li>
+  <li>2 - Critical errors; Citadel will continue with degraded functionality </li>
+  <li>3 - Error conditions; Citadel will recover and continue normally </li>
+  <li>4 - Warning messages; Citadel will continue normally </li>
+  <li>5 - Normal operational messages </li>
+  <li>6 - Informational messages, progress reports, etc. </li>
+  <li>7 - Debugging messages; extremely verbose </li>
 </ul>
 <p><tt>-tTraceFile</tt> - Tell the server where to send its debug/trace
 output. Normally it is sent to stdout.</p>
@@ -877,8 +880,8 @@ entry in your /etc/inittab file. This will conveniently bring the
 server up when your system is up, and terminate it gracefully when your
 system is shutting down. The exact syntax for your system may vary, but
 here's an entry that could be used on a Linux system:</p>
-<pre>cit:2345:respawn:/usr/local/citadel/citserver -h/usr/local/citadel -t/dev/tty9 -x3<br></pre>
-<p>In this example, we've chosen debugging level 3, and have the trace
+<pre>cit:2345:respawn:/usr/local/citadel/citserver -h/usr/local/citadel -t/dev/tty9 -x6<br></pre>
+<p>In this example, we've chosen debugging level 6, and have the trace
 stuff output to one of the virtual consoles. It's important to remember
 to turn off any getty that is set up on that virtual console, if you do
 this. After making this change, the command <tt>init q</tt> works on

diff --git a/citadel/techdoc/developers.txt b/citadel/techdoc/developers.txt
index 78df37d5d6860885166473058a641305c1f6b515..a88b7d879aeefe8d31e77bc7a3d3c6c5c0e64a8f 100644 (file)
--- a/citadel/techdoc/developers.txt
+++ b/citadel/techdoc/developers.txt
@@ -46,6 +46,7 @@ Developer codes (and where known, client codes)
         Client  Name            Status          Description
        0       libcitadel      in development  Client-side API library
        1       D.O.C.          dead            Dave's Own Citadel look-alike
+       8       stress          in development  Citadel server stress tester
        16      Courier         in development  GTK+ Unix/Win32 Client
  
  69     Anticlimactic Teleservices