The "rline" Module (v3)
Description
This module adds the /RLINE command which allows server operators to prevent users matching a nickname!username@hostname+realname regular expression from connecting to the server.
Configuration
To load this module use the following <module> tag:
<module name="rline">
<rline>
The <rline> tag defines settings about how the rline module should behave. This tag can only be defined once.
| Name | Type | Default Value | Description |
|---|---|---|---|
| engine | Text | None | The regular expression engine to use for checking matches. |
| matchonnickchange | Boolean | No | Whether to attempt to match users when they change their nickname. |
| zlineonmatch | Boolean | No | Whether to add a Z-line on the IP address of users that match a R-line. |
The engine field should be set to the name of a regular expression engine.
The following regular expression engines are included with InspIRCd:
| Engine | Module | Description |
|---|---|---|
| glob | regex_glob | Matches using a glob pattern. |
| pcre | regex_pcre | Matches using a PCRE regular expression. |
| pcre | regex_pcre2 | Matches using a PCRE2 regular expression. |
| posix | regex_posix | Matches using a POSIX regular expression. |
| re2 | regex_re2 | Matches using a RE2 regular expression. |
| stdregex | regex_stdlib | Matches using a C++11 std::regex regular expression. |
| tre | regex_tre | Deprecated! Matches using a TRE regular expression. |
Example Usage
<rline engine="pcre"
matchonnickchange="no"
zlineonmatch="no">
Commands
| Name | Parameter Count | Syntax | Description |
|---|---|---|---|
| RLINE | 1, 3 | <regex> [<duration> <reason>] | Allows server operators to add and remove regular expression bans on nickname!username@hostname+realname masks. |
Example Usage
The following examples assume that the "pcre" regex module is being used.
See the <rline> documentation above for more information.
Bans users connecting from example.com for one week:
/RLINE ^[^!]+![^@]+@example.com\+.+$ 7d :Trolling is forbidden
Bans users that have "BotBot" in their real name forever:
/RLINE ^[^!]+![^@]+@[^\+]+\+.*BotBot.*$ 0 :No bots allowed
Unbans users connecting from example.com:
/RLINE ^[^!]+![^@]+@example.com\+.+$
Statistics
| Character | Description |
|---|---|
| R | Lists all regular expression lines. |
Special Notes
R-lines are expired lazily when a lookup happens for performance reasons. This means that expiry messages may display later than expected.