From: Ted Lemon Date: Sat, 8 Jan 2000 01:48:17 +0000 (+0000) Subject: Move vendor class stuff to dhcp-options manual page. X-Git-Tag: V3-BETA-2-PATCH-1~438 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e45ac254a3c0127b2aa2791ec8f194d8a28b77cb;p=thirdparty%2Fdhcp.git Move vendor class stuff to dhcp-options manual page. --- diff --git a/server/dhcpd.conf.5 b/server/dhcpd.conf.5 index fc40b5aed..b2ee943a0 100644 --- a/server/dhcpd.conf.5 +++ b/server/dhcpd.conf.5 @@ -1271,87 +1271,6 @@ to using the server-identifier statement. DHCP option statements are documented in the .B dhcp-options(5) manual page. -.SH VENDOR ENCAPSULATED OPTIONS -The DHCP protocol defines the \fB vendor-encapsulated-options\fR -option, which allows vendors to define their own options that will be -sent encapsulated in a standard DHCP option. The format of the -.B vendor-encapsulated-options -option is either a hunk of opaque data, or an actual option buffer -just like a standard DHCP option buffer. -.PP -You can send this option to clients in one of two ways - either define -the data directly, using a text string or a colon-seperated list of -hexadecimal values, or define an option space, define some options in -that option space, provide values for them, and specify that that -option space should be used to generate the -.B vendor-encapsulated-options -option in some scope. -.PP -To send a simple clump of data, simply provide a value for the option -in the right scope - for example: -.PP -.nf - option vendor-encapsulated-options - 2:4:AC:11:41:1: - 3:12:73:75:6e:64:68:63:70:2d:73:65:72:76:65:72:31:37:2d:31: - 4:12:2f:65:78:70:6f:72:74:2f:72:6f:6f:74:2f:69:38:36:70:63; -.fi -.PP -To define a new option space in which vendor options can be stored, -use the \fRoption space\fP statement: -.PP -.B option -.B space -.I name -.B ; -.PP -The name can then be used in option definitions, as described in -the -.B dhcp-options(5) -manual page. For example: -.nf - - option space SUNW; - option SUNW.server-address code 2 = ip-address; - option SUNW.server-name code 3 = text; - option SUNW.root-path code 4 = text; - -.fi -Once you have defined an option space and some options, you can set up -scopes that define values for those options, and you can say when to -use them. For example, suppose you want to handle two different -classes of clients, as in the example in the \fBVENDOR ENCAPSULATED -OPTIONS\fR section. Using the option space definition shown in the -previous example, something very similar to the -vendor-encapsulated-options definition shown earlier can be done as -follows: -.PP -.nf -class "vendor-classes" { - match option vendor-class-identifier; -} - -option SUNW.server-address 172.17.65.1; -option SUNW.server-name "sundhcp-server17-1"; - -subclass "vendor-classes" "SUNW.Ultra-5_10" { - vendor-option-space SUNW; - option SUNW.root-path "/export/root/sparc"; -} - -subclass "vendor-classes" "SUNW.i86pc" { - vendor-option-space SUNW; - option SUNW.root-path "/export/root/i86pc"; -} -.fi -.PP -As you can see in the preceding example, regular scoping rules apply, -so you can define values that are global in the global scope, and only -define values that are specific to a particular class in the local -scope. The \fBvendor-option-space\fR declaration indicates that in -that scope, the \fBvendor-encapsulated-options\fR option should be -constructed using the values of all the options in the SUNW option -space. .SH SEE ALSO dhcpd.conf(5), dhcpd.leases(5), RFC2132, RFC2131. .SH AUTHOR