community.network.ipadm_ifprop – Manage IP interface properties on Solaris/illumos systems.

Note

This plugin is part of the community.network collection (version 2.1.1).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.ipadm_ifprop.

Synopsis

  • Modify IP interface properties on Solaris/illumos systems.

Parameters

Parameter Choices/Defaults Comments
interface
string / required
Specifies the IP interface we want to manage.

aliases: nic
property
string / required
Specifies the name of the property we want to manage.

aliases: name
protocol
string / required
Specifies the protocol for which we want to manage properties.
state
string
    Choices:
  • present ←
  • absent
  • reset
Set or reset the property value.
temporary
boolean
    Choices:
  • no ←
  • yes
Specifies that the property value is temporary. Temporary property values do not persist across reboots.
value
string
Specifies the value we want to set for the property.

Examples

- name: Allow forwarding of IPv4 packets on network interface e1000g0
  community.network.ipadm_ifprop: protocol=ipv4 property=forwarding value=on interface=e1000g0

- name: Temporarily reset IPv4 forwarding property on network interface e1000g0
  community.network.ipadm_ifprop: protocol=ipv4 interface=e1000g0  temporary=true property=forwarding state=reset

- name: Configure IPv6 metric on network interface e1000g0
  community.network.ipadm_ifprop: protocol=ipv6 nic=e1000g0 name=metric value=100

- name: Set IPv6 MTU on network interface bge0
  community.network.ipadm_ifprop: interface=bge0 name=mtu value=1280 protocol=ipv6

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
interface
string
always
interface name we want to set property on

Sample:
e1000g0
property
string
always
property's name

Sample:
mtu
protocol
string
always
property's protocol

Sample:
ipv4
state
string
always
state of the target

Sample:
present
value
string
when value is provided
property's value

Sample:
1280


Authors

  • Adam Števko (@xen0l)