ipadm_ifprop – Manage IP interface properties on Solaris/illumos systems

New in version 2.3.

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

Authors

  • Adam Števko (@xen0l)

Hint

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