.. _param-mmanon-ipv6-anonmode:
.. _mmanon.parameter.input.ipv6-anonmode:

ipv6.anonMode
=============

.. index::
   single: mmanon; ipv6.anonMode
   single: ipv6.anonMode

.. summary-start

Defines how IPv6 addresses are anonymized by the mmanon action.

.. summary-end

This parameter applies to :doc:`../../configuration/modules/mmanon`.

:Name: ipv6.anonMode
:Scope: input
:Type: string
:Default: input=zero
:Required?: no
:Introduced: 7.3.7

Description
-----------
The available modes are ``random``, ``random-consistent``, and ``zero``.

The modes ``random`` and ``random-consistent`` are very similar, in that they
both anonymize IP addresses by randomizing the last bits (any number) of a given
address. However, while ``random`` mode assigns a new random IP address for
every address in a message, ``random-consistent`` will assign the same
randomized address to every instance of the same original address.

The default ``zero`` mode will do full anonymization of any number of bits and it
will also normalize the address, so that no information about the original IP
address is available.

Also note that an anonymized IPv6 address will be normalized, meaning there will
be no abbreviations, leading zeros will **not** be displayed, and capital
letters in the hex numerals will be lowercase.

Input usage
-----------
.. _mmanon.parameter.input.ipv6-anonmode-usage:

.. code-block:: rsyslog

   module(load="mmanon")
   action(type="mmanon" ipv6.anonMode="random-consistent")

See also
--------
:doc:`../../configuration/modules/mmanon`
