]> arthur.barton.de Git - ngircd-web.git/commitdiff
Update HTML manual pages
authorAlexander Barton <alex@barton.de>
Sat, 4 May 2024 16:45:58 +0000 (18:45 +0200)
committerAlexander Barton <alex@barton.de>
Sat, 4 May 2024 16:45:58 +0000 (18:45 +0200)
man/ngircd.8.html
man/ngircd.conf.5.html

index 7646e308fb9d37509a4b7bd61f830ace7b49905d..4f98cea0652c5c4fd93f425a84d4e7277cc0b134 100644 (file)
@@ -253,11 +253,24 @@ re-initialize the daemon.</p>
 the configuration of ngIRCd after making changes to the configuration
 files!</p>
 <h1>DEBUGGING</h1>
 the configuration of ngIRCd after making changes to the configuration
 files!</p>
 <h1>DEBUGGING</h1>
-<p>When ngIRCd is compiled with debug code, that is, its source code has
-been ./configure'd with "--enable-debug" and/or "--enable-sniffer"
-(witch enables debug mode automatically as well), you can use two more
-command line options and two more signals to debug problems with the
-daemon itself or IRC clients:</p>
+<p>ngIRCd can log additional debug messages, which can be enabled with
+the command line option --debug (-d) or by sending the USR1 signal to
+the running daemon. Some of those messages may leak personal
+information, be very technical and can be very verbose. Therefore the
+debug mode is meant for troubleshooting only and should definitely be
+disabled during normal operation!</p>
+<p>In addition, a "protocol sniffer" can be enabled on build time by
+passing the "--enable-sniffer" option to the ./configure script which
+enables the "--sniffer" (-s) command line option (which is not available
+by default): this "sniffer" logs all incoming and outgoing IRC commands
+on all connections, which can be handy to debug problems with the daemon
+itself or IRC clients.</p>
+<p>Both modes are indicated in the version string shown by the IRC
+"VERSION" command: if the version ends in a dot (like in "26.1."), the
+daemon operates in "normal" mode (the version used in the example is
+"26.1"). If it ends in ".1" (like in "26.1.1") the "debug-mode" is
+enabled; and if it ends in ".2" (like in "26.1.2") the "IRC sniffer" is
+enabled, too.</p>
 <p><strong>Options:</strong></p>
 <dl>
 <dt><strong>-d</strong>, <strong>--debug</strong></dt>
 <p><strong>Options:</strong></p>
 <dl>
 <dt><strong>-d</strong>, <strong>--debug</strong></dt>
@@ -273,6 +286,8 @@ automatically, too.</p>
 </dd>
 </dl>
 <p><strong>Signals:</strong></p>
 </dd>
 </dl>
 <p><strong>Signals:</strong></p>
+<p>Note: Usage of these signals is broadcasted to all users with the +s
+("receive server notices") mode set!</p>
 <dl>
 <dt><strong>USR1</strong></dt>
 <dd>
 <dl>
 <dt><strong>USR1</strong></dt>
 <dd>
index 9934c4ce7ed11995636edd223304e7cf338f597c..6e8ff16c364b73417955ffc29d51400c2e0ab535 100644 (file)
@@ -590,6 +590,12 @@ used. Default: not set.</p>
 recognized by ngIRCd when it is compiled with support for SSL using
 OpenSSL or GnuTLS!</p>
 <dl>
 recognized by ngIRCd when it is compiled with support for SSL using
 OpenSSL or GnuTLS!</p>
 <dl>
+<dt><strong>CAFile</strong> (string)</dt>
+<dd>
+<p>Filename pointing to the Trusted CA Certificates. This is required
+for verifying peer certificates. Default: not set, so no certificates
+are trusted.</p>
+</dd>
 <dt><strong>CertFile</strong> (string)</dt>
 <dd>
 <p>SSL Certificate file of the private server key.</p>
 <dt><strong>CertFile</strong> (string)</dt>
 <dd>
 <p>SSL Certificate file of the private server key.</p>
@@ -601,6 +607,10 @@ to "HIGH:!aNULL:@STRENGTH:!SSLv3" (OpenSSL) or "SECURE128:-VERS-SSL3.0"
 (GnuTLS). Please see 'man 1ssl ciphers' (OpenSSL) and 'man 3
 gnutls_priority_init' (GnuTLS) for details.</p>
 </dd>
 (GnuTLS). Please see 'man 1ssl ciphers' (OpenSSL) and 'man 3
 gnutls_priority_init' (GnuTLS) for details.</p>
 </dd>
+<dt><strong>CRLFile</strong> (string)</dt>
+<dd>
+<p>Filename of Certificate Revocation List.</p>
+</dd>
 <dt><strong>DHFile</strong> (string)</dt>
 <dd>
 <p>Name of the Diffie-Hellman Parameter file. Can be created with GnuTLS
 <dt><strong>DHFile</strong> (string)</dt>
 <dd>
 <p>Name of the Diffie-Hellman Parameter file. Can be created with GnuTLS
@@ -703,6 +713,11 @@ create the link.</p>
 <dd>
 <p>Connect to the remote server using TLS/SSL. Default: false.</p>
 </dd>
 <dd>
 <p>Connect to the remote server using TLS/SSL. Default: false.</p>
 </dd>
+<dt><strong>SSLVerify</strong> (boolean)</dt>
+<dd>
+<p>Verify the TLS certificate presented by the remote server. Default:
+yes.</p>
+</dd>
 <dt><strong>ServiceMask</strong> (string)</dt>
 <dd>
 <p>Define a (case insensitive) list of masks matching nicknames that
 <dt><strong>ServiceMask</strong> (string)</dt>
 <dd>
 <p>Define a (case insensitive) list of masks matching nicknames that