dladm_linkprop - Manage link properties on Solaris/illumos systems.

New in version 2.3.

Synopsis

Parameters

Parameter Choices/Defaults Comments
link
required
Link interface name.

aliases: nic, interface
property
required
Specifies the name of the property we want to manage.

aliases: name
state
    Choices:
  • present ←
  • absent
  • reset
Set or reset the property value.
temporary
bool
    Choices:
  • no ←
  • yes
Specifies that lin property configuration is temporary. Temporary link property configuration does not persist across reboots.
value
Specifies the value we want to set for the link property.

Examples

- name: Set 'maxbw' to 100M on e1000g1
  dladm_linkprop: name=e1000g1 property=maxbw value=100M state=present

- name: Set 'mtu' to 9000 on e1000g1
  dladm_linkprop: name=e1000g1 property=mtu value=9000

- name: Reset 'mtu' property on e1000g1
  dladm_linkprop: name=e1000g1 property=mtu state=reset

Return Values

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

Key Returned Description
link
string
always
link name

Sample:
e100g0
property
string
always
property name

Sample:
mtu
state
string
always
state of the target

Sample:
present
temporary
boolean
always
specifies if operation will persist across reboots

Sample:
True
value
string
always
property value

Sample:
9000


Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Adam Števko (@xen0l)

Hint

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