Update for the changes in v4.6.0.

SadieCat · SadieCat · commit 432b71d65cf7 · 2025-02-28T13:54:38.000Z
diff --git a/docs/3/commands/_eline.yml b/docs/3/commands/_eline.yml
diff --git a/docs/3/commands/_eline.yml b/docs/3/commands/_eline.yml
@@ -0,0 +1,21 @@
+name: ELINE
+oper_only: true
+syntax: >-
+  <ident@host>[,<ident@host>]+ [<duration> <reason>]
+description: |-
+  If `<duration>` and `<reason>` are specified then exempts an ident@host mask from being affected by other (G, K, Z, etc) X-lines. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the E-line will be permanent.
+
+  Otherwise, if just `<ident@host>` is specified, removes an exemption on an ident@host mask.
+example:
+- description: |-
+    E-lines sadie@example.com for one day with the reason "Testing"
+  text: |-
+    /ELINE sadie@example.com 1d :Testing
+- description: |-
+    E-lines sadie@example.com for one day with the reason "Testing"
+  text: |-
+    /ELINE sadie@example.com 86400 :Testing
+- description: |-
+    Removes an E-line on sadie@example.com
+  text: |-
+    /ELINE sadie@example.com
diff --git a/docs/3/commands/_gline.yml b/docs/3/commands/_gline.yml
diff --git a/docs/3/commands/_gline.yml b/docs/3/commands/_gline.yml
@@ -0,0 +1,21 @@
+name: GLINE
+oper_only: true
+syntax: >-
+  <ident@host>[,<ident@host>]+ [<duration> <reason>]
+description: |-
+  If `<duration>` and `<reason>` are specified then bans an ident@host mask from connecting to the network. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the G-line will be permanent.
+
+  Otherwise, if just `<ident@host>` is specified, removes a network-wide ban on an ident@host mask.
+example:
+- description: |-
+    G-lines sadie@example.com for one day with the reason "Testing"
+  text: |-
+    /GLINE sadie@example.com 1d :Testing
+- description: |-
+    G-lines sadie@example.com for one day with the reason "Testing"
+  text: |-
+    /GLINE sadie@example.com 86400 :Testing
+- description: |-
+    Removes a G-line on sadie@example.com
+  text: |-
+    /GLINE sadie@example.com
diff --git a/docs/3/commands/_kline.yml b/docs/3/commands/_kline.yml
diff --git a/docs/3/commands/_kline.yml b/docs/3/commands/_kline.yml
@@ -0,0 +1,21 @@
+name: KLINE
+oper_only: true
+syntax: >-
+  <ident@host>[,<ident@host>]+ [<duration> <reason>]
+description: |-
+  If `<duration>` and `<reason>` are specified then bans an ident@host mask from connecting to the local server. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the K-line will be permanent.
+
+  Otherwise, if just `<ident@host>` is specified, removes a local server ban on an ident@host mask.
+example:
+- description: |-
+    K-lines sadie@example.com for one day with the reason "Testing"
+  text: |-
+    /KLINE sadie@example.com 1d :Testing
+- description: |-
+    K-lines sadie@example.com for one day with the reason "Testing"
+  text: |-
+    /KLINE sadie@example.com 86400 :Testing
+- description: |-
+    Removes a K-line on sadie@example.com
+  text: |-
+    /KLINE sadie@example.com
diff --git a/docs/3/commands/_qline.yml b/docs/3/commands/_qline.yml
diff --git a/docs/3/commands/_qline.yml b/docs/3/commands/_qline.yml
@@ -0,0 +1,21 @@
+name: QLINE
+oper_only: true
+syntax: >-
+  <nick>[,<nick>]+ [<duration> <reason>]
+description: |-
+  If `<duration>` and `<reason>` are specified then prevents a nickname from being used. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the Q-line will be permanent.
+
+  Otherwise, if just `<nick>` is specified, removes a reservation on a nickname.
+example:
+- description: |-
+    Q-lines Adam for one day with the reason "Testing"
+  text: |-
+    /QLINE Adam 1d :Testing
+- description: |-
+    Q-lines Sadie for one day with the reason "Testing"
+  text: |-
+    /QLINE Sadie 86400 :Testing
+- description: |-
+    Removes a Q-line on Adam
+  text: |-
+    /QLINE Adam
diff --git a/docs/3/commands/_zline.yml b/docs/3/commands/_zline.yml
diff --git a/docs/3/commands/_zline.yml b/docs/3/commands/_zline.yml
@@ -0,0 +1,21 @@
+name: ZLINE
+oper_only: true
+syntax: >-
+  <ipaddr>[,<ipaddr>]+ [<duration> <reason>]
+description: |-
+  If `<duration>` and `<reason>` are specified then bans an IP address or CIDR range from connecting to the network. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the Z-line will be permanent.
+
+  Otherwise, if just `<ipaddr>` is specified, removes a network-wide ban on an IP address.
+example:
+- description: |-
+    Z-lines 192.0.2.1 for one day with the reason "Testing"
+  text: |-
+    /ZLINE 192.0.2.1 1d :Testing
+- description: |-
+    Z-lines 192.0.2.0/24 for one day with the reason "Testing"
+  text: |-
+    /ZLINE 192.0.2.0/24 86400 :Testing
+- description: |-
+    Removes a Z-line on 192.0.2.1
+  text: |-
+    /ZLINE 192.0.2.1
diff --git a/docs/3/modules/rline.yml b/docs/3/modules/rline.yml
diff --git a/docs/3/modules/rline.yml b/docs/3/modules/rline.yml
@@ -0,0 +1,71 @@
+name: rline
+
+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:
+- name: rline
+  description: |-
+    The `<rline>` tag defines settings about how the rline module should behave. This tag can only be defined once.
+  attributes:
+  - name: engine
+    type: Text
+    required: false
+    default: null
+    description: |-
+      The regular expression engine to use for checking matches.
+  - name: matchonnickchange
+    type: Boolean
+    required: false
+    default: 'No'
+    description: |-
+      Whether to attempt to match users when they change their nickname.
+  - name: zlineonmatch
+    type: Boolean
+    required: false
+    default: 'No'
+    description: |-
+      Whether to add a Z-line on the IP address of users that match a R-line.
+  details: |-
+    The engine field should be set to the name of a regular expression engine.
+
+    {! {{ version }}/modules/_regex_table.md !}
+
+  example: |-
+    ```xml
+    <rline engine="pcre"
+           matchonnickchange="no"
+           zlineonmatch="no">
+    ```
+
+commands:
+- name: RLINE
+  param_count: 1, 3
+  oper_only: true
+  syntax: <regex> [<duration> <reason>]
+  description: |-
+    Allows server operators to add and remove regular expression bans on nickname!username@hostname+realname masks.
+  example:
+  - note: |-
+      The following examples assume that the "pcre" regex module is being used.
+
+      See the `<rline>` documentation above for more information.
+    description: |-
+      Bans users connecting from example.com for one week
+    text: |-
+      /RLINE ^[^!]+![^@]+@example.com\+.+$ 7d :Trolling is forbidden
+  - description: |-
+      Bans users that have "BotBot" in their real name forever
+    text: |-
+      /RLINE ^[^!]+![^@]+@[^\+]+\+.*BotBot.*$ 0 :No bots allowed
+  - description: |-
+      Unbans users connecting from example.com
+    text: |-
+      /RLINE ^[^!]+![^@]+@example.com\+.+$
+
+stats:
+- char: R
+  description: 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.
diff --git a/docs/4/change-log.md b/docs/4/change-log.md
@@ -6,6 +6,60 @@ title: v4 Change Log
 
 This page lists changes which have happened between releases.
 
