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

@@ -10,12 +10,13 @@
 .\"
 .\"
 .\" Copyright (c) 2012, Joyent, Inc. All Rights Reserved
 .\" Copyright (c) 2013 by Delphix. All rights reserved.
 .\" Copyright 2014 Nexenta Systems, Inc.  All rights reserved.
+.\" Copyright (c) 2016, Chris Fraire <cfraire@me.com>.
 .\"
-.Dd April 9, 2016
+.Dd November 7, 2016
 .Dt IPADM 1M
 .Os
 .Sh NAME
 .Nm ipadm
 .Nd configure IP interfaces, addresses and protocols

@@ -68,10 +69,12 @@
 .Nm
 .Ic create-addr
 .Op Fl t
 .Fl T Cm dhcp
 .Op Fl w Ar seconds Ns | Ns Cm forever
+.Op Fl 1
+.Op Fl h Ar hostname
 .Ar addrobj
 .Nm
 .Ic create-addr
 .Op Fl t
 .Fl T Cm addrconf

@@ -409,10 +412,12 @@
 .Nm
 .Ic create-addr
 .Op Fl t
 .Fl T Cm dhcp
 .Op Fl w Ar seconds Ns | Ns Cm forever
+.Op Fl 1
+.Op Fl h Ar hostname
 .Ar addrobj
 .br
 .Nm
 .Ic create-addr
 .Op Fl t

@@ -452,11 +457,34 @@
 .El
 .It Fl T Cm dhcp
 Obtain the address via DHCP. This takes the following options:
 .Bl -tag -width ""
 .It Fl w Ns , Ns Fl -wait
-Specify the time, in seconds, that the command should wait to obtain an address.
+Specify the time, in seconds, that the command should wait to obtain an
+address; or specify
+.Cm forever
+to wait without interruption.  The default value is 120.
+.It Fl 1 Ns , Ns Fl -primary
+Specify that the interface is primary.  One effect will be that
+.Xr nodename 4
+will serve as
+.Fl h Ns , Ns Fl -reqhost
+if that switch is not otherwise specified.
+.It Fl h Ns , Ns Fl -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
+.Ar hostname
+if it is "rooted" (ending in a '.'), or if it consists of at least three
+DNS labels, or by appending to
+.Ar hostname
+the value configured separately using either
+.Xr defaultdomain 4
+or
+.Xr resolv.conf 4 .
+N.b. that the DHCP server implementation ultimately determines whether and
+how the client-sent FQDN is used.
 .El
 .It Fl T Cm addrconf
 Create an auto-configured address. This takes the following options:
 .Bl -tag -width ""
 .It Fl i Ns , Ns Fl -interface-id

@@ -629,18 +657,31 @@
 .It Cm deprecated
 The address should not be used to send packets but can still receive packets
 .Pq Cm on Ns / Ns Cm off .
 .It Cm prefixlen
 The number of bits in the IPv4 netmask or IPv6 prefix.
+.It Cm primary
+The DHCP primary interface flag (read-only).
 .It Cm private
 The address is not advertised to routing
 .Pq Cm on Ns / Ns Cm off .
+.It Cm 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,
+.Xr nodename 4
+is sent if this property is not defined.  See the
+.Nm
+.Ic create-addr
+.Fl T Cm dhcp
+subcommand for an explanation of how an FQDN is determined.
 .It Cm transmit
 Packets can be transmitted
 .Pq Cm on Ns / Ns Cm off .
 .It Cm zone
-The zone the addrobj is in.
+The zone the addrobj is in. (temporary-only.  Use
+.Xr zonecfg 1M
+to make persistent).
 .El
 .It Fl t Ns , Ns Fl -temporary
 Temporary, not persistent across reboots.
 .El
 .It Xo

@@ -828,7 +869,10 @@
 .Xr dladm 1M ,
 .Xr if_mpadm 1M ,
 .Xr ifconfig 1M ,
 .Xr ndd 1M ,
 .Xr zonecfg 1M ,
+.Xr defaultdomain 4 ,
+.Xr nodename 4 ,
 .Xr nsswitch.conf 4 ,
+.Xr resolv.conf 4 ,
 .Xr dhcp 5