7388 Support DHCP Client FQDN. Allow IAID/DUID for all v4.

@@ -13,11 +13,12 @@
      ipadm reset-ifprop [-t] -p prop -m protocol interface
      ipadm show-ifprop [[-c] -o field[,value]...] [-p prop[,prop]...]
            [-m protocol] [interface]
      ipadm create-addr [-t] -T static [-d]
            -a [local|remote=]addr[/prefixlen]... addrobj
-     ipadm create-addr [-t] -T dhcp [-w seconds|forever] addrobj
+     ipadm create-addr [-t] -T dhcp [-w seconds|forever] [-1] [-h hostname]
+           addrobj
      ipadm create-addr [-t] -T addrconf [-i interface-id]
            [-p {stateful|stateless}={yes|no}]... addrobj
      ipadm down-addr [-t] addrobj
      ipadm up-addr [-t] addrobj
      ipadm disable-addr [-t] addrobj

@@ -174,11 +175,12 @@
          Specify which properties to display. See the ipadm set-ifprop
          subcommand for the list of property names.
 
      ipadm create-addr [-t] -T static [-d] -a
        [local|remote=]addr[/prefixlen]... addrobj
-     ipadm create-addr [-t] -T dhcp [-w seconds|forever] addrobj
+     ipadm create-addr [-t] -T dhcp [-w seconds|forever] [-1] [-h hostname]
+       addrobj
      ipadm create-addr [-t] -T addrconf [-i interface-id] [-p
        {stateful|stateless}={yes|no}]... addrobj
        Create an address on an IP interface. The address will be enabled but
        can disabled using the ipadm disable-addr subcommand. This subcommand
        has three different forms, depending on the value of the -T option.

@@ -200,12 +202,28 @@
        -T dhcp
          Obtain the address via DHCP. This takes the following options:
 
          -w,--wait
            Specify the time, in seconds, that the command should wait to
-           obtain an address.
+           obtain an address; or specify forever to wait without interruption.
+           The default value is 120.
 
+         -1,--primary
+           Specify that the interface is primary.  One effect will be that
+           nodename(4) will serve as -h,--reqhost if that switch is not
+           otherwise specified.
+
+         -h,--reqhost
+           Specify the host name to send to the DHCP server in order to
+           request an association of a Fully Qualified Domain Name to the
+           interface. An FQDN is determined from hostname if it is "rooted"
+           (ending in a '.'), or if it consists of at least three DNS labels,
+           or by appending to hostname the value configured separately using
+           either defaultdomain(4) or resolv.conf(4).  N.b. that the DHCP
+           server implementation ultimately determines whether and how the
+           client-sent FQDN is used.
+
        -T addrconf
          Create an auto-configured address. This takes the following options:
 
          -i,--interface-id
            Specify the interface ID to be used.

@@ -295,13 +313,21 @@
          of the following:
          broadcast   The broadcast address (read-only).
          deprecated  The address should not be used to send packets but can
                      still receive packets (on/off).
          prefixlen   The number of bits in the IPv4 netmask or IPv6 prefix.
+         primary     The DHCP primary interface flag (read-only).
          private     The address is not advertised to routing (on/off).
+         reqhost     The host name to send to the DHCP server in order to
+                     request an association of an FQDN to the interface.  For
+                     a primary DHCP interface, nodename(4) is sent if this
+                     property is not defined.  See the ipadm create-addr -T
+                     dhcp subcommand for an explanation of how an FQDN is
+                     determined.
          transmit    Packets can be transmitted (on/off).
-         zone        The zone the addrobj is in.
+         zone        The zone the addrobj is in. (temporary-only.  Use
+                     zonecfg(1M) to make persistent).
 
        -t,--temporary
          Temporary, not persistent across reboots.
 
      ipadm reset-addrprop [-t] -p prop addrobj

@@ -402,8 +428,9 @@
          Specify which properties to display. See the ipadm set-prop
          subcommand for the list of property names.
 
 SEE ALSO
      arp(1M), cfgadm(1M), dladm(1M), if_mpadm(1M), ifconfig(1M), ndd(1M),
-     zonecfg(1M), nsswitch.conf(4), dhcp(5)
+     zonecfg(1M), defaultdomain(4), nodename(4), nsswitch.conf(4),
+     resolv.conf(4), dhcp(5)
 
-illumos                          April 9, 2016                         illumos
+illumos                        November 7, 2016                        illumos