ipadm_ifprop – Manage IP interface properties on Solaris/illumos systems

Synopsis

• Modify IP interface properties on Solaris/illumos systems.

Parameters

Parameter	Choices/Defaults	Comments
interface - / required		Specifies the IP interface we want to manage. aliases: nic
property - / required		Specifies the name of the property we want to manage. aliases: name
protocol - / required		Specifies the protocol for which we want to manage properties.
state -	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 -		Specifies the value we want to set for the property.

Examples

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

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

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

- name: Set IPv6 MTU on network interface bge0
  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

Status

• This module is not guaranteed to have a backwards compatible interface. [preview]
• This module is maintained by the Ansible Community. [community]

Authors

• Adam Števko (@xen0l)

Hint

If you notice any issues in this documentation, you can edit this document to improve it.