New in version 2.3.
| parameter | required | default | choices | comments |
|---|---|---|---|---|
| local_address | no | Literat IP address or hostname corresponding to the tunnel source. aliases: local | ||
| name | yes | IP tunnel interface name. aliases: tunnel, link | ||
| remote_address | no | Literal IP address or hostname corresponding to the tunnel destination. aliases: remote | ||
| state | no | present |
| Create or delete Solaris/illumos VNIC. |
| temporary | no | Specifies that the IP tunnel interface is temporary. Temporary IP tunnel interfaces do not persist across reboots. | ||
| type | no | ipv4 |
| Specifies the type of tunnel to be created. |
name: Create IPv4 tunnel interface 'iptun0' dladm_iptun: name=iptun0 local_address=192.0.2.23 remote_address=203.0.113.10 state=present name: Change IPv4 tunnel remote address dladm_iptun: name=iptun0 type=ipv4 local_address=192.0.2.23 remote_address=203.0.113.11 name: Create IPv6 tunnel interface 'tun0' dladm_iptun: name=tun0 type=ipv6 local_address=192.0.2.23 remote_address=203.0.113.42 name: Remove 'iptun0' tunnel interface dladm_iptun: name=iptun0 state=absent
Common return values are documented here Return Values, the following are the fields unique to this module:
| name | description | returned | type | sample |
|---|---|---|---|---|
| state | state of the target | always | string | present |
| temporary | specifies if operation will persist across reboots | always | boolean | True |
| name | tunnel interface name | always | string | iptun0 |
| local_address | local IP address | always | string | 1.1.1.1/32 |
| type | tunnel type | always | string | ipv4 |
| remote_address | remote IP address | always | string | 2.2.2.2/32 |
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.
© 2012–2017 Michael DeHaan
© 2017 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/dladm_iptun_module.html