1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
|
<pre>Network Working Group J. Littlefield
Request for Comments: 3925 Cisco Systems, Inc.
Category: Standards Track October 2004
<span class="h1">Vendor-Identifying Vendor Options for</span>
<span class="h1">Dynamic Host Configuration Protocol version 4 (DHCPv4)</span>
Status of this Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2004).
Abstract
The Dynamic Host Configuration Protocol (DHCP) options for Vendor
Class and Vendor-Specific Information can be limiting or ambiguous
when a DHCP client represents multiple vendors. This document
defines two new options, modeled on the IPv6 options for vendor class
and vendor-specific information, that contain Enterprise Numbers to
remove ambiguity.
Table of Contents
<a href="#section-1">1</a>. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-2">2</a>
<a href="#section-1.1">1.1</a>. Conventions Used in This Document. . . . . . . . . . . . <a href="#page-2">2</a>
<a href="#section-2">2</a>. Supporting Multiple Vendor Instances . . . . . . . . . . . . . <a href="#page-3">3</a>
<a href="#section-3">3</a>. Vendor-Identifying Vendor Class Option . . . . . . . . . . . . <a href="#page-3">3</a>
<a href="#section-4">4</a>. Vendor-Identifying Vendor-Specific Information Option . . . . <a href="#page-5">5</a>
<a href="#section-5">5</a>. IANA Considerations . . . . . . . . . . . . . . . . . . . . . <a href="#page-7">7</a>
<a href="#section-6">6</a>. Security Considerations . . . . . . . . . . . . . . . . . . . <a href="#page-7">7</a>
<a href="#section-7">7</a>. References . . . . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-8">8</a>
<a href="#section-7.1">7.1</a>. Normative References . . . . . . . . . . . . . . . . . . <a href="#page-8">8</a>
<a href="#section-7.2">7.2</a>. Informative References . . . . . . . . . . . . . . . . . <a href="#page-8">8</a>
<a href="#section-8">8</a>. Author's Address . . . . . . . . . . . . . . . . . . . . . . . <a href="#page-8">8</a>
<a href="#section-9">9</a>. Full Copyright Statement . . . . . . . . . . . . . . . . . . . <a href="#page-9">9</a>
<span class="grey">Littlefield Standards Track [Page 1]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-2" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>. Introduction</span>
The DHCP protocol for IPv4, <a href="./rfc2131">RFC 2131</a> [<a href="#ref-2" title=""Dynamic Host Configuration Protocol"">2</a>], defines options that allow
a client to indicate its vendor type (option 60), and the DHCP client
and server to exchange vendor-specific information (option 43) [<a href="#ref-5" title=""DHCP Options and BOOTP Vendor Extensions"">5</a>].
Although there is no prohibition against passing multiple copies of
these options in a single packet, doing so would introduce ambiguity
of interpretation, particularly if conveying vendor-specific
information for multiple vendors. The vendor identified by option 60
defines the interpretation of option 43, which itself carries no
vendor identifier. Furthermore, the concatenation of multiple
instances of the same option, required by <a href="./rfc2131">RFC 2131</a> and specified by
<a href="./rfc3396">RFC 3396</a> [<a href="#ref-4" title=""Encoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)"">4</a>], means that multiple copies of options 60 or 43 would
not remain independent.
In some circumstances, an implementation may need to support
multiple, independently defined forms of vendor-specific information.
For example, implementations that must conform to an industry-
standard use of DHCPv4, to allow interoperability in a particular
technology space, may be required to support the vendor-specific
options of that industry group. But the same implementation may also
require support for vendor-specific options defined by the
manufacturer. In particular, this is an issue for vendors of devices
supporting CableLabs [<a href="#ref-9">9</a>] standards, such as DOCSIS, CableHome, and
PacketCable, as those standards define an industry-specific use for
options 60 and 43.
This document defines two new options, modeled on the IPv6 options
for vendor class and vendor-specific information defined in <a href="./rfc3315">RFC 3315</a>
[<a href="#ref-6" title=""Dynamic Host Configuration Protocol for IPv6 (DHCPv6)"">6</a>], that contain IANA-assigned Enterprise Numbers [<a href="#ref-3" title=""Private Enterprise Numbers"">3</a>] to remove
ambiguity about the interpretation of their contents. If desired,
these new options can be used in addition to the current vendor class
and vendor information options, whose definition is unaffected by
this document.
<span class="h3"><a class="selflink" id="section-1.1" href="#section-1.1">1.1</a>. Conventions Used in This Document</span>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a> [<a href="#ref-1" title=""Key words for use in RFCs to Indicate Requirement Levels"">1</a>].
<span class="grey">Littlefield Standards Track [Page 2]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-3" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>. Supporting Multiple Vendor Instances</span>
The options defined in this document may each contain data
corresponding to more than one vendor. The data portion of each
option defined here contains an enterprise number (assigned by IANA
[<a href="#ref-3" title=""Private Enterprise Numbers"">3</a>]), followed by an internal data length, followed by vendor-
specific data. This sequence may be repeated multiple times within
each option. Because the aggregate of the vendor-specific data for
either option may exceed 255 octets, these options are hereby
declared to be "concatenation-requiring", as defined by <a href="./rfc3396">RFC 3396</a> [<a href="#ref-4" title=""Encoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)"">4</a>].
As such, for each of the two options defined here, the aggregate of
all instances of vendor-specific data is to be considered one long
option. These long options can be divided into smaller options for
packet encoding in conformance with <a href="./rfc3396">RFC 3396</a>, on whatever octet
boundaries are convenient to the implementation. Dividing on the
boundaries between vendor instances is not required but may be
convenient for encoding or packet tracing.
<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>. Vendor-Identifying Vendor Class Option</span>
A DHCP client may use this option to unambiguously identify the
vendor that manufactured the hardware on which the client is running,
the software in use, or an industry consortium to which the vendor
belongs. The information contained in the per-vendor data area of
this option is contained in one or more opaque fields that may
identify details of the hardware configuration.
This option may be used wherever Vendor Class Identifier (option 60)
may be used, as described in <a href="./rfc2131">RFC 2131</a> [<a href="#ref-2" title=""Dynamic Host Configuration Protocol"">2</a>], except for DHCPNAK
messages, where other options are not permitted. It is most
meaningful in messages from DHCP client to DHCP server (DHCPDISCOVER,
DHCPREQUEST, DHCPINFORM).
<span class="grey">Littlefield Standards Track [Page 3]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-4" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
The format of the V-I Vendor Class option is as follows:
1 1 1 1 1 1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| option-code | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| enterprise-number1 |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| data-len1 | |
+-+-+-+-+-+-+-+-+ |
/ vendor-class-data1 /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ----
| enterprise-number2 | ^
| | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| data-len2 | | optional
+-+-+-+-+-+-+-+-+ | |
/ vendor-class-data2 / |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
~ ... ~ V
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ----
option-code OPTION_V-I_VENDOR_CLASS (124)
option-len total length of all following option data in
octets
enterprise-numberN The vendor's 32-bit Enterprise Number as
registered with IANA [<a href="#ref-3" title=""Private Enterprise Numbers"">3</a>]
data-lenN Length of vendor-class-data field
vendor-class-dataN Details of the hardware configuration of the
host on which the client is running, or of
industry consortium compliance
This option contains information corresponding to one or more
Enterprise Numbers. Multiple instances of this option may be present
and MUST be concatenated in accordance with <a href="./rfc3396">RFC 3396</a> [<a href="#ref-4" title=""Encoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)"">4</a>]. An
Enterprise Number SHOULD only occur once among all instances of this
option. Behavior is undefined if an Enterprise Number occurs
multiple times. The information for each Enterprise Number is
treated independently, regardless or whether it occurs in an option
with other Enterprise Numbers or in a separate option.
<span class="grey">Littlefield Standards Track [Page 4]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-5" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
The vendor-class-data comprises a series of separate items, each of
which describes some characteristic of the client's hardware
configuration or capabilities. Examples of vendor-class-data
instances might include the version of the operating system the
client is running or the amount of memory installed on the client.
Each instance of the vendor-class-data is formatted as follows:
1 1 1 1 1 1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| data-len | |
+-+-+-+-+-+-+-+-+ opaque-data |
/ /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
The data-len is one octet long and specifies the length of the opaque
vendor class data in network byte order.
<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>. Vendor-Identifying Vendor-Specific Information Option</span>
DHCP clients and servers may use this option to exchange vendor-
specific information. Either party may send this option, as needed.
Although a typical case might be for a client to send the Vendor-
Identifying Vendor Class option, to elicit a useful Vendor-
Identifying Vendor-Specific Information Option, there is no
requirement for such a flow.
This option may be used in any packets where "other" options are
allowed by <a href="./rfc2131">RFC 2131</a> [<a href="#ref-2" title=""Dynamic Host Configuration Protocol"">2</a>], specifically DHCPDISCOVER, DHCPOFFER,
DHCPREQUEST, DHCPACK, and DHCPINFORM.
<span class="grey">Littlefield Standards Track [Page 5]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-6" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
The format of the V-I Vendor-specific Information option is as
follows:
1 1 1 1 1 1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| option-code | option-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| enterprise-number1 |
| |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| data-len1 | |
+-+-+-+-+-+-+-+-+ option-data1 |
/ /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ----
| enterprise-number2 | ^
| | |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
| data-len2 | | optional
+-+-+-+-+-+-+-+-+ option-data2 | |
/ / |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ |
~ ... ~ V
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ----
option-code OPTION_V-I_VENDOR_OPTS (125)
option-len total length of all following option data in
octets
enterprise-numberN The vendor's registered 32-bit Enterprise Number
as registered with IANA [<a href="#ref-3" title=""Private Enterprise Numbers"">3</a>]
data-lenN Length of option-data field
option-dataN Vendor-specific options, described below
The definition of the information carried in this option is vendor
specific. The vendor is indicated in the enterprise-number field.
This option contains information corresponding to one or more
Enterprise Numbers. Multiple instances of this option may be present
and MUST be concatenated in accordance with <a href="./rfc3396">RFC 3396</a> [<a href="#ref-4" title=""Encoding Long Options in the Dynamic Host Configuration Protocol (DHCPv4)"">4</a>].
An Enterprise Number SHOULD only occur once among all instances of
this option. Behavior is undefined if an Enterprise Number occurs
multiple times. The information for each Enterprise Number is
treated independently, regardless or whether it occurs in an option
with other Enterprise Numbers, or in a separate option.
<span class="grey">Littlefield Standards Track [Page 6]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-7" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
Use of vendor-specific information allows enhanced operation,
utilizing additional features in a vendor's DHCP implementation.
Servers not equipped to interpret the vendor-specific information
sent by a client MUST ignore it. Clients that do not receive desired
vendor-specific information SHOULD make an attempt to operate without
it.
The encapsulated vendor-specific option-data field MUST be encoded as
a sequence of code/length/value fields of identical format to the
DHCP options field. The option codes are defined by the vendor
identified in the enterprise-number field and are not managed by
IANA. Option codes 0 and 255 have no pre-defined interpretation or
format. Each of the encapsulated options is formatted as follows:
1 1 1 1 1 1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| subopt-code | subopt-len |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
/ sub-option-data /
/ /
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
subopt-code The code for the encapsulated option
subopt-len An unsigned integer giving the length of the
option-data field in this encapsulated option in
octets
sub-option-data Data area for the encapsulated option
<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>. IANA Considerations</span>
The values for the OPTION_V-I_VENDOR_CLASS and OPTION_V-I_VENDOR_OPTS
option codes have been assigned from the numbering space defined for
public DHCP Options in <a href="./rfc2939">RFC 2939</a> [<a href="#ref-7" title=""Procedures and IANA Guidelines for Definition of New DHCP Options and Message Types"">7</a>].
<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>. Security Considerations</span>
This document in and by itself provides no security, nor does it
impact existing security. DHCP provides an authentication and
message integrity mechanism, as described in <a href="./rfc3118">RFC 3118</a> [<a href="#ref-8" title=""Authentication for DHCP Messages"">8</a>], which may
be used if authenticity is required for data carried by the options
defined in this document.
<span class="grey">Littlefield Standards Track [Page 7]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-8" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>. References</span>
<span class="h3"><a class="selflink" id="section-7.1" href="#section-7.1">7.1</a>. Normative References</span>
[<a id="ref-1">1</a>] Bradner, S., "Key words for use in RFCs to Indicate Requirement
Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.
[<a id="ref-2">2</a>] Droms, R., "Dynamic Host Configuration Protocol", <a href="./rfc2131">RFC 2131</a>,
March 1997.
[<a id="ref-3">3</a>] IANA, "Private Enterprise Numbers",
<<a href="http://www.iana.org/assignments/enterprise-numbers">http://www.iana.org/assignments/enterprise-numbers</a>>.
[<a id="ref-4">4</a>] Lemon, T. and S. Cheshire, "Encoding Long Options in the Dynamic
Host Configuration Protocol (DHCPv4)", <a href="./rfc3396">RFC 3396</a>, November 2002.
<span class="h3"><a class="selflink" id="section-7.2" href="#section-7.2">7.2</a>. Informative References</span>
[<a id="ref-5">5</a>] Alexander, S. and R. Droms, "DHCP Options and BOOTP Vendor
Extensions", <a href="./rfc2132">RFC 2132</a>, March 1997.
[<a id="ref-6">6</a>] Droms, R., Bound, J., Volz, B., Lemon, T., Perkins, C., and M.
Carney, "Dynamic Host Configuration Protocol for IPv6 (DHCPv6)",
<a href="./rfc3315">RFC 3315</a>, July 2003.
[<a id="ref-7">7</a>] Droms, R., "Procedures and IANA Guidelines for Definition of New
DHCP Options and Message Types", <a href="https://www.rfc-editor.org/bcp/bcp43">BCP 43</a>, <a href="./rfc2939">RFC 2939</a>, September
2000.
[<a id="ref-8">8</a>] Droms, R. and W. Arbaugh, "Authentication for DHCP Messages",
<a href="./rfc3118">RFC 3118</a>, June 2001.
URIs
[<a id="ref-9">9</a>] <<a href="http://www.cablelabs.com/">http://www.cablelabs.com/</a>>
<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>. Author's Address</span>
Josh Littlefield
Cisco Systems, Inc.
1414 Massachusetts Avenue
Boxborough, MA 01719
USA
Phone: +1 978-936-1379
EMail: joshl@cisco.com
<span class="grey">Littlefield Standards Track [Page 8]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-9" ></span>
<span class="grey"><a href="./rfc3925">RFC 3925</a> Vendor-Identifying Vendor Options October 2004</span>
<span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>. Full Copyright Statement</span>
Copyright (C) The Internet Society (2004).
This document is subject to the rights, licenses and restrictions
contained in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a>, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the IETF's procedures with respect to rights in IETF Documents can
be found in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and <a href="https://www.rfc-editor.org/bcp/bcp79">BCP 79</a>.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
<a href="http://www.ietf.org/ipr">http://www.ietf.org/ipr</a>.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at ietf-
ipr@ietf.org.
Acknowledgement
Funding for the RFC Editor function is currently provided by the
Internet Society.
Littlefield Standards Track [Page 9]
</pre>
|