+### InspIRCd 4.6.0
+
+**This version of InspIRCd was released on 2025-03-01.**
+
+- Added the `RPL_STATSCONN` numeric for compatibility with ircu.
+
+- Added the creating user's IP address to the chancreate oper snotice.
+
+- Added the real hostname and IP address of proxied WebSocket users to the whois output.
+
+- Added the user's IP address and userhost to the seenicks oper snotice.
+
+- Added the WebIRC origin name to the whois output.
+
+- Changed the `/ALLTIME` command to use the RPL_TIME numeric instead of a notice.
+
+- Changed the `/CBAN`, `/ELINE`, `/GLINE`, `/KLINE`, `/QLINE`, `/RLINE`, and `/ZLINE` commands to make the duration field optional (defaults to permanent).
+
+- Changed the dnsbl module to default to the record type if not otherwise specified.
+
+- Changed the httpd_stats module to pad base 64 output.
+
+- Deprecated support for bitmask-type DNSBL entries.
+
+- Fixed building the 005 numerics for users in removed connect classes.
+
+- Fixed finding the config file on portable installations (i.e. Windows).
+
+- Fixed linking against v3 servers when using the repeat module.
+
+- Fixed removing regular bans that look like an extban.
+
+- Fixed sending some rehash snotices to the announcement snomask character.
+
+- Fixed showing the correct mask when removing an extended ban.
+
+- Fixed the accuracy of human-readable durations when converting from the number of seconds.
+
+- Fixed the list of exemptions in the help.
+
+- Fixed the list of server notice masks.
+
+- Fixed TLS fingerprint fallback in SASL when using Atheme.
+
+- Improved the performance of the logging system.
+
+- Improved the time format used in `RPL_TIME`.
+
+- Optimised counting the local and global servers in `/LUSERS`.
+
+- Removed obsolete snotices sent when a server operator specifies the wrong server name in `/DIE` and `/RESTART`.
+
+- Updated the vendored libraries.
+
 ### InspIRCd 4.5.0
 
 **This version of InspIRCd was released on 2025-01-04.**
