Module: ngircd.git
Branch: master
Commit: 7ae7ace579915dc023722f733f30e941d371cab3
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=7ae7ace5…
Author: Alexander Barton <alex(a)barton.de>
Date: Tue Jun 28 13:45:16 2011 +0200
ngircd.8: document debugging options
---
man/ngircd.8.tmpl | 25 +++++++++++++++++++++++++
1 files changed, 25 insertions(+), 0 deletions(-)
diff --git a/man/ngircd.8.tmpl b/man/ngircd.8.tmpl
index d907e6f..9da7ef8 100644
--- a/man/ngircd.8.tmpl
+++ b/man/ngircd.8.tmpl
@@ -76,6 +76,31 @@ re-initialize the daemon.
.SH HINTS
It's wise to use "ngircd \-\-configtest" to validate the configuration file
after changing it.
+.SH DEBUGGING
+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:
+.PP
+\fBOptions:\fR
+.TP
+\fB\-d\fR, \fB\-\-debug\fR
+Enable debug mode and log extra messages.
+.TP
+\fB\-s\fR, \fB\-\-sniffer\fR
+Enable IRC protocol sniffer, which logs all sent and received IRC commands to
+the console/syslog. This option requires that ngIRCd has been ./configure'd
+with "--enable-sniffer" and enables debug mode automatically, too.
+.PP
+\fBSignals:\fR
+.TP
+\fBUSR1\fR
+Toggle debug mode on and off during runtime.
+.TP
+\fBUSR2\fR
+Dump internal server state to the console/syslog when debug mode is on (use
+command line option \-\-debug or signal USR1).
.SH AUTHORS
Alexander Barton, <alex(a)barton.de>
.br
Module: ngircd.git
Branch: master
Commit: 91b6c05d1d33c1569d96d6ffcf1277a463ddcb4e
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=91b6c05d…
Author: Alexander Barton <alex(a)barton.de>
Date: Tue Jun 28 13:39:01 2011 +0200
ngircd.8: document debugging options
---
man/ngircd.8.tmpl | 24 ++++++++++++++++++++++++
1 files changed, 24 insertions(+), 0 deletions(-)
diff --git a/man/ngircd.8.tmpl b/man/ngircd.8.tmpl
index d907e6f..d0c30e8 100644
--- a/man/ngircd.8.tmpl
+++ b/man/ngircd.8.tmpl
@@ -76,6 +76,30 @@ re-initialize the daemon.
.SH HINTS
It's wise to use "ngircd \-\-configtest" to validate the configuration file
after changing it.
+.SH DEBUGGING
+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:
+.PP
+\fBOptions:\fR
+.TP
+\fB\-d\fR, \fB\-\-debug\fR
+Enable debug mode and log extra messages.
+.TP
+\fB\-s\fR, \fB\-\-sniffer\fR
+Enable IRC protocol sniffer, which logs all sent and received IRC commands to
+the console/syslog. This option requires that ngIRCd has been ./configure'd
+with "--enable-sniffer" and enables debug mode automatically, too.
+.PP
+\fBSignals:\fR
+.TP
+\fBUSR1\fR
+Toggle debug mode on and off during runtime.
+.TP
+\fBUSR2\fR
+Dump internal server state to the console/syslog when debug mode is on (use
+command line option \-\-debug or signal USR1).
.SH AUTHORS
Alexander Barton, <alex(a)barton.de>
.br
Module: ngircd.git
Branch: master
Commit: 5f400694cfee5bed6be0ac0a5c1638ed9b413c55
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=5f400694…
Author: Alexander Barton <alex(a)barton.de>
Date: Tue Jun 28 13:21:38 2011 +0200
ngircd.conf.5: strip "SSL" prefix from variables in [SSL] section
---
man/ngircd.conf.5.tmpl | 10 +++++-----
1 files changed, 5 insertions(+), 5 deletions(-)
diff --git a/man/ngircd.conf.5.tmpl b/man/ngircd.conf.5.tmpl
index ccf3d94..38ac40b 100644
--- a/man/ngircd.conf.5.tmpl
+++ b/man/ngircd.conf.5.tmpl
@@ -314,10 +314,10 @@ All SSL-related configuration variables are located in the
section. Please note that this whole section is only recognized by ngIRCd
when it is compiled with support for SSL using OpenSSL or GnuTLS!
.TP
-\fBSSLCertFile\fR (string)
+\fBCertFile\fR (string)
SSL Certificate file of the private server key.
.TP
-\fBSSLDHFile\fR (string)
+\fBDHFile\fR (string)
Name of the Diffie-Hellman Parameter file. Can be created with GnuTLS
"certtool \-\-generate-dh-params" or "openssl dhparam". If this file is not
present, it will be generated on startup when ngIRCd was compiled with GnuTLS
@@ -325,14 +325,14 @@ support (this may take some time). If ngIRCd was compiled with OpenSSL, then
(Ephemeral)-Diffie-Hellman Key Exchanges and several Cipher Suites will not be
available.
.TP
-\fBSSLKeyFile\fR (string)
+\fBKeyFile\fR (string)
Filename of SSL Server Key to be used for SSL connections. This is required
for SSL/TLS support.
.TP
-\fBSSLKeyFilePassword\fR (string)
+\fBKeyFilePassword\fR (string)
OpenSSL only: Password to decrypt the private key file.
.TP
-\fBSSLPorts\fR (list of numbers)
+\fBPorts\fR (list of numbers)
Same as \fBPorts\fR , except that ngIRCd will expect incoming connections
to be SSL/TLS encrypted. Common port numbers for SSL-encrypted IRC are 6669
and 6697. Default: none.
Module: ngircd.git
Branch: master
Commit: 29c49f643fdaa5db2604d129a2dc3814e3f54700
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=29c49f64…
Author: Alexander Barton <alex(a)barton.de>
Date: Tue Jun 28 13:11:14 2011 +0200
doc/SSL.txt: adopt to new configuration file layout
---
doc/SSL.txt | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)
diff --git a/doc/SSL.txt b/doc/SSL.txt
index b98c2fb..28ea2cd 100644
--- a/doc/SSL.txt
+++ b/doc/SSL.txt
@@ -34,7 +34,7 @@ possible to handle unencrypted and encrypted connections on the same port!
This is a limitation of the IRC protocol ...
You have to set (at least) the following configuration variables in the
-[GLOBAL] section of ngircd.conf(5): SSLPorts, SSLKeyFile, and SSLCertFile.
+[SSL] section of ngircd.conf(5): Ports, KeyFile, and CertFile.
Now IRC clients are able to connect using SSL on the configured port(s).
(Using port 6697 for encrypted connections is common.)