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: Create Option</title> 32 <meta NAME="AUTHOR" CONTENT="smorgan"> 33 <meta NAME="KEYWORDS" CONTENT="DHCP"> 34 35 </head> 36 37 <body bgcolor="#FFFFFF"> 38 39 <a name="top"></a> 40 41 <table border=0 cellspacing=0 cellpadding=0 width=615> 42 43 <!-- Start navigation banner --> 44 45 <tr><td colspan=4 WIDTH="615" align="center" valign="top"><IMG SRC="art/bannersmc.gif" WIDTH=615 BORDER=0 ALT="DHCP Manager Help"> 46 47 </td> 48 </tr> 49 50 <!-- End navigation banner --> 51 52 53 <tr> 54 55 <!-- Start contents block --> 56 57 <td colspan=1 valign="top" width=105> 58 <P> </P> 59 60 <A HREF="dhcp_main_top.html"><STRONG>Overview</STRONG></A><P> 61 <A HREF="dhcp_relay_ref.html"><STRONG>Servers and Relays</STRONG></A><P> 62 <A HREF="dhcp_addr_ref.html"><STRONG>IP Addresses</STRONG></A><P> 63 <A HREF="dhcp_macro_ref.html"><STRONG>Macros</STRONG></A><P> 64 <A HREF="dhcp_option_ref.html"><STRONG>Options</STRONG></A><BR> 65 <IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Create<BR> 66 <A HREF="#name"><EM>Name</EM></A><BR> 67 <A HREF="#cat"><EM>Category</EM></A><BR> 68 <A HREF="#code"><EM>Code</EM></A><BR> 69 <A HREF="#type"><EM>Data Type</EM></A><BR> 70 <A HREF="#gran"><EM>Granularity</EM></A><BR> 71 <A HREF="#max"><EM>Maximum</EM></A><BR> 72 <A HREF="#class"><EM>Class</EM></A><BR> 73 <A HREF="dhcp_option_dup.html">Duplicate</A><BR> 74 <A HREF="dhcp_option_mod.html">Modify</A><BR> 75 <A HREF="dhcp_option_del.html">Delete</A><BR> 76 <A HREF="dhcp_option_tags.html">Standard options</A> <P> 77 78 <A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><P> 79 <A HREF="dhcp_main_menus.html"><STRONG>Menus</STRONG></A><P> 80 <A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A> 81 82 83 </td> 84 85 86 87 <!-- End contents block --> 88 89 <!-- Start column rule --> 90 91 <td colspan=1 width=5 bgcolor="#CCCCCC"> </td> 92 93 <!-- End column spacer --> 94 95 <!-- Start column spacer --> 96 97 <td colspan=1 width=10 bgcolor="#FFFFFF"> </td> 98 99 <!-- End column spacer --> 100 101 102 103 <!-- Start topic block --> 104 105 106 <td colspan=1 valign="top" bgcolor="#ffffff"> 107 <P> </P> 108 109 110 <h1>Create Option</h1> 111 112 The Create Option dialog box lets you create new option definitions in the 113 <tt>dhcptab</tt> on the selected DHCP server. <p> 114 115 See <a href="dhcp_macros_about.html"> 116 About Macros and Options</a>, for more information about defining DHCP options.<p> 117 The settings in the Create Option dialog box are described in the following table. 118 <P><HR NOSHADE><P> 119 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 <P> 190 </td> 191 192 </tr> 193 194 <tr> 195 <td width=100 valign="top"><A NAME="type"><STRONG>Data Type</STRONG></A></td> 196 <td valign="top">The type of data that is acceptable 197 for options values:<P> 198 199 <table border=0 cellspacing=3 cellpadding=3> 200 201 <tr> 202 <td width=100 valign="top"><u>Ascii</u></td> 203 <td valign="top">ASCII text.</td> 204 </tr> 205 206 <tr> 207 <td width=100 valign="top"><u>Boolean</u></td> 208 <td valign="top">No value is associated with this data type. 209 Presence of options of this type denote Boolean TRUE; absence 210 denotes FALSE.</td> 211 </tr> 212 213 <tr> 214 <td width=100 valign="top"><u>IP</u></td> 215 <td valign="top">One or more Internet addresses in dotted decimal format.</td> 216 </tr> 217 <tr> 218 <td width=100 valign="top"><u>Octet</u></td> 219 <td valign="top">Uninterpreted ASCII representation of binary 220 data; for example, a client ID.</td> 221 </tr> 222 <tr> 223 <td width=100 valign="top"><u>Unumber8</u><BR><u>Unumber16</u><BR> 224 <u>Unumber32</u><BR><u>Unumber64</u><BR> 225 226 </td> 227 <td valign="top">Unsigned number, where the trailing number indicates the number of bits in the number.</td> 228 </tr> 229 <tr> 230 <td width=100 valign="top"><u>Snumber8</u><BR><u>Snumber16</u><BR> 231 <u>Snumber32</u><BR><u>Snumber64</u><BR> 232 </td> 233 <td valign="top">Signed number, where the trailing number indicates the number of bits in the number.</td> 234 </tr> 235 236 </table> 237 </td> 238 </tr> 239 240 241 <tr> 242 <td width=100 valign="top"><a name="gran"><STRONG>Granularity</STRONG></a></td> 243 <td valign="top">Specifies how many values of the given <a 244 href="#type">data type</a> are required to make a complete option value. 245 For example, a data type of <tt>IP</tt> and a granularity of <tt>2</tt> would 246 mean that the option value would need to contain two IP addresses.</td> 247 </tr> 248 249 <tr> 250 <td width=100 valign="top"><a name="max"><STRONG>Maximum</STRONG></a></td> 251 <td valign="top">The maximum number of values of a 252 given granularity that can be specified for the option. Building on the 253 previous example, a maximum of <tt>2</tt>, with a granularity of 254 <tt>2</tt> and a data type of <tt>IP</tt> would mean that the option 255 value could contain a maximum of two pairs of IP addresses.<P> 256 257 <table border=0> 258 259 <tr> 260 <td width=100 valign="top"><U>Unlimited</U></td> 261 <td valign="top">No limit to the number of values; implies a 262 maximum setting of <tt>0</tt>.</td> 263 </tr> 264 265 <tr> 266 <td width=100 valign="top"><U>Specify</U></td> 267 <td valign="top">A specific number indicating the maximum.</td> 268 </tr> 269 270 </table> 271 </td> 272 </tr> 273 274 <tr> 275 <td width=100 valign="top"><A NAME="class"><STRONG>Vendor Client Classes</STRONG></A></td> 276 <td valign="top">This option is enabled only when the option 277 <a href="#cat">category</a> is Vendor. It identifies the client class(es) with which the Vendor option is 278 associated.<P> 279 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> 280 Enter the client class and then press Enter. You can 281 specify multiple client classes. Only those DHCP clients with a client 282 class value matching one listed here will use the option.</td> 283 </tr> 284 285 </table> 286 <P> 287 288 289 <strong>Notify DHCP Server of Change:</STRONG> Check the box if 290 you want the DHCP server to reload the <tt>dhcptab</tt> immediately after 291 the data is written. Normally, you will want this to 292 happen. However, if you are making multiple changes, you may choose 293 to wait so that the server reloads only after all the 294 changes are written. <P> 295 <A HREF="#top"><small>return to top</small></A> 296 297 <p> </p> 298 <!-- Don't go past this line! --> 299 300 </td> 301 302 <!-- End topic block --> 303 304 </tr> 305 306 </table> 307 308 <!-- End topic table --> 309 310 </body> 311 </html>