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: Create Option</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> </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 <A HREF="dhcp_option_ref.html"><STRONG>Options</STRONG></A><BR> 65*0Sstevel@tonic-gate<IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Create<BR> 66*0Sstevel@tonic-gate <A HREF="#name"><EM>Name</EM></A><BR> 67*0Sstevel@tonic-gate <A HREF="#cat"><EM>Category</EM></A><BR> 68*0Sstevel@tonic-gate <A HREF="#code"><EM>Code</EM></A><BR> 69*0Sstevel@tonic-gate <A HREF="#type"><EM>Data Type</EM></A><BR> 70*0Sstevel@tonic-gate <A HREF="#gran"><EM>Granularity</EM></A><BR> 71*0Sstevel@tonic-gate <A HREF="#max"><EM>Maximum</EM></A><BR> 72*0Sstevel@tonic-gate <A HREF="#class"><EM>Class</EM></A><BR> 73*0Sstevel@tonic-gate <A HREF="dhcp_option_dup.html">Duplicate</A><BR> 74*0Sstevel@tonic-gate <A HREF="dhcp_option_mod.html">Modify</A><BR> 75*0Sstevel@tonic-gate <A HREF="dhcp_option_del.html">Delete</A><BR> 76*0Sstevel@tonic-gate <A HREF="dhcp_option_tags.html">Standard options</A> <P> 77*0Sstevel@tonic-gate 78*0Sstevel@tonic-gate<A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><P> 79*0Sstevel@tonic-gate<A HREF="dhcp_main_menus.html"><STRONG>Menus</STRONG></A><P> 80*0Sstevel@tonic-gate<A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A> 81*0Sstevel@tonic-gate 82*0Sstevel@tonic-gate 83*0Sstevel@tonic-gate </td> 84*0Sstevel@tonic-gate 85*0Sstevel@tonic-gate 86*0Sstevel@tonic-gate 87*0Sstevel@tonic-gate<!-- End contents block --> 88*0Sstevel@tonic-gate 89*0Sstevel@tonic-gate<!-- Start column rule --> 90*0Sstevel@tonic-gate 91*0Sstevel@tonic-gate <td colspan=1 width=5 bgcolor="#CCCCCC"> </td> 92*0Sstevel@tonic-gate 93*0Sstevel@tonic-gate<!-- End column spacer --> 94*0Sstevel@tonic-gate 95*0Sstevel@tonic-gate<!-- Start column spacer --> 96*0Sstevel@tonic-gate 97*0Sstevel@tonic-gate <td colspan=1 width=10 bgcolor="#FFFFFF"> </td> 98*0Sstevel@tonic-gate 99*0Sstevel@tonic-gate<!-- End column spacer --> 100*0Sstevel@tonic-gate 101*0Sstevel@tonic-gate 102*0Sstevel@tonic-gate 103*0Sstevel@tonic-gate<!-- Start topic block --> 104*0Sstevel@tonic-gate 105*0Sstevel@tonic-gate 106*0Sstevel@tonic-gate <td colspan=1 valign="top" bgcolor="#ffffff"> 107*0Sstevel@tonic-gate <P> </P> 108*0Sstevel@tonic-gate 109*0Sstevel@tonic-gate 110*0Sstevel@tonic-gate<h1>Create Option</h1> 111*0Sstevel@tonic-gate 112*0Sstevel@tonic-gateThe Create Option dialog box lets you create new option definitions in the 113*0Sstevel@tonic-gate<tt>dhcptab</tt> on the selected DHCP server. <p> 114*0Sstevel@tonic-gate 115*0Sstevel@tonic-gateSee <a href="dhcp_macros_about.html"> 116*0Sstevel@tonic-gateAbout Macros and Options</a>, for more information about defining DHCP options.<p> 117*0Sstevel@tonic-gateThe settings in the Create Option dialog box are described in the following table. 118*0Sstevel@tonic-gate<P><HR NOSHADE><P> 119*0Sstevel@tonic-gate 120*0Sstevel@tonic-gate 121*0Sstevel@tonic-gate <table border=0 cellspacing=4 cellpadding=3> 122*0Sstevel@tonic-gate 123*0Sstevel@tonic-gate <tr> 124*0Sstevel@tonic-gate <td width=100 valign="top"><a name="name"><STRONG>Name</STRONG></a></td> 125*0Sstevel@tonic-gate <td valign="top">The name of the option. 126*0Sstevel@tonic-gate Option names can be a maximum of 128 alphanumeric characters including spaces.</td> 127*0Sstevel@tonic-gate </tr> 128*0Sstevel@tonic-gate 129*0Sstevel@tonic-gate <tr> 130*0Sstevel@tonic-gate <td width=100 valign="top"><a name="cat"><STRONG>Category</STRONG></a></td> 131*0Sstevel@tonic-gate <td valign="top">The category of the option: 132*0Sstevel@tonic-gate The category can be one of Site, Extend, or Vendor.<P> 133*0Sstevel@tonic-gate <table border=0 cellspacing=3 cellpadding=3> 134*0Sstevel@tonic-gate 135*0Sstevel@tonic-gate 136*0Sstevel@tonic-gate <tr> 137*0Sstevel@tonic-gate <td width=100 valign="top"><U>Site</U></td> 138*0Sstevel@tonic-gate <td valign="top">User-defined option definitions, used for 139*0Sstevel@tonic-gate unique or custom purposes; accepts <a href="#code">Option 140*0Sstevel@tonic-gate Codes</a> <tt>128-254</tt>.</td> 141*0Sstevel@tonic-gate </tr> 142*0Sstevel@tonic-gate 143*0Sstevel@tonic-gate <tr> 144*0Sstevel@tonic-gate <td width=100 valign="top"><U>Extend</U></td> 145*0Sstevel@tonic-gate <td valign="top">Option definitions beyond the standard set, 146*0Sstevel@tonic-gate which may already be present in versions of the DHCP protocol 147*0Sstevel@tonic-gate being used on your server. Rather than upgrading your DHCP 148*0Sstevel@tonic-gate implementation, you can add extended options; accepts Option 149*0Sstevel@tonic-gate Codes <tt>77-127</tt>.</td> 150*0Sstevel@tonic-gate </tr> 151*0Sstevel@tonic-gate 152*0Sstevel@tonic-gate <tr> 153*0Sstevel@tonic-gate <td width=100 valign="top"><U>Vendor</U></td> 154*0Sstevel@tonic-gate <td valign="top">Hardware-, vendor-, or platform-specific option 155*0Sstevel@tonic-gate definitions; accepts Option Codes <tt>1-254</tt>. Selecting this 156*0Sstevel@tonic-gate context enables the <a href="#class">Client Class</a> 157*0Sstevel@tonic-gate parameter.</td> 158*0Sstevel@tonic-gate </tr> 159*0Sstevel@tonic-gate 160*0Sstevel@tonic-gate </table> 161*0Sstevel@tonic-gate </td> 162*0Sstevel@tonic-gate </tr> 163*0Sstevel@tonic-gate 164*0Sstevel@tonic-gate 165*0Sstevel@tonic-gate <tr> 166*0Sstevel@tonic-gate <td width=115 valign="top"><a name="code"><STRONG>Code</STRONG></a></td> 167*0Sstevel@tonic-gate <td valign="top">A unique numeric code to 168*0Sstevel@tonic-gate identify the option. Valid values depend on the option <a 169*0Sstevel@tonic-gate href="#cat">category</a>:<P> 170*0Sstevel@tonic-gate 171*0Sstevel@tonic-gate <table border=0 cellspacing=3 cellpadding=3> 172*0Sstevel@tonic-gate 173*0Sstevel@tonic-gate <tr> 174*0Sstevel@tonic-gate <td width=100 valign="top"><U>Extend</U></td> 175*0Sstevel@tonic-gate <td valign="top">Accepts code values of <tt>77-127</tt><P></TD> 176*0Sstevel@tonic-gate </tr> 177*0Sstevel@tonic-gate 178*0Sstevel@tonic-gate <tr> 179*0Sstevel@tonic-gate <td width=100 valign="top"><U>Site</U></td> 180*0Sstevel@tonic-gate <td valign="top">Accepts code values of <tt>128-254</tt><P></TD> 181*0Sstevel@tonic-gate </tr> 182*0Sstevel@tonic-gate 183*0Sstevel@tonic-gate <tr> 184*0Sstevel@tonic-gate <td width=100 valign="top"><U>Vendor</U></td> 185*0Sstevel@tonic-gate <td valign="top">Accepts code values of <tt>1-254</tt></td> 186*0Sstevel@tonic-gate </tr> 187*0Sstevel@tonic-gate 188*0Sstevel@tonic-gate</table> 189*0Sstevel@tonic-gate<P> 190*0Sstevel@tonic-gate</td> 191*0Sstevel@tonic-gate 192*0Sstevel@tonic-gate </tr> 193*0Sstevel@tonic-gate 194*0Sstevel@tonic-gate <tr> 195*0Sstevel@tonic-gate <td width=100 valign="top"><A NAME="type"><STRONG>Data Type</STRONG></A></td> 196*0Sstevel@tonic-gate <td valign="top">The type of data that is acceptable 197*0Sstevel@tonic-gate for options values:<P> 198*0Sstevel@tonic-gate 199*0Sstevel@tonic-gate <table border=0 cellspacing=3 cellpadding=3> 200*0Sstevel@tonic-gate 201*0Sstevel@tonic-gate <tr> 202*0Sstevel@tonic-gate <td width=100 valign="top"><u>Ascii</u></td> 203*0Sstevel@tonic-gate <td valign="top">ASCII text.</td> 204*0Sstevel@tonic-gate </tr> 205*0Sstevel@tonic-gate 206*0Sstevel@tonic-gate <tr> 207*0Sstevel@tonic-gate <td width=100 valign="top"><u>Boolean</u></td> 208*0Sstevel@tonic-gate <td valign="top">No value is associated with this data type. 209*0Sstevel@tonic-gate Presence of options of this type denote Boolean TRUE; absence 210*0Sstevel@tonic-gate denotes FALSE.</td> 211*0Sstevel@tonic-gate </tr> 212*0Sstevel@tonic-gate 213*0Sstevel@tonic-gate <tr> 214*0Sstevel@tonic-gate <td width=100 valign="top"><u>IP</u></td> 215*0Sstevel@tonic-gate <td valign="top">One or more Internet addresses in dotted decimal format.</td> 216*0Sstevel@tonic-gate </tr> 217*0Sstevel@tonic-gate <tr> 218*0Sstevel@tonic-gate <td width=100 valign="top"><u>Octet</u></td> 219*0Sstevel@tonic-gate <td valign="top">Uninterpreted ASCII representation of binary 220*0Sstevel@tonic-gate data; for example, a client ID.</td> 221*0Sstevel@tonic-gate </tr> 222*0Sstevel@tonic-gate <tr> 223*0Sstevel@tonic-gate <td width=100 valign="top"><u>Unumber8</u><BR><u>Unumber16</u><BR> 224*0Sstevel@tonic-gate<u>Unumber32</u><BR><u>Unumber64</u><BR> 225*0Sstevel@tonic-gate 226*0Sstevel@tonic-gate</td> 227*0Sstevel@tonic-gate <td valign="top">Unsigned number, where the trailing number indicates the number of bits in the number.</td> 228*0Sstevel@tonic-gate </tr> 229*0Sstevel@tonic-gate <tr> 230*0Sstevel@tonic-gate <td width=100 valign="top"><u>Snumber8</u><BR><u>Snumber16</u><BR> 231*0Sstevel@tonic-gate<u>Snumber32</u><BR><u>Snumber64</u><BR> 232*0Sstevel@tonic-gate</td> 233*0Sstevel@tonic-gate <td valign="top">Signed number, where the trailing number indicates the number of bits in the number.</td> 234*0Sstevel@tonic-gate </tr> 235*0Sstevel@tonic-gate 236*0Sstevel@tonic-gate </table> 237*0Sstevel@tonic-gate </td> 238*0Sstevel@tonic-gate </tr> 239*0Sstevel@tonic-gate 240*0Sstevel@tonic-gate 241*0Sstevel@tonic-gate <tr> 242*0Sstevel@tonic-gate <td width=100 valign="top"><a name="gran"><STRONG>Granularity</STRONG></a></td> 243*0Sstevel@tonic-gate <td valign="top">Specifies how many values of the given <a 244*0Sstevel@tonic-gate href="#type">data type</a> are required to make a complete option value. 245*0Sstevel@tonic-gate For example, a data type of <tt>IP</tt> and a granularity of <tt>2</tt> would 246*0Sstevel@tonic-gate mean that the option value would need to contain two IP addresses.</td> 247*0Sstevel@tonic-gate </tr> 248*0Sstevel@tonic-gate 249*0Sstevel@tonic-gate <tr> 250*0Sstevel@tonic-gate <td width=100 valign="top"><a name="max"><STRONG>Maximum</STRONG></a></td> 251*0Sstevel@tonic-gate <td valign="top">The maximum number of values of a 252*0Sstevel@tonic-gate given granularity that can be specified for the option. Building on the 253*0Sstevel@tonic-gate previous example, a maximum of <tt>2</tt>, with a granularity of 254*0Sstevel@tonic-gate <tt>2</tt> and a data type of <tt>IP</tt> would mean that the option 255*0Sstevel@tonic-gate value could contain a maximum of two pairs of IP addresses.<P> 256*0Sstevel@tonic-gate 257*0Sstevel@tonic-gate <table border=0> 258*0Sstevel@tonic-gate 259*0Sstevel@tonic-gate <tr> 260*0Sstevel@tonic-gate <td width=100 valign="top"><U>Unlimited</U></td> 261*0Sstevel@tonic-gate <td valign="top">No limit to the number of values; implies a 262*0Sstevel@tonic-gate maximum setting of <tt>0</tt>.</td> 263*0Sstevel@tonic-gate </tr> 264*0Sstevel@tonic-gate 265*0Sstevel@tonic-gate <tr> 266*0Sstevel@tonic-gate <td width=100 valign="top"><U>Specify</U></td> 267*0Sstevel@tonic-gate <td valign="top">A specific number indicating the maximum.</td> 268*0Sstevel@tonic-gate </tr> 269*0Sstevel@tonic-gate 270*0Sstevel@tonic-gate </table> 271*0Sstevel@tonic-gate </td> 272*0Sstevel@tonic-gate </tr> 273*0Sstevel@tonic-gate 274*0Sstevel@tonic-gate <tr> 275*0Sstevel@tonic-gate <td width=100 valign="top"><A NAME="class"><STRONG>Vendor Client Classes</STRONG></A></td> 276*0Sstevel@tonic-gate <td valign="top">This option is enabled only when the option 277*0Sstevel@tonic-gate <a href="#cat">category</a> is Vendor. It identifies the client class(es) with which the Vendor option is 278*0Sstevel@tonic-gate associated.<P> 279*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> 280*0Sstevel@tonic-gate Enter the client class and then press Enter. You can 281*0Sstevel@tonic-gate specify multiple client classes. Only those DHCP clients with a client 282*0Sstevel@tonic-gate class value matching one listed here will use the option.</td> 283*0Sstevel@tonic-gate </tr> 284*0Sstevel@tonic-gate 285*0Sstevel@tonic-gate </table> 286*0Sstevel@tonic-gate <P> 287*0Sstevel@tonic-gate 288*0Sstevel@tonic-gate 289*0Sstevel@tonic-gate<strong>Notify DHCP Server of Change:</STRONG> Check the box if 290*0Sstevel@tonic-gateyou want the DHCP server to reload the <tt>dhcptab</tt> immediately after 291*0Sstevel@tonic-gatethe data is written. Normally, you will want this to 292*0Sstevel@tonic-gatehappen. However, if you are making multiple changes, you may choose 293*0Sstevel@tonic-gateto wait so that the server reloads only after all the 294*0Sstevel@tonic-gatechanges are written. <P> 295*0Sstevel@tonic-gate <A HREF="#top"><small>return to top</small></A> 296*0Sstevel@tonic-gate 297*0Sstevel@tonic-gate<p> </p> 298*0Sstevel@tonic-gate<!-- Don't go past this line! --> 299*0Sstevel@tonic-gate 300*0Sstevel@tonic-gate </td> 301*0Sstevel@tonic-gate 302*0Sstevel@tonic-gate<!-- End topic block --> 303*0Sstevel@tonic-gate 304*0Sstevel@tonic-gate</tr> 305*0Sstevel@tonic-gate 306*0Sstevel@tonic-gate</table> 307*0Sstevel@tonic-gate 308*0Sstevel@tonic-gate<!-- End topic table --> 309*0Sstevel@tonic-gate 310*0Sstevel@tonic-gate</body> 311*0Sstevel@tonic-gate</html> 312
