Index Index for
Section 8
Index Alphabetical
listing for D
Bottom of page Bottom of
page		 

dhcpparm(8)


NAME

  dhcpparm - Daemon for client configuration


SYNOPSIS

  /usr/sbin/dhcpparm [-i interface] tag | symbol | name


OPTIONS

  -i interface
      Use this option on hardware that has two or more interfaces
      configurable by the Dynamic Host Configuration Protocol (DHCP), and for
      a parameter that is interface specific. When no interface is specified,
      the client daemon returns the name of the first interface it finds on
      which DHCP has successfully completed: the value(s) displayed will be
      those of the configuration received on that interface.


DESCRIPTION

  The dhcpparm command displays the value(s) of the parameter requested on
  the command line as supplied by the DHCP protocol.  If the DHCP parameter
  implies more than one value (for example, a list of gateways), the values
  are displayed separated by newline characters. The parameter may be
  identified either by its numeric value in the DHCP protocol, by its two
  character symbol, or by its long name. The dhcpparm command is intended to
  be used in command substitutions in the shell scripts invoked by init at
  system boot.	It first contacts the DHCP client daemon (joinc) to verify
  that DHCP has successfully completed. When the -i option specifies a
  particular interface, the daemon verifies successful DHCP configuration of
  that interface; otherwise, the client verifies that at least one interface
  is successfully configured, and supplies the name of that interface to
  dhcpparm.  Parameter values echoed by dhcpparm should not be used without
  checking exit status. See the EXIT STATUS section below.


RESTRICTIONS

  A cluster member should never be a DHCP client; it should always use static
  addressing.

  If a cluster is to support a DHCP server, there can only be one DHCP server
  for all the cluster members using a common database with failover.

  If a cluster is to support a DHCP server, there can only be one DHCP server
  for all the cluster members using a common database with failover.

  DHCP client is not supported on dataless clients.


SYMBOLS

  See dhcptags(4) for the list of two letter symbol codes and names of all
  DHCP parameters. See RFC 1533 for more detail.


EXIT STATUS

  Exit codes are as follows:

  0   Success.

  2   DHCP was not successful. The DHCP client daemon may not be running, the
      interface might have failed to configure, or no satisfactory DHCP
      responses were received.

  3   Bad arguments.

  4   A timer was set and the interface had not configured before it expired.

  5   Can only be run as root.

  6   Some system error (should never occur).


SEE ALSO

  Commands: dhcpconf(8), joinc(8), showdhc(8), shleases(8)

  Files: client.pcy(4), dhcptags(4)

  RFC1533

Index Index for
Section 8
Index Alphabetical
listing for D
Top of page Top of
page