| < draft-ietf-geopriv-local-civic-02.txt | draft-ietf-geopriv-local-civic-03.txt > | |||
|---|---|---|---|---|
| GEOPRIV J. Winterbottom | GEOPRIV J. Winterbottom | |||
| Internet-Draft M. Thomson | Internet-Draft CommScope | |||
| Updates: 5222 (if approved) CommScope | Updates: 5222 (if approved) M. Thomson | |||
| Intended status: Standards Track R. Barnes | Intended status: Standards Track Skype | |||
| Expires: April 20, 2012 BBN Technologies | Expires: August 4, 2012 R. Barnes | |||
| BBN Technologies | ||||
| B. Rosen | B. Rosen | |||
| NeuStar, Inc. | NeuStar, Inc. | |||
| R. George | R. George | |||
| Huawei Technologies | Huawei Technologies | |||
| October 18, 2011 | Feb 2012 | |||
| Specifying Civic Address Extensions in PIDF-LO | Specifying Civic Address Extensions in PIDF-LO | |||
| draft-ietf-geopriv-local-civic-02 | draft-ietf-geopriv-local-civic-03 | |||
| Abstract | Abstract | |||
| New fields are occasionally added to civic addresses. A backwardly- | New fields are occasionally added to civic addresses. A backwardly- | |||
| compatible mechanism for adding civic address elements to the Geopriv | compatible mechanism for adding civic address elements to the Geopriv | |||
| civic address format is described. A formal mechanism for handling | civic address format is described. A formal mechanism for handling | |||
| unsupported extensions when translating between XML and DHCP civic | unsupported extensions when translating between XML and DHCP civic | |||
| address forms is defined for entities that need to perform this | address forms is defined for entities that need to perform this | |||
| translation. Intial extensions for some new elements are also | translation. Intial extensions for some new elements are also | |||
| defined. The LoST protocol mechanism that returns civic address | defined. The LoST protocol mechanism that returns civic address | |||
| skipping to change at page 1, line 44 ¶ | skipping to change at page 1, line 45 ¶ | |||
| Internet-Drafts are working documents of the Internet Engineering | Internet-Drafts are working documents of the Internet Engineering | |||
| Task Force (IETF). Note that other groups may also distribute | Task Force (IETF). Note that other groups may also distribute | |||
| working documents as Internet-Drafts. The list of current Internet- | working documents as Internet-Drafts. The list of current Internet- | |||
| Drafts is at http://datatracker.ietf.org/drafts/current/. | Drafts is at http://datatracker.ietf.org/drafts/current/. | |||
| Internet-Drafts are draft documents valid for a maximum of six months | Internet-Drafts are draft documents valid for a maximum of six months | |||
| and may be updated, replaced, or obsoleted by other documents at any | and may be updated, replaced, or obsoleted by other documents at any | |||
| time. It is inappropriate to use Internet-Drafts as reference | time. It is inappropriate to use Internet-Drafts as reference | |||
| material or to cite them other than as "work in progress." | material or to cite them other than as "work in progress." | |||
| This Internet-Draft will expire on April 20, 2012. | This Internet-Draft will expire on August 4, 2012. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2011 IETF Trust and the persons identified as the | Copyright (c) 2012 IETF Trust and the persons identified as the | |||
| document authors. All rights reserved. | document authors. All rights reserved. | |||
| This document is subject to BCP 78 and the IETF Trust's Legal | This document is subject to BCP 78 and the IETF Trust's Legal | |||
| Provisions Relating to IETF Documents | Provisions Relating to IETF Documents | |||
| (http://trustee.ietf.org/license-info) in effect on the date of | (http://trustee.ietf.org/license-info) in effect on the date of | |||
| publication of this document. Please review these documents | publication of this document. Please review these documents | |||
| carefully, as they describe your rights and restrictions with respect | carefully, as they describe your rights and restrictions with respect | |||
| to this document. Code Components extracted from this document must | to this document. Code Components extracted from this document must | |||
| include Simplified BSD License text as described in Section 4.e of | include Simplified BSD License text as described in Section 4.e of | |||
| the Trust Legal Provisions and are provided without warranty as | the Trust Legal Provisions and are provided without warranty as | |||
| skipping to change at page 2, line 38 ¶ | skipping to change at page 2, line 39 ¶ | |||
| 5.1. Pole Number . . . . . . . . . . . . . . . . . . . . . . . 9 | 5.1. Pole Number . . . . . . . . . . . . . . . . . . . . . . . 9 | |||
| 5.2. Mile Post . . . . . . . . . . . . . . . . . . . . . . . . 10 | 5.2. Mile Post . . . . . . . . . . . . . . . . . . . . . . . . 10 | |||
| 5.3. Street Type Prefix . . . . . . . . . . . . . . . . . . . . 10 | 5.3. Street Type Prefix . . . . . . . . . . . . . . . . . . . . 10 | |||
| 5.4. House Number Prefix . . . . . . . . . . . . . . . . . . . 10 | 5.4. House Number Prefix . . . . . . . . . . . . . . . . . . . 10 | |||
| 5.5. XML Extension Schema . . . . . . . . . . . . . . . . . . . 11 | 5.5. XML Extension Schema . . . . . . . . . . . . . . . . . . . 11 | |||
| 5.6. Extension examples . . . . . . . . . . . . . . . . . . . . 11 | 5.6. Extension examples . . . . . . . . . . . . . . . . . . . . 11 | |||
| 6. Using Local Civic Extension with the LoST Protocol . . . . . . 12 | 6. Using Local Civic Extension with the LoST Protocol . . . . . . 12 | |||
| 7. Security Considerations . . . . . . . . . . . . . . . . . . . 13 | 7. Security Considerations . . . . . . . . . . . . . . . . . . . 13 | |||
| 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 13 | 8. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 13 | |||
| 8.1. CAtype Registration for Extensions . . . . . . . . . . . . 14 | 8.1. CAtype Registration for Extensions . . . . . . . . . . . . 14 | |||
| 8.2. End of Numeric CAtype Registration . . . . . . . . . . . . 14 | 8.2. Changes to the CAtype Registry . . . . . . . . . . . . . . 14 | |||
| 8.3. URN sub-namespace registration for | 8.3. URN sub-namespace registration for | |||
| 'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr:ext' . . 14 | 'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr:ext' . . 14 | |||
| 8.4. XML Schema Registration . . . . . . . . . . . . . . . . . 15 | 8.4. XML Schema Registration . . . . . . . . . . . . . . . . . 15 | |||
| 8.5. Registration Template . . . . . . . . . . . . . . . . . . 15 | 8.5. Registration Template . . . . . . . . . . . . . . . . . . 15 | |||
| 8.6. Registration Policy and Expert Guidance . . . . . . . . . 17 | 8.6. Registration Policy and Expert Guidance . . . . . . . . . 17 | |||
| 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 17 | 9. Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 17 | |||
| 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 17 | 10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 17 | |||
| 10.1. Normative References . . . . . . . . . . . . . . . . . . . 17 | 10.1. Normative References . . . . . . . . . . . . . . . . . . . 17 | |||
| 10.2. Informative References . . . . . . . . . . . . . . . . . . 18 | 10.2. Informative References . . . . . . . . . . . . . . . . . . 18 | |||
| Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 18 | Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 18 | |||
| 1. Introduction | 1. Introduction | |||
| The Geopriv civic location specifications ([RFC4776], [RFC5139]) | The Geopriv civic location specifications ([RFC4776], [RFC5139]) | |||
| define an XML and binary representtations for civic addresses that | define an XML and binary representations for civic addresses that | |||
| allow for the expression of civic addresses. Guidance for the use of | allow for the expression of civic addresses. Guidance for the use of | |||
| these formats for the civic addresses in different countries is | these formats for the civic addresses in different countries is | |||
| included in [RFC5774]. | included in [RFC5774]. | |||
| Subsequent to these specifications being produced, use cases for | Subsequent to these specifications being produced, use cases for | |||
| extending the civic address format with new elements have emerged. | extending the civic address format with new elements have emerged. | |||
| Extension elements do not readily fit existing elements, as | Extension elements do not readily fit existing elements, as | |||
| recommended in [RFC5774]. | recommended in [RFC5774]. | |||
| The XML format for civic addresses [RFC5139] provides a mechanism | The XML format for civic addresses [RFC5139] provides a mechanism | |||
| skipping to change at page 3, line 33 ¶ | skipping to change at page 3, line 33 ¶ | |||
| A recipient of a civic address in either format currently has no | A recipient of a civic address in either format currently has no | |||
| option other than to ignore elements that it does not understand. | option other than to ignore elements that it does not understand. | |||
| This results in any elements that are unknown to that recipient being | This results in any elements that are unknown to that recipient being | |||
| discarded if a recipient performs a translation between the two | discarded if a recipient performs a translation between the two | |||
| formats. In order for a new extension to be preserved through | formats. In order for a new extension to be preserved through | |||
| translation by any recipient, the recipient has to understand the | translation by any recipient, the recipient has to understand the | |||
| extension and know how to correlate an XML element with a CAtype. | extension and know how to correlate an XML element with a CAtype. | |||
| This document describes how new civic address elements are added. | This document describes how new civic address elements are added. | |||
| Extension always starts with the definition of XML elements. A | Extensions always starts with the definition of XML elements. A | |||
| mechanism for carrying the extension in the DHCP format is described. | mechanism for carrying the extension in the DHCP format is described. | |||
| A new XML namespace containing a small number of additional civic | A new XML namespace containing a small number of additional civic | |||
| elements is also defined and can be used as a template to illustrate | elements is also defined and can be used as a template to illustrate | |||
| how other extensions can be defined as required. | how other extensions can be defined as required. | |||
| These mechanisms ensure that any translation between formats can be | These mechanisms ensure that any translation between formats can be | |||
| performed consistently and without loss of information. Translation | performed consistently and without loss of information. Translation | |||
| between formats can occur without knowledge of every extension that | between formats can occur without knowledge of every extension that | |||
| is present. | is present. | |||
| The existing registry of numeric CAtypes is closed, and a new | The registry of numeric CAtypes is modified so that creators of | |||
| registry is created that advertises new namespaces and the associated | extension can advertise new namespaces and the civic elements to | |||
| civic elements to encourage maximum reuse. | encourage maximum reuse. | |||
| These additions described in this document are backwardly compatible. | The additions described in this document are backwardly compatible. | |||
| Existing implementations may cause extension information to be lost, | Existing implementations may cause extension information to be lost, | |||
| but the presence of extensions does not affect an implementation that | but the presence of extensions does not affect an implementation that | |||
| conforms to either [RFC4776] or [RFC5139]. | conforms to either [RFC4776] or [RFC5139]. | |||
| This document also normatively updates [RFC5222] to clarify that the | This document also normatively updates [RFC5222] to clarify that the | |||
| namespace must be included with the element name in the lists of | namespace must be included with the element name in the lists of | |||
| valid, invalid and not checked elements in the <locationValidation> | valid, invalid and not checked elements in the <locationValidation> | |||
| part of a LoST response. While the LoST schema does not need to be | part of a LoST response. While the LoST schema does not need to be | |||
| changed, the example in the document is updated to show the | changed, the example in the document is updated to show the | |||
| namespaces in the lists. | namespaces in the lists. | |||
| skipping to change at page 8, line 48 ¶ | skipping to change at page 8, line 48 ¶ | |||
| 4. CAtypes Registry | 4. CAtypes Registry | |||
| [RFC4776] created the CAtype registry. Among other things, this | [RFC4776] created the CAtype registry. Among other things, this | |||
| registry advertised available civic elements. While it has always | registry advertised available civic elements. While it has always | |||
| been possible to use an extension namespace to define civic elements | been possible to use an extension namespace to define civic elements | |||
| that are not in the CAtype registry, and this document does not | that are not in the CAtype registry, and this document does not | |||
| change that, the registry is valuable to alert implementors of | change that, the registry is valuable to alert implementors of | |||
| commonly used civic elements and provides guidance to clients of what | commonly used civic elements and provides guidance to clients of what | |||
| elements they should suppport. | elements they should suppport. | |||
| This document creates a new CAtype registry that differs from the | This document alters the CAtype registry in several ways. It closes | |||
| original CAtype registry in two ways. The original registry is | the registry to new numeric CAtypes. It deletes the "NENA" column, | |||
| closed to new numeric CAtypes. The new registry adds a column to the | which is not needed. It adds columns for a namespace and contact, | |||
| registry called "Type". "Type" can have one of two values "A" or | and changes the name of the column currently called "PIDF" to "Local | |||
| "B". Type A elements are intended for wide use with many | Name". It also adds a column to the registry called "Type". "Type" | |||
| applications and SHOULD be implemented by all clients unless the | can have one of two values "A" and "B". Type A elements are intended | |||
| client is certain the element will not be encountered. Type "B" | for wide use with many applications and SHOULD be implemented by all | |||
| civic elements MAY be implemented by any client. | clients unless the client is certain the element will not be | |||
| encountered. Type "B" civic elements MAY be implemented by any | ||||
| client. | ||||
| Type A civic elements require IETF review, while Type B elements only | Type A civic elements require IETF review, while Type B elements only | |||
| require an expert review. | require an expert review. | |||
| 5. Civic Extensions | 5. Civic Extensions | |||
| We use this new extension method to define some additional civic | We use this new extension method to define some additional civic | |||
| address elements which are needed to correctly encode civic locations | address elements which are needed to correctly encode civic locations | |||
| in several countries. The definition of these new civic address | in several countries. The definition of these new civic address | |||
| elements also serves as an example of how to define additional | elements also serves as an example of how to define additional | |||
| skipping to change at page 10, line 31 ¶ | skipping to change at page 10, line 31 ¶ | |||
| | | \|,,,| | | | \|,,,| | |||
| _ | | | _ | | | |||
| ``-..|.| | ``-..|.| | |||
| ``--.._ | ``--.._ | |||
| `'--.._ | `'--.._ | |||
| Figure 5: Lamp post with emergency number | Figure 5: Lamp post with emergency number | |||
| 5.2. Mile Post | 5.2. Mile Post | |||
| On some roads, and many trails, railroad rights of way and other | On some roads, trails, railroad rights of way and other linear | |||
| linear features, a post with a mile or kilometer distance from one | features, a post with a mile or kilometer distance from one end of | |||
| end of the feature may be found (a "milepost"). There are other | the feature may be found (a "milepost"). There are other cases of | |||
| cases of poles or markers with numeric indications that are not the | poles or markers with numeric indications that are not the same as a | |||
| same as a "house number" or street address number. | "house number" or street address number. | |||
| 5.3. Street Type Prefix | 5.3. Street Type Prefix | |||
| The civic schema defined in [RFC5139] allows the definition of | The civic schema defined in [RFC5139] allows the definition of | |||
| address "123 Colorado Boulevard", but it does not allow for the easy | address "123 Colorado Boulevard", but it does not allow for the easy | |||
| expression of "123 Boulevard Colorado". Adding a street-type prefix, | expression of "123 Boulevard Colorado". Adding a street-type prefix, | |||
| allows street named in this manner to be more easily represented. | allows street named in this manner to be more easily represented. | |||
| 5.4. House Number Prefix | 5.4. House Number Prefix | |||
| skipping to change at page 13, line 43 ¶ | skipping to change at page 13, line 43 ¶ | |||
| This document defines a formal way to extend the existing Geopriv | This document defines a formal way to extend the existing Geopriv | |||
| civic address schema. No security threats are introduced by this | civic address schema. No security threats are introduced by this | |||
| document. | document. | |||
| Security threats applicable to the civic address formats are | Security threats applicable to the civic address formats are | |||
| described in [RFC4776] (DHCP) and [RFC5139] (XML). | described in [RFC4776] (DHCP) and [RFC5139] (XML). | |||
| 8. IANA Considerations | 8. IANA Considerations | |||
| This document replaces the "CAtypes" registry established by | This document alters the "CAtypes" registry established by [RFC4776]. | |||
| [RFC4776]. | ||||
| 8.1. CAtype Registration for Extensions | 8.1. CAtype Registration for Extensions | |||
| IANA has allocated a CAtype code of XX for the extension CAtype. | IANA has allocated a CAtype code of XX for the extension CAtype. | |||
| [[IANA/RFC-EDITOR: Please replace XX with the allocated CAtype]] | [[IANA/RFC-EDITOR: Please replace XX with the allocated CAtype]] | |||
| 8.2. End of Numeric CAtype Registration | 8.2. Changes to the CAtype Registry | |||
| No further registration of numeric CAtypes is permitted, and the | No further registration of numeric CAtypes is permitted. | |||
| registry created as part of [RFC4776] replaced with the registry | ||||
| defined in this document. New registrations use the registration | The column called "NENA" is removed. | |||
| template in Section 8.5. | ||||
| The column called "PIDF" is renamed to "Local Name". | ||||
| New columns are added named "Namespace URI", "Contact", "Schema" and | ||||
| "Type". | ||||
| New registrations use the registration template in Section 8.5. | ||||
| 8.3. URN sub-namespace registration for | 8.3. URN sub-namespace registration for | |||
| 'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr:ext' | 'urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr:ext' | |||
| This document calls for IANA to register a new XML namespace, as per | This document calls for IANA to register a new XML namespace, as per | |||
| the guidelines in [RFC3688]. | the guidelines in [RFC3688]. | |||
| URI: urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr:ext | URI: urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr:ext | |||
| Registrant Contact: IETF, GEOPRIV working group (geopriv@ietf.org), | Registrant Contact: IETF, GEOPRIV working group (geopriv@ietf.org), | |||
| skipping to change at page 16, line 11 ¶ | skipping to change at page 16, line 11 ¶ | |||
| Registrations from [RFC4776] and [RFC5139] are registered with the | Registrations from [RFC4776] and [RFC5139] are registered with the | |||
| following form: | following form: | |||
| CAtype: (The existing CAtype.) | CAtype: (The existing CAtype.) | |||
| Namespace URI: urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr | Namespace URI: urn:ietf:params:xml:ns:pidf:geopriv10:civicAddr | |||
| Local Name: (The contents of the PIDF column.) | Local Name: (The contents of the PIDF column.) | |||
| Description: (The existing description for the element, including a | Description: (The existing description for the element.) | |||
| note about the equivalent NENA field, if present.) | ||||
| Contact: The IESG (iesg@ietf.org); the GEOPRIV working group | Contact: The IESG (iesg@ietf.org); the GEOPRIV working group | |||
| (geopriv@ietf.org). | (geopriv@ietf.org). | |||
| Specification: RFC4776 and RFC5139 | Specification: RFC4776 and RFC5139 | |||
| Schema: urn:ietf:params:xml:schema:pidf:geopriv10:civicAddr | Schema: urn:ietf:params:xml:schema:pidf:geopriv10:civicAddr | |||
| Type: A | Type: A | |||
| skipping to change at page 17, line 4 ¶ | skipping to change at page 16, line 48 ¶ | |||
| Description: HNP: House Number Prefix. | Description: HNP: House Number Prefix. | |||
| Contact: The IESG (iesg@ietf.org); the GEOPRIV working group | Contact: The IESG (iesg@ietf.org); the GEOPRIV working group | |||
| (geopriv@ietf.org). | (geopriv@ietf.org). | |||
| Specification: RFCXXXX [[NOTE TO IANA/RFC-EDITOR: Please update RFC | Specification: RFCXXXX [[NOTE TO IANA/RFC-EDITOR: Please update RFC | |||
| URL and replace XXXX with the RFC number for this specification.]] | URL and replace XXXX with the RFC number for this specification.]] | |||
| Schema: urn:ietf:params:xml:schema:pidf:geopriv10:civicAddr:ext | Schema: urn:ietf:params:xml:schema:pidf:geopriv10:civicAddr:ext | |||
| Type: A | Type: A | |||
| 8.6. Registration Policy and Expert Guidance | 8.6. Registration Policy and Expert Guidance | |||
| The "CAtypes" registry will operate on a registration policy of | The "CAtypes" registry is altered to operate on a registration policy | |||
| "Expert Review", and optionally "Specification Required" [RFC5226] if | of "Expert Review", and optionally "Specification Required" [RFC5226] | |||
| the element being registered has a Type value of "B". | if the element being registered has a Type value of "B". | |||
| The registration rules for "Specification Required" are followed only | The registration rules for "Specification Required" are followed only | |||
| if a registration includes a reference to a specification. | if a registration includes a reference to a specification. | |||
| Registrations can be made without a specification reference. | Registrations can be made without a specification reference. | |||
| If the element being registered has a Type value of "A" then the | If the element being registered has a Type value of "A" then the | |||
| registration policy is "IETF Review". | registration policy is "IETF Review". | |||
| All registrations are reviewed to identify potential duplication | All registrations are reviewed to identify potential duplication | |||
| between registered elements. Duplicated semantics are not prohibited | between registered elements. Duplicated semantics are not prohibited | |||
| skipping to change at page 19, line 9 ¶ | skipping to change at page 18, line 43 ¶ | |||
| Object (PIDF-LO): Guidelines and IANA Registry | Object (PIDF-LO): Guidelines and IANA Registry | |||
| Definition", BCP 154, RFC 5774, March 2010. | Definition", BCP 154, RFC 5774, March 2010. | |||
| [RFC5985] Barnes, M., "HTTP-Enabled Location Delivery (HELD)", | [RFC5985] Barnes, M., "HTTP-Enabled Location Delivery (HELD)", | |||
| RFC 5985, September 2010. | RFC 5985, September 2010. | |||
| Authors' Addresses | Authors' Addresses | |||
| James Winterbottom | James Winterbottom | |||
| CommScope | CommScope | |||
| Andrew Building (39) | Suit 1, Level 2 | |||
| Wollongong University Campus | iC Enterprise 1, Innovation Campus | |||
| Northfields Avenue | Squires Way | |||
| Wollongong, NSW 2522 | North Wollongong, NSW 2500 | |||
| AU | AU | |||
| Phone: +61 242 212938 | Phone: +61 242 212938 | |||
| Email: james.winterbottom@commscope.com | Email: james.winterbottom@commscope.com | |||
| Martin Thomson | Martin Thomson | |||
| CommScope | Skype | |||
| Andrew Building (39) | 3210 Porter Drive | |||
| Wollongong University Campus | Palo Alto, California 94304 | |||
| Northfields Avenue | US | |||
| Wollongong, NSW 2522 | ||||
| AU | ||||
| Phone: +61 2 4221 2915 | Email: martin.thomson@gmail.com | |||
| Email: martin.thomson@commscope.com | ||||
| Richard Barnes | Richard Barnes | |||
| BBN Technologies | BBN Technologies | |||
| 9861 Broken Land Parkway | 9861 Broken Land Parkway | |||
| Columbia, MD 21046 | Columbia, MD 21046 | |||
| US | US | |||
| Phone: +1 410 290 6169 | Phone: +1 410 290 6169 | |||
| Email: rbarnes@bbn.com | Email: rbarnes@bbn.com | |||
| End of changes. 22 change blocks. | ||||
| 53 lines changed or deleted | 57 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. The latest version is available from http://tools.ietf.org/tools/rfcdiff/ | ||||