--- 1/draft-ietf-dhc-dhcpv6-yang-14.txt 2020-12-22 05:13:20.100737656 -0800 +++ 2/draft-ietf-dhc-dhcpv6-yang-15.txt 2020-12-22 05:13:20.288742439 -0800 @@ -1,25 +1,25 @@ DHC Working Group Y. Cui Internet-Draft L. Sun Intended status: Standards Track Tsinghua University -Expires: 17 June 2021 I.F. Farrer +Expires: 25 June 2021 I.F. Farrer S.Z. Zechlin Deutsche Telekom AG Z. He Tsinghua University M.N. Nowikowski Internet Systems Consortium - 14 December 2020 + 22 December 2020 YANG Data Model for DHCPv6 Configuration - draft-ietf-dhc-dhcpv6-yang-14 + draft-ietf-dhc-dhcpv6-yang-15 Abstract This document describes YANG data modules for the configuration and management of DHCPv6 servers, relays, and clients. Requirements Language The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and @@ -35,21 +35,21 @@ Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." - This Internet-Draft will expire on 17 June 2021. + This Internet-Draft will expire on 25 June 2021. Copyright Notice Copyright (c) 2020 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights @@ -67,47 +67,47 @@ 1.3. Terminology . . . . . . . . . . . . . . . . . . . . . . . 4 2. DHCPv6 Tree Diagrams . . . . . . . . . . . . . . . . . . . . 5 2.1. DHCPv6 Server Tree Diagram . . . . . . . . . . . . . . . 5 2.2. DHCPv6 Relay Tree Diagram . . . . . . . . . . . . . . . . 12 2.3. DHCPv6 Client Tree Diagram . . . . . . . . . . . . . . . 14 3. DHCPv6 YANG Modules . . . . . . . . . . . . . . . . . . . . . 17 3.1. DHCPv6 Server YANG Module . . . . . . . . . . . . . . . . 17 3.2. DHCPv6 Relay YANG Module . . . . . . . . . . . . . . . . 31 3.3. DHCPv6 Client YANG Module . . . . . . . . . . . . . . . . 40 3.4. RFC8415 Server Options YANG Module . . . . . . . . . . . 50 - 3.5. RFC8415 Relay Options YANG Module . . . . . . . . . . . . 57 - 3.6. RFC8415 Client Options YANG Module . . . . . . . . . . . 64 - 3.7. DHCPv6 Common YANG Module . . . . . . . . . . . . . . . . 70 - 4. Security Considerations . . . . . . . . . . . . . . . . . . . 74 - 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 75 - 6. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 76 - 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 76 - 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 77 - 8.1. Normative References . . . . . . . . . . . . . . . . . . 77 - 8.2. Informative References . . . . . . . . . . . . . . . . . 79 + 3.5. RFC8415 Relay Options YANG Module . . . . . . . . . . . . 58 + 3.6. RFC8415 Client Options YANG Module . . . . . . . . . . . 65 + 3.7. DHCPv6 Common YANG Module . . . . . . . . . . . . . . . . 71 + 4. Security Considerations . . . . . . . . . . . . . . . . . . . 75 + 5. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 77 + 6. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 78 + 7. Contributors . . . . . . . . . . . . . . . . . . . . . . . . 78 + 8. References . . . . . . . . . . . . . . . . . . . . . . . . . 78 + 8.1. Normative References . . . . . . . . . . . . . . . . . . 78 + 8.2. Informative References . . . . . . . . . . . . . . . . . 80 Appendix A. Example of Augmenting Additional DHCPv6 Option - Definitions . . . . . . . . . . . . . . . . . . . . . . . 79 + Definitions . . . . . . . . . . . . . . . . . . . . . . . 80 Appendix B. Example Vendor Specific Server Configuration - Module . . . . . . . . . . . . . . . . . . . . . . . . . 83 + Module . . . . . . . . . . . . . . . . . . . . . . . . . 84 Appendix C. Example definition of class selector - configuration . . . . . . . . . . . . . . . . . . . . . . 89 - Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 95 + configuration . . . . . . . . . . . . . . . . . . . . . . 90 + Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . 97 1. Introduction DHCPv6 [RFC8415] is widely used for supplying configuration and other relevant parameters to clients in IPv6 networks. This document defines YANG modules for the configuration and management of DHCPv6 servers, relays and clients. Separate 'element' modules are defined for each of these. There is an additional module per-element defining DHCP options which are relevant for that element (taken from - the options defined in [RFC8415]. + the options defined in [RFC8415]). Additionally, a 'common' module contains typedefs and groupings used by all of the element modules. It is worth noting that as DHCPv6 is itself a client configuration protocol, it is not the intention of this document to provide a replacement for the allocation of DHCPv6 assigned addressing and parameters by using NETCONF/YANG. The DHCPv6 client module is intended for the configuration and monitoring of the DHCPv6 client function and does not play a part in the normal DHCPv6 message flow. @@ -836,37 +836,42 @@ "cuiyong@tsinghua.edu.cn lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com godfryd@isc.org"; description "This YANG module defines components for the configuration and management of DHCPv6 servers. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } + revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } revision 2020-05-26 { description "Version update for draft -11 publication and to align revisions across the different modules."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-11"; } @@ -1523,33 +1528,38 @@ lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com godfryd@isc.org"; description "This YANG module defines components necessary for the configuration and management of DHCPv6 relays. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } + revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -1943,33 +1948,38 @@ lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com godfryd@isc.org"; description "This YANG module defines components necessary for the configuration and management of DHCPv6 clients. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } + revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -2402,34 +2410,46 @@ organization "DHC WG"; contact "cuiyong@tsinghua.edu.cn wangh13@mails.tsinghua.edu.cn lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com"; description "This YANG module contains DHCPv6 options defined - in RFC8415 that can be used by DHCPv6 servers. + in RFC8415 that can be used by DHCPv6 clients. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). - This version of this YANG module is part of RFC 8513; see - the RFC itself for full legal notices."; + This version of this YANG module is part of RFC XXXX + (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself + for full legal notices. + + The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL + NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED', + 'MAY', and 'OPTIONAL' in this document are to be interpreted as + described in BCP 14 (RFC 2119) (RFC 8174) when, and only when, + they appear in all capitals, as shown here."; + + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -2745,34 +2764,46 @@ organization "DHC WG"; contact "cuiyong@tsinghua.edu.cn wangh13@mails.tsinghua.edu.cn lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com"; description "This YANG module contains DHCPv6 options defined - in RFC8415 that can be used by DHCPv6 servers. + in RFC8415 that can be used by DHCPv6 clients. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). - This version of this YANG module is part of RFC 8513; see - the RFC itself for full legal notices."; + This version of this YANG module is part of RFC XXXX + (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself + for full legal notices. + + The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL + NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED', + 'MAY', and 'OPTIONAL' in this document are to be interpreted as + described in BCP 14 (RFC 2119) (RFC 8174) when, and only when, + they appear in all capitals, as shown here."; + + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -3079,32 +3111,44 @@ "cuiyong@tsinghua.edu.cn wangh13@mails.tsinghua.edu.cn lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com"; description "This YANG module contains DHCPv6 options defined in RFC8415 that can be used by DHCPv6 clients. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). - This version of this YANG module is part of RFC 8513; see - the RFC itself for full legal notices."; + This version of this YANG module is part of RFC XXXX + (https://www.rfc-editor.org/info/rfcXXXX); see the RFC itself + for full legal notices. + + The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL', 'SHALL + NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED', 'NOT RECOMMENDED', + 'MAY', and 'OPTIONAL' in this document are to be interpreted as + described in BCP 14 (RFC 2119) (RFC 8174) when, and only when, + they appear in all capitals, as shown here."; + + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -3365,33 +3408,38 @@ contact "yong@csnet1.cs.tsinghua.edu.cn lh.sunlinh@gmail.com ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com"; description "This YANG module defines common components used for the configuration and management of DHCPv6. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } + revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -3809,33 +3857,38 @@ } organization "DHC WG"; contact "ian.farrer@telekom.de godfryd@isc.org"; description "This YANG module contains DHCPv6 options defined in RFC3319 that can be used by DHCPv6 servers. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } + revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -3987,33 +4040,38 @@ ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com"; description "This YANG module defines components for the configuration and management of vendor/implementation specific DHCPv6 server functionality. As this functionality varies greatly between different implementations, the module provided as an example only. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } + revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; } @@ -4294,33 +4353,38 @@ ian.farrer@telekom.de sladjana.zechlin@telekom.de hezihao9512@gmail.com"; description "This YANG module defines components for the definition and configuration of the client class selector function for a DHCPv6 server. As this functionality varies greatly between different implementations, the module provided as an example only. - Copyright (c) 2018 IETF Trust and the persons identified as + Copyright (c) 2020 IETF Trust and the persons identified as authors of the code. All rights reserved. Redistribution and use in source and binary forms, with or without modification, is permitted pursuant to, and subject to the license terms contained in, the Simplified BSD License set forth in Section 4.c of the IETF Trust's Legal Provisions Relating to IETF Documents (http://trustee.ietf.org/license-info). This version of this YANG module is part of RFC 8513; see the RFC itself for full legal notices."; + revision 2020-12-22 { + description "Version update for draft -13 publication."; + reference "I-D: draft-ietf-dhc-dhcpv6-yang-15"; + } + revision 2020-12-10 { description "Version update for draft -13 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-13"; } revision 2020-12-01 { description "Version update for draft -12 publication."; reference "I-D: draft-ietf-dhc-dhcpv6-yang-12"; }