1*0Sstevel@tonic-gate<!--
2*0Sstevel@tonic-gate  -- ident	"%W%	%E% SMI"
3*0Sstevel@tonic-gate  --
4*0Sstevel@tonic-gate    CDDL HEADER START
5*0Sstevel@tonic-gate
6*0Sstevel@tonic-gate    The contents of this file are subject to the terms of the
7*0Sstevel@tonic-gate    Common Development and Distribution License, Version 1.0 only
8*0Sstevel@tonic-gate    (the "License").  You may not use this file except in compliance
9*0Sstevel@tonic-gate    with the License.
10*0Sstevel@tonic-gate
11*0Sstevel@tonic-gate    You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
12*0Sstevel@tonic-gate    or http://www.opensolaris.org/os/licensing.
13*0Sstevel@tonic-gate    See the License for the specific language governing permissions
14*0Sstevel@tonic-gate    and limitations under the License.
15*0Sstevel@tonic-gate
16*0Sstevel@tonic-gate    When distributing Covered Code, include this CDDL HEADER in each
17*0Sstevel@tonic-gate    file and include the License file at usr/src/OPENSOLARIS.LICENSE.
18*0Sstevel@tonic-gate    If applicable, add the following below this CDDL HEADER, with the
19*0Sstevel@tonic-gate    fields enclosed by brackets "[]" replaced with your own identifying
20*0Sstevel@tonic-gate    information: Portions Copyright [yyyy] [name of copyright owner]
21*0Sstevel@tonic-gate
22*0Sstevel@tonic-gate    CDDL HEADER END
23*0Sstevel@tonic-gate
24*0Sstevel@tonic-gate -- Copyright (c) 2000-2001 by Sun Microsystems, Inc.
25*0Sstevel@tonic-gate  -- All rights reserved.
26*0Sstevel@tonic-gate  -->
27*0Sstevel@tonic-gate<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
28*0Sstevel@tonic-gate<html>
29*0Sstevel@tonic-gate
30*0Sstevel@tonic-gate<head>
31*0Sstevel@tonic-gate<title>DHCP Manager Help: Options</title>
32*0Sstevel@tonic-gate<meta NAME="AUTHOR" CONTENT="smorgan">
33*0Sstevel@tonic-gate<meta NAME="KEYWORDS" CONTENT="DHCP">
34*0Sstevel@tonic-gate
35*0Sstevel@tonic-gate</head>
36*0Sstevel@tonic-gate
37*0Sstevel@tonic-gate<body bgcolor="#FFFFFF">
38*0Sstevel@tonic-gate
39*0Sstevel@tonic-gate<a name="top"></a>
40*0Sstevel@tonic-gate
41*0Sstevel@tonic-gate<table border=0 cellspacing=0 cellpadding=0 width=615>
42*0Sstevel@tonic-gate
43*0Sstevel@tonic-gate<!-- Start navigation banner -->
44*0Sstevel@tonic-gate
45*0Sstevel@tonic-gate<tr><td colspan=4  WIDTH="615" align="center" valign="top"><IMG SRC="art/bannersmc.gif" WIDTH=615 BORDER=0 ALT="DHCP Manager Help">
46*0Sstevel@tonic-gate
47*0Sstevel@tonic-gate	</td>
48*0Sstevel@tonic-gate	</tr>
49*0Sstevel@tonic-gate
50*0Sstevel@tonic-gate<!-- End navigation banner -->
51*0Sstevel@tonic-gate
52*0Sstevel@tonic-gate
53*0Sstevel@tonic-gate<tr>
54*0Sstevel@tonic-gate
55*0Sstevel@tonic-gate<!-- Start contents block -->
56*0Sstevel@tonic-gate
57*0Sstevel@tonic-gate	<td colspan=1 valign="top" width=105>
58*0Sstevel@tonic-gate	<P>&nbsp;</P>
59*0Sstevel@tonic-gate
60*0Sstevel@tonic-gate	<A HREF="dhcp_main_top.html"><STRONG>Overview</STRONG></A><P>
61*0Sstevel@tonic-gate	<A HREF="dhcp_relay_ref.html"><STRONG>Servers and Relays</STRONG></A><P>
62*0Sstevel@tonic-gate	<A HREF="dhcp_addr_ref.html"><STRONG>IP Addresses</STRONG></A><P>
63*0Sstevel@tonic-gate	<A HREF="dhcp_macro_ref.html"><STRONG>Macros</STRONG></A><P>
64*0Sstevel@tonic-gate<IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT=""><STRONG>Options</STRONG><BR>
65*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#name"><EM>Name</EM></A><BR>
66*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#cat"><EM>Category</EM></A><BR>
67*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#code"><EM>Code</EM></A><BR>
68*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#type"><EM>Type</EM></A><BR>
69*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#gran"><EM>Granularity</EM></A><BR>
70*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#max"><EM>Maximum</EM></A><BR>
71*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#class"><EM>Class</EM></A><BR>
72*0Sstevel@tonic-gate
73*0Sstevel@tonic-gate	&nbsp;&nbsp;<A HREF="dhcp_option_create.html">Create</A><BR>
74*0Sstevel@tonic-gate	&nbsp;&nbsp;<A HREF="dhcp_option_dup.html">Duplicate</A><BR>
75*0Sstevel@tonic-gate	&nbsp;&nbsp;<A HREF="dhcp_option_mod.html">Modify</A><BR>
76*0Sstevel@tonic-gate	&nbsp;&nbsp;<A HREF="dhcp_option_del.html">Delete</A><BR>
77*0Sstevel@tonic-gate    &nbsp;&nbsp;<A HREF="dhcp_option_tags.html">Standard options</A><P>
78*0Sstevel@tonic-gate
79*0Sstevel@tonic-gate<A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><P>
80*0Sstevel@tonic-gate<A HREF="dhcp_main_menus.html"><STRONG>Menus</STRONG></A><P>
81*0Sstevel@tonic-gate<A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A>
82*0Sstevel@tonic-gate
83*0Sstevel@tonic-gate
84*0Sstevel@tonic-gate		</td>
85*0Sstevel@tonic-gate
86*0Sstevel@tonic-gate
87*0Sstevel@tonic-gate
88*0Sstevel@tonic-gate<!-- End contents block -->
89*0Sstevel@tonic-gate
90*0Sstevel@tonic-gate<!-- Start column rule -->
91*0Sstevel@tonic-gate
92*0Sstevel@tonic-gate	<td colspan=1 width=5 bgcolor="#CCCCCC">&nbsp;</td>
93*0Sstevel@tonic-gate
94*0Sstevel@tonic-gate<!-- End column spacer -->
95*0Sstevel@tonic-gate
96*0Sstevel@tonic-gate<!-- Start column spacer -->
97*0Sstevel@tonic-gate
98*0Sstevel@tonic-gate	<td colspan=1 width=10 bgcolor="#FFFFFF">&nbsp;</td>
99*0Sstevel@tonic-gate
100*0Sstevel@tonic-gate<!-- End column spacer -->
101*0Sstevel@tonic-gate
102*0Sstevel@tonic-gate
103*0Sstevel@tonic-gate
104*0Sstevel@tonic-gate<!-- Start topic block -->
105*0Sstevel@tonic-gate
106*0Sstevel@tonic-gate
107*0Sstevel@tonic-gate	<td colspan=1 valign="top" bgcolor="#ffffff">
108*0Sstevel@tonic-gate	<P>&nbsp;</P>
109*0Sstevel@tonic-gate
110*0Sstevel@tonic-gate
111*0Sstevel@tonic-gate<h1>Options</h1>
112*0Sstevel@tonic-gate
113*0Sstevel@tonic-gateSelect the Options tab in the main window to see a list of options defined
114*0Sstevel@tonic-gatefor this DHCP server. Options are listed alphabetically by name.<P>
115*0Sstevel@tonic-gate
116*0Sstevel@tonic-gateOptions (or symbols) define the configuration parameters that the DHCP server passes to the clients.  See <A HREF="dhcp_macros_about.html">About Macros and Options</A> for a discussion of how to use macros and options and of the relationship between them.<P>
117*0Sstevel@tonic-gateYou can <A HREF="dhcp_option_create.html">add</A>, <A HREF="dhcp_option_mod.html">modify</A>, or <A HREF="dhcp_option_del.html">delete</A> an option by selecting it and
118*0Sstevel@tonic-gateclicking the appropriate entry in the Edit menu.<P>
119*0Sstevel@tonic-gate
120*0Sstevel@tonic-gateThe option settings are described below.
121*0Sstevel@tonic-gate<P><HR NOSHADE><P>
122*0Sstevel@tonic-gate
123*0Sstevel@tonic-gate	<table border=0 cellspacing=4 cellpadding=3>
124*0Sstevel@tonic-gate
125*0Sstevel@tonic-gate	<tr>
126*0Sstevel@tonic-gate	<td width=100 valign="top"><a name="name"><STRONG>Name</STRONG></a></td>
127*0Sstevel@tonic-gate	<td valign="top">The name of the option.
128*0Sstevel@tonic-gate	Option names can be a maximum of 128 alphanumeric characters including spaces.</td>
129*0Sstevel@tonic-gate	</tr>
130*0Sstevel@tonic-gate
131*0Sstevel@tonic-gate	<tr>
132*0Sstevel@tonic-gate	<td width=100 valign="top"><a name="cat"><STRONG>Category</STRONG></a></td>
133*0Sstevel@tonic-gate	<td valign="top">The category of the option:
134*0Sstevel@tonic-gate	The category can be one of Site, Extend, or Vendor.<P>
135*0Sstevel@tonic-gate	<table border=0 cellspacing=3 cellpadding=3>
136*0Sstevel@tonic-gate
137*0Sstevel@tonic-gate
138*0Sstevel@tonic-gate		<tr>
139*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Site</U></td>
140*0Sstevel@tonic-gate		<td valign="top">User-defined option definitions, used for
141*0Sstevel@tonic-gate		unique or custom purposes; accepts <a href="#code">Option
142*0Sstevel@tonic-gate		Codes</a> <tt>128-254</tt>.</td>
143*0Sstevel@tonic-gate		</tr>
144*0Sstevel@tonic-gate
145*0Sstevel@tonic-gate		<tr>
146*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Extend</U></td>
147*0Sstevel@tonic-gate		<td valign="top">Option definitions beyond the standard set,
148*0Sstevel@tonic-gate		which may already be present in versions of the DHCP protocol
149*0Sstevel@tonic-gate		being used on your server. Rather than upgrading your DHCP
150*0Sstevel@tonic-gate		implementation, you can add extended options; accepts Option
151*0Sstevel@tonic-gate		Codes <tt>77-127</tt>.</td>
152*0Sstevel@tonic-gate		</tr>
153*0Sstevel@tonic-gate
154*0Sstevel@tonic-gate		<tr>
155*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Vendor</U></td>
156*0Sstevel@tonic-gate		<td valign="top">Hardware-, vendor-, or platform-specific option
157*0Sstevel@tonic-gate		definitions; accepts Option Codes <tt>1-254</tt>. Selecting this
158*0Sstevel@tonic-gate		context enables the <a href="#class">Client Class</a>
159*0Sstevel@tonic-gate		parameter.</td>
160*0Sstevel@tonic-gate		</tr>
161*0Sstevel@tonic-gate
162*0Sstevel@tonic-gate		</table>
163*0Sstevel@tonic-gate		</td>
164*0Sstevel@tonic-gate		</tr>
165*0Sstevel@tonic-gate
166*0Sstevel@tonic-gate
167*0Sstevel@tonic-gate	<tr>
168*0Sstevel@tonic-gate	<td width=115 valign="top"><a name="code"><STRONG>Code</STRONG></a></td>
169*0Sstevel@tonic-gate	<td valign="top">A unique numeric code to
170*0Sstevel@tonic-gate	identify the option. Valid values depend on the option <a
171*0Sstevel@tonic-gate	href="#cat">category</a>:<P>
172*0Sstevel@tonic-gate
173*0Sstevel@tonic-gate	<table border=0 cellspacing=3 cellpadding=3>
174*0Sstevel@tonic-gate
175*0Sstevel@tonic-gate		<tr>
176*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Extend</U></td>
177*0Sstevel@tonic-gate		<td valign="top">Accepts code values of <tt>77-127</tt><P></TD>
178*0Sstevel@tonic-gate		</tr>
179*0Sstevel@tonic-gate
180*0Sstevel@tonic-gate		<tr>
181*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Site</U></td>
182*0Sstevel@tonic-gate		<td valign="top">Accepts code values of <tt>128-254</tt><P></TD>
183*0Sstevel@tonic-gate		</tr>
184*0Sstevel@tonic-gate
185*0Sstevel@tonic-gate		<tr>
186*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Vendor</U></td>
187*0Sstevel@tonic-gate		<td valign="top">Accepts code values of <tt>1-254</tt></td>
188*0Sstevel@tonic-gate		</tr>
189*0Sstevel@tonic-gate
190*0Sstevel@tonic-gate</table>
191*0Sstevel@tonic-gate<P>
192*0Sstevel@tonic-gate</td>
193*0Sstevel@tonic-gate
194*0Sstevel@tonic-gate	</tr>
195*0Sstevel@tonic-gate
196*0Sstevel@tonic-gate	<tr>
197*0Sstevel@tonic-gate	<td width=100 valign="top"><A NAME="type"><STRONG>Data Type</STRONG></A></td>
198*0Sstevel@tonic-gate	<td valign="top">The type of data that is acceptable
199*0Sstevel@tonic-gate	for options values:<P>
200*0Sstevel@tonic-gate
201*0Sstevel@tonic-gate		<table border=0 cellspacing=3 cellpadding=3>
202*0Sstevel@tonic-gate
203*0Sstevel@tonic-gate		<tr>
204*0Sstevel@tonic-gate		<td width=100 valign="top"><u>Ascii</u></td>
205*0Sstevel@tonic-gate		<td valign="top">ASCII text.</td>
206*0Sstevel@tonic-gate		</tr>
207*0Sstevel@tonic-gate
208*0Sstevel@tonic-gate		<tr>
209*0Sstevel@tonic-gate		<td width=100 valign="top"><u>Boolean</u></td>
210*0Sstevel@tonic-gate		<td valign="top">No value is associated with this data type.
211*0Sstevel@tonic-gate		Presence of options of this type denote Boolean TRUE; absence
212*0Sstevel@tonic-gate		denotes FALSE.</td>
213*0Sstevel@tonic-gate		</tr>
214*0Sstevel@tonic-gate
215*0Sstevel@tonic-gate		<tr>
216*0Sstevel@tonic-gate		<td width=100 valign="top"><u>IP</u></td>
217*0Sstevel@tonic-gate		<td valign="top">One or more Internet addresses in dotted decimal format.</td>
218*0Sstevel@tonic-gate		</tr>
219*0Sstevel@tonic-gate        <tr>
220*0Sstevel@tonic-gate		<td width=100 valign="top"><u>Octet</u></td>
221*0Sstevel@tonic-gate		<td valign="top">Uninterpreted ASCII representation of binary
222*0Sstevel@tonic-gate		data; for example, a client ID.</td>
223*0Sstevel@tonic-gate		</tr>
224*0Sstevel@tonic-gate		<tr>
225*0Sstevel@tonic-gate		<td width=100 valign="top"><u>Unumber8</u><BR><u>Unumber16</u><BR>
226*0Sstevel@tonic-gate<u>Unumber32</u><BR><u>Unumber64</u><BR>
227*0Sstevel@tonic-gate
228*0Sstevel@tonic-gate</td>
229*0Sstevel@tonic-gate		<td valign="top">Unsigned number, where the trailing number indicates the number of bits in the number.</td>
230*0Sstevel@tonic-gate		</tr>
231*0Sstevel@tonic-gate		<tr>
232*0Sstevel@tonic-gate		<td width=100 valign="top"><u>Snumber8</u><BR><u>Snumber16</u><BR>
233*0Sstevel@tonic-gate<u>Snumber32</u><BR><u>Snumber64</u><BR>
234*0Sstevel@tonic-gate</td>
235*0Sstevel@tonic-gate		<td valign="top">Signed number, where the trailing number indicates the number of bits in the number.</td>
236*0Sstevel@tonic-gate		</tr>
237*0Sstevel@tonic-gate
238*0Sstevel@tonic-gate	</table>
239*0Sstevel@tonic-gate	</td>
240*0Sstevel@tonic-gate	</tr>
241*0Sstevel@tonic-gate
242*0Sstevel@tonic-gate
243*0Sstevel@tonic-gate	<tr>
244*0Sstevel@tonic-gate	<td width=100 valign="top"><a name="gran"><STRONG>Granularity</STRONG></a></td>
245*0Sstevel@tonic-gate	<td valign="top">Specifies how many values of the given <a
246*0Sstevel@tonic-gate	href="#type">data type</a> are required to make a complete option value.
247*0Sstevel@tonic-gate	For example, a data type of <tt>IP</tt> and a granularity of <tt>2</tt> would
248*0Sstevel@tonic-gate	mean that the option value would need to contain two IP addresses.</td>
249*0Sstevel@tonic-gate	</tr>
250*0Sstevel@tonic-gate
251*0Sstevel@tonic-gate	<tr>
252*0Sstevel@tonic-gate	<td width=100 valign="top"><a name="max"><STRONG>Maximum</STRONG></a></td>
253*0Sstevel@tonic-gate	<td valign="top">The maximum number of values of a
254*0Sstevel@tonic-gate	given granularity that can be specified for the option. Building on the
255*0Sstevel@tonic-gate	previous example, a maximum of <tt>2</tt>, with a granularity of
256*0Sstevel@tonic-gate	<tt>2</tt> and a data type of <tt>IP</tt> would mean that the option
257*0Sstevel@tonic-gate	value could contain a maximum of two pairs of IP addresses.<P>
258*0Sstevel@tonic-gate
259*0Sstevel@tonic-gate		<table border=0>
260*0Sstevel@tonic-gate
261*0Sstevel@tonic-gate		<tr>
262*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Unlimited</U></td>
263*0Sstevel@tonic-gate		<td valign="top">No limit to the number of values; implies a
264*0Sstevel@tonic-gate		maximum setting of <tt>0</tt>.</td>
265*0Sstevel@tonic-gate		</tr>
266*0Sstevel@tonic-gate
267*0Sstevel@tonic-gate		<tr>
268*0Sstevel@tonic-gate		<td width=100 valign="top"><U>Specify</U></td>
269*0Sstevel@tonic-gate		<td valign="top">A specific number indicating the maximum.</td>
270*0Sstevel@tonic-gate		</tr>
271*0Sstevel@tonic-gate
272*0Sstevel@tonic-gate		</table>
273*0Sstevel@tonic-gate	</td>
274*0Sstevel@tonic-gate	</tr>
275*0Sstevel@tonic-gate
276*0Sstevel@tonic-gate		<tr>
277*0Sstevel@tonic-gate	<td width=100 valign="top"><A NAME="class"><STRONG>Vendor Client Classes</STRONG></A></td>
278*0Sstevel@tonic-gate	<td valign="top">This option is enabled only when the option
279*0Sstevel@tonic-gate	<a href="#cat">category</a> is Vendor. It identifies the client class(es) with which the Vendor option is
280*0Sstevel@tonic-gate	associated.<P>
281*0Sstevel@tonic-gate	The Class is an ASCII string representing the client machine type and/or operating system, for example, <TT>SUNW.Ultra5_10</TT>. This type of option makes it possible to define configuration parameters that are passed to all clients of the same class. <P>
282*0Sstevel@tonic-gate	Enter the client class and then press Enter. You can
283*0Sstevel@tonic-gate	specify multiple client classes. Only those DHCP clients with a client
284*0Sstevel@tonic-gate	class value matching one listed here will use the option.</td>
285*0Sstevel@tonic-gate	</tr>
286*0Sstevel@tonic-gate	</table>
287*0Sstevel@tonic-gate
288*0Sstevel@tonic-gate
289*0Sstevel@tonic-gate	&nbsp;&nbsp;&nbsp;<A HREF="#top"><small>return to top</small></A>
290*0Sstevel@tonic-gate
291*0Sstevel@tonic-gate
292*0Sstevel@tonic-gate<p>&nbsp;</p>
293*0Sstevel@tonic-gate
294*0Sstevel@tonic-gate<!-- Don't go past this line! -->
295*0Sstevel@tonic-gate
296*0Sstevel@tonic-gate	</td>
297*0Sstevel@tonic-gate
298*0Sstevel@tonic-gate<!-- End topic block -->
299*0Sstevel@tonic-gate
300*0Sstevel@tonic-gate</tr>
301*0Sstevel@tonic-gate
302*0Sstevel@tonic-gate</table>
303*0Sstevel@tonic-gate
304*0Sstevel@tonic-gate<!-- End topic table -->
305*0Sstevel@tonic-gate
306*0Sstevel@tonic-gate</body>
307*0Sstevel@tonic-gate</html>
308