| < draft-ietf-netmod-geo-location-06.txt | draft-ietf-netmod-geo-location-07.txt > | |||
|---|---|---|---|---|
| Network Working Group C. Hopps | Network Working Group C. Hopps | |||
| Internet-Draft LabN Consulting, L.L.C. | Internet-Draft LabN Consulting, L.L.C. | |||
| Intended status: Standards Track 2 December 2020 | Intended status: Standards Track 3 December 2020 | |||
| Expires: 5 June 2021 | Expires: 6 June 2021 | |||
| A YANG Grouping for Geographic Locations | A YANG Grouping for Geographic Locations | |||
| draft-ietf-netmod-geo-location-06 | draft-ietf-netmod-geo-location-07 | |||
| Abstract | Abstract | |||
| This document defines a generic geographical location object YANG | This document defines a generic geographical location object YANG | |||
| grouping. The geographical location grouping is intended to be used | grouping. The geographical location grouping is intended to be used | |||
| in YANG models for specifying a location on or in reference to Earth | in YANG models for specifying a location on or in reference to Earth | |||
| or any other astronomical object. | or any other astronomical object. | |||
| Status of This Memo | Status of This Memo | |||
| skipping to change at page 1, line 33 ¶ | skipping to change at page 1, line 33 ¶ | |||
| 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 https://datatracker.ietf.org/drafts/current/. | Drafts is at https://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 5 June 2021. | This Internet-Draft will expire on 6 June 2021. | |||
| Copyright Notice | Copyright Notice | |||
| Copyright (c) 2020 IETF Trust and the persons identified as the | Copyright (c) 2020 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 (https://trustee.ietf.org/ | Provisions Relating to IETF Documents (https://trustee.ietf.org/ | |||
| license-info) in effect on the date of publication of this document. | license-info) in effect on the date of publication of this document. | |||
| Please review these documents carefully, as they describe your rights | Please review these documents carefully, as they describe your rights | |||
| skipping to change at page 2, line 18 ¶ | skipping to change at page 2, line 18 ¶ | |||
| 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 3 | 1.1. Terminology . . . . . . . . . . . . . . . . . . . . . . . 3 | |||
| 2. The Geo Location Object . . . . . . . . . . . . . . . . . . . 3 | 2. The Geo Location Object . . . . . . . . . . . . . . . . . . . 3 | |||
| 2.1. Frame of Reference . . . . . . . . . . . . . . . . . . . 3 | 2.1. Frame of Reference . . . . . . . . . . . . . . . . . . . 3 | |||
| 2.2. Location . . . . . . . . . . . . . . . . . . . . . . . . 4 | 2.2. Location . . . . . . . . . . . . . . . . . . . . . . . . 4 | |||
| 2.3. Motion . . . . . . . . . . . . . . . . . . . . . . . . . 4 | 2.3. Motion . . . . . . . . . . . . . . . . . . . . . . . . . 4 | |||
| 2.4. Nested Locations . . . . . . . . . . . . . . . . . . . . 5 | 2.4. Nested Locations . . . . . . . . . . . . . . . . . . . . 5 | |||
| 2.5. Non-location Attributes . . . . . . . . . . . . . . . . . 5 | 2.5. Non-location Attributes . . . . . . . . . . . . . . . . . 5 | |||
| 2.6. Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 5 | 2.6. Tree . . . . . . . . . . . . . . . . . . . . . . . . . . 5 | |||
| 3. YANG Module . . . . . . . . . . . . . . . . . . . . . . . . . 6 | 3. YANG Module . . . . . . . . . . . . . . . . . . . . . . . . . 6 | |||
| 4. ISO 6709:2008 Conformance . . . . . . . . . . . . . . . . . . 12 | 4. ISO 6709:2008 Conformance . . . . . . . . . . . . . . . . . . 12 | |||
| 5. Usability . . . . . . . . . . . . . . . . . . . . . . . . . . 12 | 5. Usability . . . . . . . . . . . . . . . . . . . . . . . . . . 13 | |||
| 5.1. Portability . . . . . . . . . . . . . . . . . . . . . . . 13 | 5.1. Portability . . . . . . . . . . . . . . . . . . . . . . . 13 | |||
| 5.1.1. IETF URI Value . . . . . . . . . . . . . . . . . . . 13 | 5.1.1. IETF URI Value . . . . . . . . . . . . . . . . . . . 13 | |||
| 5.1.2. W3C . . . . . . . . . . . . . . . . . . . . . . . . . 13 | 5.1.2. W3C . . . . . . . . . . . . . . . . . . . . . . . . . 13 | |||
| 5.1.3. Geography Markup Language (GML) . . . . . . . . . . . 15 | 5.1.3. Geography Markup Language (GML) . . . . . . . . . . . 15 | |||
| 5.1.4. KML . . . . . . . . . . . . . . . . . . . . . . . . . 16 | 5.1.4. KML . . . . . . . . . . . . . . . . . . . . . . . . . 16 | |||
| 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 16 | 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 17 | |||
| 6.1. Geodetic System Values Registry . . . . . . . . . . . . . 16 | 6.1. Geodetic System Values Registry . . . . . . . . . . . . . 17 | |||
| 6.2. Updates to the IETF XML Registry . . . . . . . . . . . . 18 | 6.2. Updates to the IETF XML Registry . . . . . . . . . . . . 18 | |||
| 6.3. Updates to the YANG Module Names Registry . . . . . . . . 18 | 6.3. Updates to the YANG Module Names Registry . . . . . . . . 18 | |||
| 7. Security Considerations . . . . . . . . . . . . . . . . . . . 18 | 7. Security Considerations . . . . . . . . . . . . . . . . . . . 19 | |||
| 8. Normative References . . . . . . . . . . . . . . . . . . . . 19 | 8. Normative References . . . . . . . . . . . . . . . . . . . . 19 | |||
| 9. Informative References . . . . . . . . . . . . . . . . . . . 20 | 9. Informative References . . . . . . . . . . . . . . . . . . . 21 | |||
| Appendix A. Examples . . . . . . . . . . . . . . . . . . . . . . 21 | Appendix A. Examples . . . . . . . . . . . . . . . . . . . . . . 22 | |||
| Appendix B. Acknowledgments . . . . . . . . . . . . . . . . . . 24 | Appendix B. Acknowledgments . . . . . . . . . . . . . . . . . . 25 | |||
| Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 24 | Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 25 | |||
| 1. Introduction | 1. Introduction | |||
| In many applications we would like to specify the location of | In many applications we would like to specify the location of | |||
| something geographically. Some examples of locations in networking | something geographically. Some examples of locations in networking | |||
| might be the location of data center, a rack in an internet exchange | might be the location of data center, a rack in an internet exchange | |||
| point, a router, a firewall, a port on some device, or it could be | point, a router, a firewall, a port on some device, or it could be | |||
| the endpoints of a fiber, or perhaps the failure point along a fiber. | the endpoints of a fiber, or perhaps the failure point along a fiber. | |||
| Additionally, while this location is typically relative to Earth, it | Additionally, while this location is typically relative to Earth, it | |||
| skipping to change at page 6, line 49 ¶ | skipping to change at page 6, line 49 ¶ | |||
| namespace "urn:ietf:params:xml:ns:yang:ietf-geo-location"; | namespace "urn:ietf:params:xml:ns:yang:ietf-geo-location"; | |||
| prefix geo; | prefix geo; | |||
| import ietf-yang-types { | import ietf-yang-types { | |||
| prefix yang; | prefix yang; | |||
| reference "RFC 6991: Common YANG Data Types."; | reference "RFC 6991: Common YANG Data Types."; | |||
| } | } | |||
| organization | organization | |||
| "IETF NETMOD Working Group (NETMOD)"; | "IETF NETMOD Working Group (NETMOD)"; | |||
| contact | contact | |||
| "Christian Hopps <chopps@chopps.org>"; | "WG Web: <https://datatracker.ietf.org/wg/netmod/> | |||
| WG List: <mailto:netmod@ietf.org> | ||||
| Editor: Christian Hopps | ||||
| <mailto:chopps@chopps.org>"; | ||||
| // RFC Ed.: replace XXXX with actual RFC number or IANA reference | // RFC Ed.: replace XXXX with actual RFC number or IANA reference | |||
| // and remove this note. | // and remove this note. | |||
| description | description | |||
| "This module defines a grouping of a container object for | "This module defines a grouping of a container object for | |||
| specifying a location on or around an astronomical object (e.g., | specifying a location on or around an astronomical object (e.g., | |||
| 'earth'). | 'earth'). | |||
| Copyright (c) 2019 IETF Trust and the persons identified as | Copyright (c) 2019 IETF Trust and the persons identified as | |||
| End of changes. 8 change blocks. | ||||
| 13 lines changed or deleted | 17 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/ | ||||