diff --git a/docs/4/commands/_eline.yml b/docs/4/commands/_eline.yml
@@ -1,9 +1,9 @@
 name: ELINE
 oper_only: true
 syntax: >-
-  <ident@host>[,<ident@host>]+ [<duration> <reason>]
+  <ident@host>[,<ident@host>]+ [[<duration>] <reason>]
 description: |-
-  If `<duration>` and `<reason>` are specified then exempts an ident@host mask from being affected by other (G, K, Z, etc) X-lines. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the E-line will be permanent.
+  If `<ident@host>` and `<reason>` are specified then exempts an ident@host mask from being affected by other (G, K, Z, etc) X-lines. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero or (since v4.6.0) is not specified then the E-line will be permanent.
 
   Otherwise, if just `<ident@host>` is specified, removes an exemption on an ident@host mask.
 example:
diff --git a/docs/4/commands/_gline.yml b/docs/4/commands/_gline.yml
@@ -1,9 +1,9 @@
 name: GLINE
 oper_only: true
 syntax: >-
-  <ident@host>[,<ident@host>]+ [<duration> <reason>]
+  <ident@host>[,<ident@host>]+ [[<duration>] <reason>]
 description: |-
-  If `<duration>` and `<reason>` are specified then bans an ident@host mask from connecting to the network. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the G-line will be permanent.
+  If `<ident@host> and `<reason>` are specified then bans an ident@host mask from connecting to the network. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero or (since v4.6.0) is not specified then the G-line will be permanent.
 
   Otherwise, if just `<ident@host>` is specified, removes a network-wide ban on an ident@host mask.
 example:
diff --git a/docs/4/commands/_kline.yml b/docs/4/commands/_kline.yml
@@ -1,9 +1,9 @@
 name: KLINE
 oper_only: true
 syntax: >-
-  <ident@host>[,<ident@host>]+ [<duration> <reason>]
+  <ident@host>[,<ident@host>]+ [[<duration>] <reason>]
 description: |-
-  If `<duration>` and `<reason>` are specified then bans an ident@host mask from connecting to the local server. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the K-line will be permanent.
+  If `<ident@host>` and `<reason>` are specified then bans an ident@host mask from connecting to the local server. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero or (since v4.6.0) is not specified then the K-line will be permanent.
 
   Otherwise, if just `<ident@host>` is specified, removes a local server ban on an ident@host mask.
 example:
diff --git a/docs/4/commands/_qline.yml b/docs/4/commands/_qline.yml
@@ -1,9 +1,9 @@
 name: QLINE
 oper_only: true
 syntax: >-
-  <nick>[,<nick>]+ [<duration> <reason>]
+  <nick>[,<nick>]+ [[<duration>] <reason>]
 description: |-
-  If `<duration>` and `<reason>` are specified then prevents a nickname from being used. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the Q-line will be permanent.
+  If `<nick>` and `<reason>` are specified then prevents a nickname from being used. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero or (since v4.6.0) is not specified then the Q-line will be permanent.
 
   Otherwise, if just `<nick>` is specified, removes a reservation on a nickname.
 example:
diff --git a/docs/4/commands/_zline.yml b/docs/4/commands/_zline.yml
@@ -1,9 +1,9 @@
 name: ZLINE
 oper_only: true
 syntax: >-
-  <ipaddr>[,<ipaddr>]+ [<duration> <reason>]
+  <ipaddr>[,<ipaddr>]+ [[<duration>] <reason>]
 description: |-
-  If `<duration>` and `<reason>` are specified then bans an IP address or CIDR range from connecting to the network. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero then the Z-line will be permanent.
+  If `<ipaddr>` and `<reason>` are specified then bans an IP address or CIDR range from connecting to the network. The `<duration>` may be specified as a number of seconds or as a duration in the format 1y2w3d4h5m6s. If the duration is zero or (since v4.6.0) is not specified then the Z-line will be permanent.
 
   Otherwise, if just `<ipaddr>` is specified, removes a network-wide ban on an IP address.
 example:
diff --git a/docs/4/modules/cban.yml b/docs/4/modules/cban.yml
@@ -7,7 +7,7 @@ commands:
 - name: CBAN
   param_count: 1-3
   oper_only: true
-  syntax: <channel> [<duration> [<reason>]]
+  syntax: <channel> [[<duration>] <reason>]
   description: |-
     Allows server operators to add and remove channel bans.
   example:
diff --git a/docs/4/modules/dnsbl.yml b/docs/4/modules/dnsbl.yml
@@ -53,7 +53,7 @@ configuration:
     required: false
     default: null
     description: |-
-      **Required for the bitmask type!** A bitmask of DNSBL result types to match against.
+      **Required for the bitmask type!** *Deprecated!* A bitmask of DNSBL result types to match against.
   - name: domain
     type: Text
     required: true
@@ -135,7 +135,7 @@ configuration:
 
     Value   | Description
     ------- | -----------
-    bitmask | DNSBL results will be compared against the [bit mask](https://en.wikipedia.org/wiki/Mask_(computing)) specified in the bitmask field to see if the IP address in question is in a DNSBL. For example, `15` would match against DNSBL result types 1, 2, 4, and 8.
+    bitmask | *Deprecated!* DNSBL results will be compared against the [bit mask](https://en.wikipedia.org/wiki/Mask_(computing)) specified in the bitmask field to see if the IP address in question is in a DNSBL. For example, `15` would match against DNSBL result types 1, 2, 4, and 8.
     record  | DNSBL results will be compared against a numeric range of values. For example, `1-3,4,5` would match all DNSBL result types between 1 and 5.
 
   example: |-
diff --git a/docs/4/modules/rline.yml b/docs/4/modules/rline.yml
@@ -42,7 +42,7 @@ commands:
 - name: RLINE
   param_count: 1, 3
   oper_only: true
-  syntax: <regex> [<duration> <reason>]
+  syntax: <regex> [[<duration>] <reason>]
   description: |-
     Allows server operators to add and remove regular expression bans on nickname!username@hostname+realname masks.
   example:
