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 
 112 The Duplicate Option dialog box provides a simple way to create a new option by copying some
 113 or all the properties of an existing option in the DHCP network tables. <p>
 114 
 115 See <a href="dhcp_macro_ref.html">
 116 About Macros and Options</a>, for more information about defining DHCP options.<p>
 117 The 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 
 289 you want the DHCP server to reload the <tt>dhcptab</tt> immediately after
 290 the data is written. Normally, you will want this to
 291 happen. However, if you are making multiple changes, you may choose
 292 to wait so that the server reloads only after all the
 293 changes 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>