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: How To... Macros</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 <A HREF="dhcp_main_top.html"><STRONG>Overview</STRONG></A><P> 60 <A HREF="dhcp_relay_ref.html"><STRONG>Servers and Relay Agents</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 <A HREF="dhcp_option_ref.html"><STRONG>Options</STRONG></A><P> 64 65 <A HREF="dhcp_main_how.html"><STRONG>How To..</STRONG></A><BR> 66 <A HREF="dhcp_relay_how.html">Servers/Relays</A><BR> 67 <A HREF="dhcp_addr_how.html">Addresses</A><BR> 68 <IMG SRC="art/tip2.gif" WIDTH=12 HEIGHT=10 BORDER=0 ALT="">Macros<BR> 69 <a href="#viewmacro"><EM>View</EM></a><BR> 70 <a href="#newmacro"><EM>Create</EM></a><BR> 71 <a href="#dupmacro"><EM>Duplicate</EM></a><BR> 72 <a href="#modmacro"><EM>Modify</EM></a><BR> 73 <a href="#delmacro"><EM>Delete</EM></a><BR> 74 75 <A HREF="dhcp_option_how.html">Options</A><P> 76 <A HREF="dhcp_main_menus.html"><STRONG>Menus</STRONG></A><P> 77 <A HREF="dhcp_main_idx.html"><STRONG>Index</STRONG></A> 78 79 </td> 80 81 <!-- End contents block --> 82 83 <!-- Start column rule --> 84 85 <td colspan=1 width=5 bgcolor="#CCCCCC"> </td> 86 87 <!-- End column spacer --> 88 89 <!-- Start column spacer --> 90 91 <td colspan=1 width=10 bgcolor="#FFFFFF"> </td> 92 93 <!-- End column spacer --> 94 95 96 97 <!-- Start topic block --> 98 99 <td colspan=1 valign="top" bgcolor="#ffffff"> 100 <P> </P> 101 <H1>How To: Macros</H1> 102 103 <strong><big><A NAME="viewmacro">View Macros</A></big></strong><p> 104 105 <strong>Choose the <A HREF="dhcp_macro_ref.html">Macros</A> tab in the main window.</strong><BR> 106 DHCP Manager displays a list of macros that have been configured 107 for this network. You can view the relationship between macros. Click on a macro to view its associated options. Click Properties from 108 the Edit menu to view a list of options and their values. <P> 109 110 <p> 111 <hr noshade> 112 <strong><big><A NAME="newmacro">Create a New Macro</A></big></strong><p> 113 114 <ol type=1> 115 116 <LI><strong>Choose the <A HREF="dhcp_macro_ref.html">Macros</A> tab in the main window.</strong><BR> 117 The DHCP Manager displays a list of macros that have been configured 118 for this network.</LI><P> 119 <LI><STRONG>Choose Create from the Edit menu.</STRONG><BR> 120 The <A HREF="dhcp_macro_create.html">Create Macro</A> dialog box opens.</LI><P> 121 <LI><strong>Enter a unique name for the new macro.</strong><BR> 122 The name must be unique within the server's DHCP table (<tt>dhcptab</TT>).<br> 123 (See the note about macro names at the end of this procedure.) 124 </LI><P> 125 <LI><strong>Enter the definition of the macro.</strong><BR> 126 This can be built by including other macros, or by defining values for 127 options to be included in the macro. The <A HREF="dhcp_option_tags.html">standard options</A> are described in the <tt>dhcp_inittab</tt>(4) man page</LI><P> 128 129 <li><strong>Click OK to accept your settings.</strong><BR> 130 131 The new macro definition is stored in the <tt>dhcptab</tt>.<p></li> 132 133 </ol><P> 134 135 <center> 136 <table border=1 cellspacing=3 cellpadding=5 WIDTH="380"> 137 138 <tr> 139 <td valign="middle" align="left" BGCOLOR="#EBEBEB"><a name="name">The</a> 140 important thing to remember when naming your macro is to give it the 141 same name as the resource or device in the category you want to control. 142 For example, to create a Client Class macro for configuring Ultra-5s<small><sup>TM</sup></small> 143 (which have the client class name <tt>SUNW,Ultra5_10</tt>), name your 144 macro <tt>SUNW.Ultra5_10</tt>. See <a 145 href="dhcp_macros_about.html#using">Using Macros and Options</a> for more 146 information.</td> 147 </tr> 148 149 </table> 150 151 </center> 152 <P><HR NOSHADE><P> 153 <strong><big><A NAME="dupmacro">Duplicate a Macro</A></big></strong> 154 <P> 155 The Duplicate command provides a simple way to create a 156 new macro with some or all of the properties of an 157 existing macro.<P> 158 159 <ol type=1> 160 161 <LI><strong>Choose the <A HREF="dhcp_macro_ref.html">Macros</A> tab in the main window.</strong><BR> 162 163 DHCP Manager displays a list of macros that have been configured for this network.<p></li> 164 165 <li><strong>Select the macro you want to copy, and then choose <A HREF="dhcp_macro_dup.html">Duplicate</A> from the 166 Edit window.</strong><BR> 167 The Duplicate Macro dialog box opens.</li><P> 168 169 <li><strong>Enter a name for the new macro.</strong><br> 170 (See the <a href="#name">note</a> about macro names at the end of the 171 previous procedure.)<P></LI> 172 <LI><strong>Modify the macro settings as desired.</strong></LI> 173 <P> 174 <LI><STRONG>Click OK to accept your 175 settings.</strong><BR> 176 The new macro definition is stored in the <tt>dhcptab</tt>.</li> 177 178 </ol> 179 180 <p><hr noshade><P> 181 <strong><big><A NAME="modmacro">Modify a Macro</A></big></strong><p> 182 183 <ol type=1> 184 185 <LI><strong>Choose the <A HREF="dhcp_macro_ref.html">Macros</A> tab in the main window.</strong><BR> 186 187 DHCP Manager displays a list of macros that have been configured for this network.<p></li> 188 189 <li><strong>Select the macro you want to edit, and then choose <A HREF="dhcp_macro_mod.html">Properties</A> from the 190 Edit window.</strong><BR> 191 The Macro Properties dialog box opens.<P></li> 192 193 <li><strong>Modify the macro settings as desired and click OK.</strong></LI> 194 </ol> 195 196 197 <p><HR noshade><P> 198 <strong><big><A NAME="delmacro">Delete a Macro</A></big></strong><p> 199 200 <ol type=1> 201 202 <LI><strong>Choose the <A HREF="dhcp_macro_ref.html">Macros</A> tab in the main window.</strong><BR> 203 DHCP Manager displays a list of macros that have been configured 204 for this network.</LI><P> 205 206 <li><strong>Select the macro to delete, and then choose <A HREF="dhcp_macro_del.html">Delete</A> from the 207 Edit window.</strong><BR> 208 The Delete Macro dialog box opens.<P></li> 209 210 <LI><strong>Click OK.</strong><BR> 211 The macro definition is deleted from the <tt>dhcptab</tt> 212 database.<p></li> 213 214 </ol> 215 216 217 218 <A HREF="#top"><small>return to top</small></A> 219 <p> </p> 220 221 222 <!-- Don't go past this line! --> 223 224 </td> 225 226 <!-- End topic block --> 227 228 </tr> 229 230 </table> 231 232 <!-- End topic table --> 233 234 </body> 235 </html>