Configuration file syntax

UnrealIRCd configuration files use a block-based format. Each entry or block has a specific format. The format works like:

block-name block-value { item value; }

  is the type of block, such as  for the Me block, or   for the Admin block.

  may not always be present, but if it is then it may have two meanings:
 * 1) sometimes it specifies a value, such as   in
 * 2) other times it defines a sub-type, like   in

  is an individual variable specific to the block.   is the associated value (if any). If the value contains spaces or characters that represents a comment it must be contained in double quotes like. (By the way, if you want to use a quote character inside a quoted string then use  and it will be understood as a quote character).

Finally, a   may also have directives in it (child items), and so on and so on.

Note: the configuration file is case sensitive so  is not the same as.

IMPORTANT : You must terminate each line with a   and terminate each block with a  . Only the start and end of the block (eg: ) has no terminating   character. If you forget a  or   somewhere then UnrealIRCd will fail to read your configuration file correctly and will not boot!

Examples: me { name "irc.something.net"; sid 001; info "Some nice server"; }

log ircd.log { flags { errors; } }

set { maxchannelsperuser 10;

options { hide-ulines; }       anti-flood { connect-flood 3:60; nick-flood 3:60; } }

Important : there is a special notation used to talk about entries in the config file and we use it throughout the UnrealIRCd documentation. Take the first example from above: in the  block the   is set to , we call this variable  . Similarly, in the last example we would refer to the  directive as  , and we call that block the   block. It does not mean you literally write  in the config file.

You can also put comments in the configuration file. Comments are text that isn't interpreted by UnrealIRCd and it's entirely up to you if you use it and what you write. UnrealIRCd supports 3 types of comments: // This is also a single line comment (type 2) /* This is a  multi line comment */
 * 1) This is a single line comment (type 1)

Now that you know how the configuration file works in principle, copy  to   and rename the file to. Then, walk through the unrealircd.conf file block per block, line by line. If you want to know more about a specific section that you read in unrealircd.conf, then see the top of the Configuration article for all the available blocks and directives.