excludeSubnets

Lists IPv4 and IPv6 CIDR subnets whose matching address literals are left unchanged.

This parameter applies to mmanon: IP Address Anonymization Module.

Name:

excludeSubnets

Scope:

input

Type:

array of IPv4 or IPv6 CIDR strings

Default:

input=empty

Required?:

no

Introduced:

8.2612.0

Description

When this array is empty or omitted, mmanon anonymizes addresses as before. Each entry must be an IPv4 or IPv6 address followed by a slash and a decimal prefix length, such as 192.0.2.0/24 or 2001:db8:1::/48. Invalid entries, including prefixes longer than 32 for IPv4 or 128 for IPv6, make configuration validation fail.

An address literal is excluded when its address family matches an entry and its prefix bits match. Thus 192.0.2.0/24 includes 192.0.2.0 through 192.0.2.255 but not 192.0.3.0. For an IPv6 address written with a dotted IPv4 tail, the full literal is preserved if either the IPv6 address matches an IPv6 entry or the dotted tail matches an IPv4 entry. Excluded literals are skipped by all mmanon address scanners, so the embedded tail is not anonymized later in the same action.

Input usage

RainerScript:

module(load="mmanon")
action(type="mmanon" excludeSubnets=["192.0.2.0/24", "2001:db8:1::/48"])

YAML:

modules:
  - load: mmanon
rulesets:
  - name: main
    actions:
      - type: mmanon
        excludeSubnets:
          - "192.0.2.0/24"
          - "2001:db8:1::/48"

See also

mmanon: IP Address Anonymization Module


Support: rsyslog Assistant | GitHub Discussions | GitHub Issues: rsyslog source project

Contributing: Source & docs: rsyslog source project

© 2008–2026 Rainer Gerhards and others. Licensed under the Apache License 2.0.