ipadm_addr - Manage IP addresses on an interface on Solaris/illumos systems

New in version 2.3.


  • Create/delete static/dynamic IP addresses on network interfaces on Solaris/illumos systems.
  • Up/down static/dynamic IP addresses on network interfaces on Solaris/illumos systems.
  • Manage IPv6 link-local addresses on network interfaces on Solaris/illumos systems.


parameter required default choices comments
Specifiies an IP address to configure in CIDR notation.

aliases: addr
Specifies an unique IP address on the system.
no static
  • static
  • dhcp
  • addrconf
Specifiies a type of IP address to configure.
no present
  • absent
  • present
  • up
  • down
  • enabled
  • disabled
  • refreshed
Create/delete/enable/disable an IP address on the network interface.
Specifies that the configured IP address is temporary. Temporary IP addresses do not persist across reboots.
no 60
Specifies the time in seconds we wait for obtaining address via DHCP.


name: Configure IP address on e1000g0
ipadm_addr: addr= addrobj=e1000g0/v4 state=present

name: Delete addrobj
ipadm_addr: addrobj=e1000g0/v4 state=absent

name: Configure link-local IPv6 address
ipadm_addr: addtype=addrconf addrobj=vnic0/v6

name: Configure address via DHCP and wait 180 seconds for address obtaining
ipadm_addr: addrobj=vnic0/dhcp addrtype=dhcp wait=180

Return Values

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

name description returned type sample
addrtype address type always string static
state state of the target always string present
temporary specifies if operation will persist across reboots always boolean True
address IP address only if addrtype is 'static' string
wait time we wait for DHCP only if addrtype is 'dhcp' string 10
addrobj address object name always string bge0/v4


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


This module is community maintained without core committer oversight.

For more information on what this means please read Module Support

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Helping Testing PRs and Developing Modules.