summaryrefslogtreecommitdiff
path: root/doc/rfc/rfc3967.txt
blob: 594f1eea63bda9f6a61fa9cbbe20b9e0568f1208 (plain) (blame)
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
Network Working Group                                            R. Bush
Request for Comments: 3967                                           IIJ
BCP: 97                                                        T. Narten
Category: Best Current Practice                          IBM Corporation
                                                           December 2004


          Clarifying when Standards Track Documents may Refer
               Normatively to Documents at a Lower Level

Status of this Memo

   This document specifies an Internet Best Current Practices for the
   Internet Community, and requests discussion and suggestions for
   improvements.  Distribution of this memo is unlimited.

Copyright Notice

   Copyright (C) The Internet Society (2004).

Abstract

   IETF procedures generally require that a standards track RFC may not
   have a normative reference to another standards track document at a
   lower maturity level or to a non standards track specification (other
   than specifications from other standards bodies).  For example, a
   standards track document may not have a normative reference to an
   informational RFC.  Exceptions to this rule are sometimes needed as
   the IETF uses informational RFCs to describe non-IETF standards or
   IETF-specific modes of use of such standards.  This document
   clarifies and updates the procedure used in these circumstances.

1.  Introduction

   The Internet Standards Process [RFC2026] Section 4.2.4 specifies the
   following:

      Standards track specifications normally must not depend on other
      standards track specifications which are at a lower maturity level
      or on non standards track specifications other than referenced
      specifications from other standards bodies.

   One intent is to avoid creating a perception that a standard is more
   mature than it actually is.







Bush & Narten            Best Current Practice                  [Page 1]
^L
RFC 3967            Document Down-Ref Clarifications       December 2004


   It should also be noted that Best Current Practice documents
   [RFC1818] have generally been considered similar to Standards Track
   documents in terms of what they can reference.  For example, a
   normative reference to an Experimental RFC has been considered an
   improper reference per [RFC2026].

1.1.  Normative References

   Within an RFC, references to other documents fall into two general
   categories: "normative" and "informative".  Broadly speaking, a
   normative reference specifies a document that must be read to fully
   understand or implement the subject matter in the new RFC, or whose
   contents are effectively part of the new RFC, as its omission would
   leave the new RFC incompletely specified.  An informative reference
   is not normative; rather, it provides only additional background
   information.

   An exact and precise definition of what is (and is not) a normative
   reference has proven challenging in practice, as the details and
   implications can be subtle.  Moreover, whether a reference needs to
   be normative can depend on the context in which a particular RFC is
   being published in the first place.  For example, in the context of
   an IETF Standard, it is important that all dependent pieces be
   clearly specified and available in an archival form so that there is
   no disagreement over what constitutes a standard.  This is not always
   the case for other documents.

   The rest of this section provides guidance on what might (and might
   not) be considered normative in the context of the IETF standards
   process.

   In the IETF, it is a basic assumption that implementors must have a
   clear understanding of what they need to implement in order to be
   fully compliant with a standard and to be able to interoperate with
   other implementations of that standard.  For documents that are
   referenced, any document that includes key information an implementer
   needs would be normative.  For example, if one needs to understand a
   packet format defined in another document in order to fully implement
   a specification, the reference to that format would be normative.
   Likewise, if a reference to a required algorithm is made, the
   reference would be normative.

   Some specific examples:

   -  If a protocol relies on IPsec to provide security, one cannot
      fully implement the protocol unless the specification for IPsec is
      available; hence, the reference would be normative.




Bush & Narten            Best Current Practice                  [Page 2]
^L
RFC 3967            Document Down-Ref Clarifications       December 2004


      The referenced specification would likely include details about
      specific key management requirements, which transforms are
      required and which are optional, etc.

   -  In MIB documents, an IMPORTS clause by definition is a normative
      reference.

   -  When a reference to an example is made, such a reference need not
      be normative.  For example, text such as "an algorithm such as the
      one specified in [RFCxxxx] would be acceptable" indicates an
      informative reference, since that cited algorithm is just one of
      several possible algorithms that could be used.

