xref: /illumos-gate/usr/src/cmd/cmd-inet/sbin/dhcpagent/dhcpagent.dfl (revision cb6207858a9fcc2feaee22e626912fba281ac969)
1#
2# CDDL HEADER START
3#
4# The contents of this file are subject to the terms of the
5# Common Development and Distribution License (the "License").
6# You may not use this file except in compliance with the License.
7#
8# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9# or http://www.opensolaris.org/os/licensing.
10# See the License for the specific language governing permissions
11# and limitations under the License.
12#
13# When distributing Covered Code, include this CDDL HEADER in each
14# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15# If applicable, add the following below this CDDL HEADER, with the
16# fields enclosed by brackets "[]" replaced with your own identifying
17# information: Portions Copyright [yyyy] [name of copyright owner]
18#
19# CDDL HEADER END
20#
21
22#
23# Copyright 2007 Sun Microsystems, Inc.  All rights reserved.
24# Use is subject to license terms.
25#
26#ident	"%Z%%M%	%I%	%E% SMI"
27#
28
29#
30# This file contains tunable parameters for dhcpagent(1M).
31#
32
33# All parameters can be tuned for a specific interface by prepending
34# the interface name to the parameter name.  For example, to make
35# RELEASE_ON_SIGTERM happen on all interfaces except hme0, specify:
36#
37# hme0.RELEASE_ON_SIGTERM=no
38# RELEASE_ON_SIGTERM=yes
39#
40# An interface name alone specifies IPv4 DHCP.  For DHCPv6, append ".v6".
41# Some examples:
42#
43# hme0.RELEASE_ON_SIGTERM=no	specify hme0 v4 behavior
44# hme0.v6.RELEASE_ON_SIGTERM=no	specify hme0 v6 behavior
45# RELEASE_ON_SIGTERM=no		match all v4 interfaces
46# .v6.RELEASE_ON_SIGTERM=no	match all v6 interfaces
47
48# By default, when the DHCP agent is sent a SIGTERM (typically when
49# the system is shut down), all managed addresses are dropped rather
50# than released.  Dropping an address does not notify the DHCP server
51# that the address is no longer in use, leaving it possibly available
52# for subsequent use by the same client.  If DHCP is later restarted
53# on the interface, the client will ask the server if it can continue
54# to use the address.  If the server either grants the request, or
55# does not answer (and the lease has not yet expired), then the client
56# will use the original address.
57#
58# By uncommenting the following parameter-value pairs, all managed
59# interfaces are released on SIGTERM instead.  In that case, the DHCP
60# server is notified that the address is available for use.  Further,
61# if DHCP is later restarted on the interface, the client will not
62# request its previous address from the server, nor will it attempt to
63# reuse the previous lease.  This behavior is often preferred for
64# roaming systems.
65#
66# RELEASE_ON_SIGTERM=yes
67# .v6.RELEASE_ON_SIGTERM=yes
68
69# By default, the DHCP agent waits 3 seconds to collect OFFER
70# responses to a DISCOVER.  If it receives no OFFERs in this time, it
71# then waits for another 3 seconds, and so forth.  To change this
72# behavior, set and uncomment the following parameter-value pair.
73# Note: this does not control the retransmission strategy for
74# DISCOVERs, which is formally specified in RFC 2131.  This parameter
75# is specified in seconds.
76#
77# OFFER_WAIT=
78
79# By default, the DHCP agent does not send out a client identifier
80# (and hence, the chaddr field is used by the DHCP server as the
81# client identifier.)  To make the DHCP agent send a client
82# identifier, set and uncomment the following parameter-value pair.
83# Note that by default this is treated as an NVT ASCII string.  To
84# specify a binary value, prepend "0x" to a sequence of hexadecimal
85# digits (for example, the value 0xAABBCC11 would set the client
86# identifier to the 4-byte binary sequence 0xAA 0xBB 0xCC 0x11).
87#
88# CLIENT_ID=
89
90# By default, the DHCP agent will try to request the hostname currently
91# associated with the interface performing DHCP.  If this option is
92# enabled, the agent will attempt to find a host name in /etc/hostname.<if>,
93# which must contain a line of the form
94#
95#	inet name
96#
97# where "name" is a single RFC 1101-compliant token.  If found, the token
98# will be used to request that host name from the DHCP server.  To prevent
99# this, uncomment the following line.
100#
101# REQUEST_HOSTNAME=no
102
103# By default, a parameter request list requesting a subnet mask (1),
104# router (3), DNS server (6), hostname (12), DNS domain (15), broadcast
105# address (28), and encapsulated vendor options (43), is sent to the DHCP
106# server when the DHCP agent sends requests.  However, if desired, this
107# can be changed by altering the following parameter-value pair.  The
108# numbers correspond to the values defined in the IANA bootp-dhcp-parameters
109# registry at the time of this writing.
110#
111PARAM_REQUEST_LIST=1,3,6,12,15,28,43
112
113# The default DHCPv6 parameter request list has preference (7), unicast (12),
114# DNS addresses (23), DNS search list (24), NIS addresses (27), and
115# NIS domain (29).  This may be changed by altering the following parameter-
116# value pair.  The numbers correspond to the values defined in the IANA
117# dhcpv6-parameters registry at the time of this writing.
118.v6.PARAM_REQUEST_LIST=7,12,23,24,27,29
119