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