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