New configuration option "PAMIsOptional"

[ngircd-alex.git] / doc / sample-ngircd.conf.tmpl

diff --git a/doc/sample-ngircd.conf.tmpl b/doc/sample-ngircd.conf.tmpl
index 26103a759b938ef9fdc1739522b64462de5baaae..f696dc6de0a9d2335d20ded837ad4990f15367d2 100644 (file)
--- a/doc/sample-ngircd.conf.tmpl
+++ b/doc/sample-ngircd.conf.tmpl
@@ -140,6 +140,8 @@
        ;DNS = yes
 
        # Do IDENT lookups if ngIRCd has been compiled with support for it.
        ;DNS = yes
 
        # Do IDENT lookups if ngIRCd has been compiled with support for it.

+       # Users identified using IDENT are registered without the "~" character
+       # prepended to their user name.

        ;Ident = yes
 
        # Enhance user privacy slightly (useful for IRC server on TOR or I2P)
        ;Ident = yes
 
        # Enhance user privacy slightly (useful for IRC server on TOR or I2P)


@@ -160,8 +162,23 @@
        ;OperServerMode = no
 
        # Use PAM if ngIRCd has been compiled with support for it.
        ;OperServerMode = no
 
        # Use PAM if ngIRCd has been compiled with support for it.

+       # Users identified using PAM are registered without the "~" character
+       # prepended to their user name.

        ;PAM = yes
 
        ;PAM = yes
 

+       # When PAM is enabled, all clients are required to be authenticated
+       # using PAM; connecting to the server without successful PAM
+       # authentication isn't possible.
+       # If this option is set, clients not sending a password are still
+       # allowed to connect: they won't become "identified" and keep the "~"
+       # character prepended to their supplied user name.
+       # Please note: To make some use of this behavior, it most probably
+       # isn't useful to enable "Ident", "PAM" and "PAMIsOptional" at the
+       # same time, because you wouldn't be able to distinguish between
+       # Ident'ified and PAM-authenticated users: both don't have a "~"
+       # character prepended to their respective user names!
+       ;PAMIsOptional = no
+

        # Allow Pre-Defined Channels only (see Section [Channels])
        ;PredefChannelsOnly = no
 
        # Allow Pre-Defined Channels only (see Section [Channels])
        ;PredefChannelsOnly = no