2.  The Need for Downward References

   There are a number of circumstances in which an IETF document may
   need to make a normative reference to a document at a lower maturity
   level, but such a reference conflicts with Section 4.2.4 of
   [RFC2026].  For example:

   o  A standards track document may need to refer to a protocol or
      algorithm developed by an external body but modified, adapted, or
      profiled by an IETF informational RFC, for example, MD5 [RFC1321]
      and HMAC [RFC2104].  Note that this does not override the IETF's
      duty to see that the specification is indeed sufficiently clear to
      enable creation of interoperable implementations.

   o  A standards document may need to refer to a proprietary protocol,
      and the IETF normally documents proprietary protocols using
      informational RFCs.

   o  A migration or co-existence document may need to define a
      standards track mechanism for migration from, and/or co-existence
      with, an historic protocol, a proprietary protocol, or possibly a
      non-standards track protocol.

   o  There are exceptional procedural or legal reasons that force the
      target of the normative reference to be an informational or
      historical RFC or to be at a lower standards level than the
      referring document.

   o  A BCP document may want to describe best current practices for
      experimental or informational specifications.








Bush & Narten            Best Current Practice                  [Page 3]
^L
RFC 3967            Document Down-Ref Clarifications       December 2004


3.  The Procedure to Be Used

   For Standards Track or BCP documents requiring normative reference to
   documents of lower maturity, the normal IETF Last Call procedure will
   be issued, with the need for the downward reference explicitly
   documented in the Last Call itself.  Any community comments on the
   appropriateness of downward references will be considered by the IESG
   as part of its deliberations.

   Once a specific down reference to a particular document has been
   accepted by the community (e.g., has been mentioned in several Last
   Calls), an Area Director may waive subsequent notices in the Last
   Call of down references to it.  This should only occur when the same
   document (and version) are being referenced and when the AD believes
   that the document's use is an accepted part of the community's
   understanding of the relevant technical area.  For example, the use
   of MD5 [RFC1321] and HMAC [RFC2104] is well known among
   cryptographers.

   This procedure should not be used if the proper step is to move the
   document to which the reference is being made into the appropriate
   category.  It is not intended as an easy way out of normal process.
   Rather, the procedure is intended for dealing with specific cases
   where putting particular documents into the required category is
   problematic and unlikely ever to happen.

4.  Security Considerations

   This document is not known to create any new vulnerabilities for the
   Internet.  On the other hand, inappropriate or excessive use of the
   process might be considered a downgrade attack on the quality of IETF
   standards or, worse, on the rigorous review of security aspects of
   standards.

5.  Acknowledgments

   This document is the result of discussion within the IESG, with
   particular contribution by Harald Alvestrand, Steve Bellovin, Scott
   Bradner, Ned Freed, Allison Mankin, Jeff Schiller, and Bert Wijnen.












Bush & Narten            Best Current Practice                  [Page 4]
^L
RFC 3967            Document Down-Ref Clarifications       December 2004


6.  References

6.1.  Normative References

   [RFC2026]  Bradner, S., "The Internet Standards Process -- Revision
              3", BCP 9, RFC 2026, October 1996.

6.2.  Informative References

   [RFC1818]  Postel, J., Li, T., and Y. Rekhter, "Best Current
              Practices", BCP 1, RFC 1818, August 1995.

   [RFC1321]  Rivest, R., "The MD5 Message-Digest Algorithm", RFC 1321,
              April 1992.

   [RFC2104]  Krawczyk, H., Bellare, M., and R. Canetti, "HMAC:
              Keyed-Hashing for Message Authentication", RFC 2104,
              February 1997.

7.  Authors' Addresses

   Randy Bush
   IIJ
   5147 Crystal Springs
   Bainbridge Island, WA  98110
   US

   Phone: +1 206 780 0431
   EMail: randy@psg.com
   URI:   http://psg.com/~randy/


   Thomas Narten
   IBM Corporation
   P.O. Box 12195
   Research Triangle Park, NC  27709-2195
   US

   Phone: +1 919 254 7798
   EMail: narten@us.ibm.com











Bush & Narten            Best Current Practice                  [Page 5]
^L
RFC 3967            Document Down-Ref Clarifications       December 2004


8.  Full Copyright Statement

   Copyright (C) The Internet Society (2004).

   This document is subject to the rights, licenses and restrictions
   contained in BCP 78, and at www.rfc-editor.org, 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 ISOC's procedures with respect to rights in ISOC Documents can
   be found in BCP 78 and BCP 79.

   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
   http://www.ietf.org/ipr.

   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.







Bush & Narten            Best Current Practice                  [Page 6]
^L