X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?p=ngircd-alex.git;a=blobdiff_plain;f=man%2Fngircd.conf.5.tmpl;h=e4446f96c6ae26e0f53933a9e097f7a23c5daac3;hp=935ac035f7775cf6a454fcf39c3dd3faeeb171fc;hb=03aec7d0b3e40faac852a26abdeb0242e8e77b3f;hpb=6a5569c27d47674b2e7483ddf6f1fafd8fe65a2e diff --git a/man/ngircd.conf.5.tmpl b/man/ngircd.conf.5.tmpl index 935ac035..e4446f96 100644 --- a/man/ngircd.conf.5.tmpl +++ b/man/ngircd.conf.5.tmpl @@ -1,7 +1,7 @@ .\" .\" ngircd.conf(5) manual page template .\" -.TH ngircd.conf 5 "Jan 2016" ngIRCd "ngIRCd Manual" +.TH ngircd.conf 5 "May 2020" ngIRCd "ngIRCd Manual" .SH NAME ngircd.conf \- configuration file of ngIRCd .SH SYNOPSIS @@ -83,7 +83,7 @@ blocks are used to configure pre-defined ("persistent") IRC channels. .PP There can be more than one [Operator], [Server] and [Channel] section per configuration file, one for each operator, server, and channel. [Global], -[Limits], [Options], and [SSL] sections can occure multiple times, too, but +[Limits], [Options], and [SSL] sections can occur multiple times, too, but each variable overwrites itself, only the last assignment is relevant. .SH [GLOBAL] The @@ -125,7 +125,7 @@ take effect when ngircd starts up or is instructed to re-read its configuration file. .TP \fBMotdPhrase\fR (string) -A simple Phrase (<256 chars) if you don't want to use a MOTD file. +A simple Phrase (<127 chars) if you don't want to use a MOTD file. .TP \fBNetwork\fR (string) The name of the IRC network to which this server belongs. This name is @@ -201,6 +201,12 @@ Maximum length of an user nickname (Default: 9, as in RFC 2812). Please note that all servers in an IRC network MUST use the same maximum nickname length! .TP +\fBMaxPenaltyTime\fR (number) +Maximum penalty time increase in seconds, per penalty event. Set to -1 for no +limit (the default), 0 to disable penalties altogether. ngIRCd doesn't use +penalty increases higher than 2 seconds during normal operation, so values +greater than 1 rarely make sense. +.TP \fBMaxListSize\fR (number) Maximum number of channels returned in response to a LIST command. Default: 100. .TP @@ -339,6 +345,14 @@ able to distinguish between Ident'ified and PAM-authenticated users: both don't have a "~" character prepended to their respective user names! Default: no. .TP +\fBPAMServiceName\fR (string) +When PAM is enabled, this value determines the used PAM configuration. +This setting allows running multiple ngIRCd instances with different +PAM configurations on each instance. If you set it to "ngircd-foo", +PAM will use /etc/pam.d/ngircd-foo instead of the default +/etc/pam.d/ngircd. +Default: ngircd. +.TP \fBRequireAuthPing\fR (boolean) Let ngIRCd send an "authentication PING" when a new client connects, and register this client only after receiving the corresponding "PONG" reply. @@ -418,7 +432,7 @@ Example: nick!ident@*.example.com Other servers are configured in .I [Server] sections. If you configure a port for the connection, then this ngIRCd -tries to connect to to the other server on the given port (active); +tries to connect to the other server on the given port (active); if not, it waits for the other server to connect (passive). .PP ngIRCd supports "server groups": You can assign an "ID" to every server @@ -496,10 +510,12 @@ Name of the channel, including channel prefix ("#" or "&"). Topic for this channel. .TP \fBModes\fR (string) -Initial channel modes. -.TP -\fBKey\fR (string) -Sets initial channel key (only relevant if channel mode "k" is set). +Initial channel modes, as used in "MODE" commands. Modifying lists (ban list, +invite list, exception list) is supported. +.PP +.RS +This option can be specified multiple times, evaluated top to bottom. +.RE .TP \fBKeyFile\fR (string) Path and file name of a "key file" containing individual channel keys for @@ -543,10 +559,6 @@ The file is not reopened on each access, so you can modify and overwrite it without problems, but moving or deleting the file will have not effect until the daemon re-reads its configuration! .RE -.TP -\fBMaxUsers\fR (number) -Set maximum user limit for this channel (only relevant if channel mode "l" -is set). .SH HINTS It's wise to use "ngircd \-\-configtest" to validate the configuration file after changing it. See