From ac89fac641178c2dd7c17bcffb9a417d3be8b229 Mon Sep 17 00:00:00 2001 From: Mark Andrews Date: Fri, 26 Feb 2010 02:36:44 +0000 Subject: [PATCH] new draft --- ...ietf-6man-text-addr-representation-07.txt} | 184 +++++++++--------- 1 file changed, 92 insertions(+), 92 deletions(-) rename doc/draft/{draft-ietf-6man-text-addr-representation-06.txt => draft-ietf-6man-text-addr-representation-07.txt} (81%) diff --git a/doc/draft/draft-ietf-6man-text-addr-representation-06.txt b/doc/draft/draft-ietf-6man-text-addr-representation-07.txt similarity index 81% rename from doc/draft/draft-ietf-6man-text-addr-representation-06.txt rename to doc/draft/draft-ietf-6man-text-addr-representation-07.txt index 62c5ad002f..3a9f1112f9 100644 --- a/doc/draft/draft-ietf-6man-text-addr-representation-06.txt +++ b/doc/draft/draft-ietf-6man-text-addr-representation-07.txt @@ -5,26 +5,25 @@ IPv6 Maintenance Working Group S. Kawamura Internet-Draft NEC BIGLOBE, Ltd. Updates: 4291 (if approved) M. Kawashima Intended status: Standards Track NEC AccessTechnica, Ltd. -Expires: August 23, 2010 February 19, 2010 +Expires: August 29, 2010 February 25, 2010 A Recommendation for IPv6 Address Text Representation - draft-ietf-6man-text-addr-representation-06 + draft-ietf-6man-text-addr-representation-07 Abstract - As IPv6 network grows, there will be more engineers and also non- - engineers who will have the need to use an IPv6 address in text. - While the IPv6 address architecture RFC 4291 section 2.2 depicts a - flexible model for text representation of an IPv6 address, this - flexibility has been causing problems for operators, system - engineers, and users. This document will describe the problems that - a flexible text representation has been causing. This document also - recommends a canonical representation format that best avoids - confusion. It is expected that the canonical format is followed by - humans and systems when representing IPv6 addresses as text, but all - implementations must accept and be able to handle any legitimate - RFC4291 format. + As IPv6 deployment increases there will be a dramatic increase in the + need to use IPv6 addresses in text. While the IPv6 address + architecture in RFC 4291 section 2.2 describes a flexible model for + text representation of an IPv6 address this flexibility has been + causing problems for operators, system engineers, and users. This + document defines a canonical textual representation format. It does + not define a format for internal storage, such as within an + application or database. It is expected that the canonical format is + followed by humans and systems when representing IPv6 addresses as + text, but all implementations must accept and be able to handle any + legitimate RFC 4291 format. Status of this Memo @@ -47,18 +46,17 @@ Status of this Memo The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. - This Internet-Draft will expire on August 23, 2010. + This Internet-Draft will expire on August 29, 2010. + +Copyright Notice - -Kawamura & Kawashima Expires August 23, 2010 [Page 1] +Kawamura & Kawashima Expires August 29, 2010 [Page 1] Internet-Draft IPv6 Text Representation February 2010 -Copyright Notice - Copyright (c) 2010 IETF Trust and the persons identified as the document authors. All rights reserved. @@ -108,7 +106,9 @@ Copyright Notice -Kawamura & Kawashima Expires August 23, 2010 [Page 2] + + +Kawamura & Kawashima Expires August 29, 2010 [Page 2] Internet-Draft IPv6 Text Representation February 2010 @@ -164,7 +164,7 @@ Table of Contents -Kawamura & Kawashima Expires August 23, 2010 [Page 3] +Kawamura & Kawashima Expires August 29, 2010 [Page 3] Internet-Draft IPv6 Text Representation February 2010 @@ -190,11 +190,11 @@ Internet-Draft IPv6 Text Representation February 2010 2001:DB8:0:0:1::1 - All the above represent the same IPv6 address. This flexibility has - caused many problems for operators, systems engineers, and customers. - The problems will be noted in Section 3. Also, a canonical - representation format to avoid problems will be introduced in - Section 4. + All of the above examples represent the same IPv6 address. This + flexibility has caused many problems for operators, systems + engineers, and customers. The problems are noted in Section 3. + Also, a canonical representation format to avoid problems is + introduced in Section 4. 1.1. Requirements Language @@ -213,14 +213,14 @@ Internet-Draft IPv6 Text Representation February 2010 'It is not necessary to write the leading zeros in an individual field.' - In other words, it is also not necessary to omit leading zeros. This + Conversely it is also not necessary to omit leading zeros. This means that, it is possible to select from such as the following example. The final 16 bit field is different, but all these - addresses mean the same. + addresses represent the same address. -Kawamura & Kawashima Expires August 23, 2010 [Page 4] +Kawamura & Kawashima Expires August 29, 2010 [Page 4] Internet-Draft IPv6 Text Representation February 2010 @@ -246,7 +246,7 @@ Internet-Draft IPv6 Text Representation February 2010 2001:db8:aaaa:bbbb:cccc:dddd:0:1 In case where there is more than one zero fields, there is a choice - of how many fields can be shortened. Examples follow. + of how many fields can be shortened. 2001:db8:0:0:0::1 @@ -260,8 +260,8 @@ Internet-Draft IPv6 Text Representation February 2010 'The "::" can only appear once in an address.' - This gives a choice on where, in a single address to compress the - zero. Examples are shown below. + This gives a choice on where in a single address to compress the + zero. 2001:db8::aaaa:0:0:1 @@ -269,14 +269,14 @@ Internet-Draft IPv6 Text Representation February 2010 2.3. Uppercase or Lowercase - [RFC4291] does not mention about preference of uppercase or - lowercase. Various flavors are shown below. + [RFC4291] does not mention any preference of uppercase or lowercase. -Kawamura & Kawashima Expires August 23, 2010 [Page 5] + +Kawamura & Kawashima Expires August 29, 2010 [Page 5] Internet-Draft IPv6 Text Representation February 2010 @@ -327,12 +327,12 @@ Internet-Draft IPv6 Text Representation February 2010 record is set to a database, one will likely check the output to see if the entry is correct. If an entity was recorded as 2001:db8::/48, but the whois output showed 2001:0db8:0000::/48, most non-engineers - would think that their input was wrong, and will likely retry several + would think that their input was wrong and will likely retry several times or make a frustrated call to the database hostmaster. If there -Kawamura & Kawashima Expires August 23, 2010 [Page 6] +Kawamura & Kawashima Expires August 29, 2010 [Page 6] Internet-Draft IPv6 Text Representation February 2010 @@ -340,32 +340,32 @@ Internet-Draft IPv6 Text Representation February 2010 was a need to register the same address on different systems, and each system showed a different text representation, this would confuse people even more. Although this document focuses on - addresses rather than prefixes, this is worth mentioning since + addresses rather than prefixes, this is worth mentioning since the problems encountered are mostly equal. 3.1.4. Searching for an Address in a Network Diagram - Network diagrams and blue-prints often show what IP addresses are - assigned to a system devices. In times of trouble shooting, there - may be a need to search through a diagram to find the point of - failure (for example, if a traceroute stopped at 2001:db8::1, one - would search the diagram for that address). This is a technique - quite often in use in enterprise networks and managed services. - Again, the different flavors of text representation will result in a - time-consuming search, leading to longer MTTR in times of trouble. + Network diagrams and blueprints often show what IP addresses are + assigned to a system devices. In times of trouble shooting there may + be a need to search through a diagram to find the point of failure + (for example, if a traceroute stopped at 2001:db8::1, one would + search the diagram for that address). This is a technique quite + often in use in enterprise networks and managed services. Again, the + different flavors of text representation will result in a time- + consuming search leading to longer MTTR in times of trouble. 3.2. Parsing and Modifying 3.2.1. General Summary - With all the possible text representation ways, each application must - include a module, object, link, etc. to a function that will parse - IPv6 addresses in a manner that no matter how it is represented, they - will mean the same address. Many system engineers who integrate - complex computer systems to corporate customers will have - difficulties finding that their favorite tool will not have this + With all the possible methods of text representation each application + must include a module, object, link, etc. to a function that will + parse IPv6 addresses in a manner that no matter how it is + represented, they will mean the same address. Many system engineers + who integrate complex computer systems for corporate customers will + have difficulties finding that their favorite tool will not have this function, or will encounter difficulties such as having to rewrite - their macro's or scripts for their customers. + their macros or scripts for their customers. 3.2.2. Logging @@ -373,40 +373,40 @@ Internet-Draft IPv6 Text Representation February 2010 address in full (such as 2001:0db8:0000:0000:1111:2222:3333:4444), the output would be highly unreadable compared to the IPv4 output. The address would have to be parsed and reformed to make it useful - for human reading. Sometimes, logging for critical systems is done - by mirroring the same traffic to two different systems. Care must be - taken that no matter what the log output is, the logs should be + for human reading. Sometimes logging for critical systems is done by + mirroring the same traffic to two different systems. Care must be + taken so that no matter what the log output is the logs should be parsed so they will mean the same. 3.2.3. Auditing: Case 1 When a router or any other network appliance machine configuration is audited, there are many methods to compare the configuration - information of a node. Sometimes, auditing will be done by just - comparing the changes made each day. In this case, if configuration + information of a node. Sometimes auditing will be done by just + comparing the changes made each day. In this case if configuration was done such that 2001:db8::1 was changed to 2001:0db8:0000:0000: -Kawamura & Kawashima Expires August 23, 2010 [Page 7] +Kawamura & Kawashima Expires August 29, 2010 [Page 7] Internet-Draft IPv6 Text Representation February 2010 0000:0000:0000:0001 just because the new engineer on the block felt it was better, a simple diff will show that a different address was - configured. If this was done on a wide scale network, people will be + configured. If this was done on a wide scale network people will be focusing on 'why the extra zeros were put in' instead of doing any - real auditing. Lots of tools are just plain 'diff's that do not take + real auditing. Lots of tools are just plain diffs that do not take into account address representation rules. 3.2.4. Auditing: Case 2 Node configurations will be matched against an information system - that manages IP addresses. If output notation is different, there + that manages IP addresses. If output notation is different there will need to be a script that is implemented to cover for this. The result of an SNMP GET operation, converted to text and compared to a - textual address written by a human is highly unlikely to match on + textual address written by a human is highly unlikely to match on the first try. 3.2.5. Verification @@ -444,7 +444,7 @@ Internet-Draft IPv6 Text Representation February 2010 -Kawamura & Kawashima Expires August 23, 2010 [Page 8] +Kawamura & Kawashima Expires August 29, 2010 [Page 8] Internet-Draft IPv6 Text Representation February 2010 @@ -456,7 +456,7 @@ Internet-Draft IPv6 Text Representation February 2010 3.3.3. Abuse - Network abuse is reported along with the abusing IP address. This + Network abuse reports generally include the abusing IP address. This 'reporting' could take any shape or form of the flexible model. A team that handles network abuse must be able to tell the difference between a 2001:db8::1:0:1 and 2001:db8:1::0:1. Mistakes in the @@ -481,7 +481,7 @@ Internet-Draft IPv6 Text Representation February 2010 3.4.2. Preference in Documentation - A document that is edited by more than one author, may become harder + A document that is edited by more than one author may become harder to read. 3.4.3. Legibility @@ -500,7 +500,7 @@ Internet-Draft IPv6 Text Representation February 2010 -Kawamura & Kawashima Expires August 23, 2010 [Page 9] +Kawamura & Kawashima Expires August 29, 2010 [Page 9] Internet-Draft IPv6 Text Representation February 2010 @@ -556,7 +556,7 @@ Internet-Draft IPv6 Text Representation February 2010 -Kawamura & Kawashima Expires August 23, 2010 [Page 10] +Kawamura & Kawashima Expires August 29, 2010 [Page 10] Internet-Draft IPv6 Text Representation February 2010 @@ -608,31 +608,32 @@ Internet-Draft IPv6 Text Representation February 2010 The [] style as expressed in [RFC3986] SHOULD be employed, and is the default unless otherwise specified. Other styles are acceptable when there is exactly one style for the given context and cross-platform - portability does not become an issue. For URIs, [RFC3986] MUST be + portability does not become an issue. For URIs containing IPv6 -Kawamura & Kawashima Expires August 23, 2010 [Page 11] +Kawamura & Kawashima Expires August 29, 2010 [Page 11] Internet-Draft IPv6 Text Representation February 2010 - followed. + address literals, [RFC3986] MUST be followed, as well as the rules in + this document. 7. Prefix Representation Problems with prefixes are just the same as problems encountered with - addresses. Text representation method of IPv6 prefixes should be no - different from that of IPv6 addresses. + addresses. The text representation method of IPv6 prefixes should be + no different from that of IPv6 addresses. 8. Security Considerations - This document notes on some examples where IPv6 addresses are - compared in text format. The example on Section 3.2.5 is one that - may cause a security risk if used for access control. The common - practice of comparing X.509 data is done in binary format. + This document notes some examples where IPv6 addresses are compared + in text format. The example on Section 3.2.5 is one that may cause a + security risk if used for access control. The common practice of + comparing X.509 data is done in binary format. 9. IANA Considerations @@ -647,10 +648,10 @@ Internet-Draft IPv6 Text Representation February 2010 starting this document. We also would like to thank Brian Carpenter, Akira Kato, Juergen Schoenwaelder, Antonio Querubin, Dave Thaler, Brian Haley, Suresh Krishnan, Jerry Huang, Roman Donchenko, Heikki - Vatiainen ,Dan Wing for their input. Also a very special thanks to - Ron Bonica, Fred Baker, Brian Haberman, Robert Hinden, Jari Arkko, - and Kurt Lindqvist for their support in bringing this document to the - light of IETF working groups. + Vatiainen ,Dan Wing, and Doug Barton for their input. Also a very + special thanks to Ron Bonica, Fred Baker, Brian Haberman, Robert + Hinden, Jari Arkko, and Kurt Lindqvist for their support in bringing + this document to the light of IETF working groups. 11. References @@ -663,16 +664,21 @@ Internet-Draft IPv6 Text Representation February 2010 [RFC2765] Nordmark, E., "Stateless IP/ICMP Translation Algorithm (SIIT)", RFC 2765, February 2000. - [RFC4291] Hinden, R. and S. Deering, "IP Version 6 Addressing - Architecture", RFC 4291, February 2006. + [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform -Kawamura & Kawashima Expires August 23, 2010 [Page 12] +Kawamura & Kawashima Expires August 29, 2010 [Page 12] Internet-Draft IPv6 Text Representation February 2010 + Resource Identifier (URI): Generic Syntax", STD 66, + RFC 3986, January 2005. + + [RFC4291] Hinden, R. and S. Deering, "IP Version 6 Addressing + Architecture", RFC 4291, February 2006. + 11.2. Informative References [I-D.ietf-behave-address-format] @@ -681,10 +687,6 @@ Internet-Draft IPv6 Text Representation February 2010 draft-ietf-behave-address-format-04 (work in progress), January 2010. - [RFC3986] Berners-Lee, T., Fielding, R., and L. Masinter, "Uniform - Resource Identifier (URI): Generic Syntax", STD 66, - RFC 3986, January 2005. - [RFC4038] Shin, M-K., Hong, Y-G., Hagino, J., Savola, P., and E. Castro, "Application Aspects of IPv6 Transition", RFC 4038, March 2005. @@ -722,9 +724,7 @@ Authors' Addresses - - -Kawamura & Kawashima Expires August 23, 2010 [Page 13] +Kawamura & Kawashima Expires August 29, 2010 [Page 13] Internet-Draft IPv6 Text Representation February 2010 @@ -780,6 +780,6 @@ Internet-Draft IPv6 Text Representation February 2010 -Kawamura & Kawashima Expires August 23, 2010 [Page 14] +Kawamura & Kawashima Expires August 29, 2010 [Page 14]