[netmod] Proposed IANA text for YANG Module Versioning and Semver Drafts
"Rob Wilton (rwilton)" <rwilton@cisco.com> Wed, 03 March 2021 11:07 UTC
Return-Path: <rwilton@cisco.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 336C63A0D1E for <netmod@ietfa.amsl.com>; Wed, 3 Mar 2021 03:07:34 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.62
X-Spam-Level:
X-Spam-Status: No, score=-9.62 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com header.b=gFcwaiKA; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=RsilEip2
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id XHzqBXqIFLEZ for <netmod@ietfa.amsl.com>; Wed, 3 Mar 2021 03:07:32 -0800 (PST)
Received: from alln-iport-6.cisco.com (alln-iport-6.cisco.com [173.37.142.93]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id BC5763A0D08 for <netmod@ietf.org>; Wed, 3 Mar 2021 03:07:31 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=5529; q=dns/txt; s=iport; t=1614769651; x=1615979251; h=from:to:subject:date:message-id: content-transfer-encoding:mime-version; bh=hPIT/EYWAOAA+2Y4hV+X2nFL3esZNfUm8vCav5zUl8w=; b=gFcwaiKAbF7nRBhT6TyDUXe4cp8kCpsPAt9nWk17O6+t08z0ji3npGQm eMRZMyCnDzwHOjIm2Dl69mXId+8gLtiTtiKale0/ibBfoXjwy/04KHVv9 cF1XjcFefPf/3D5huj/BfE574aPAh6OT9dZOgpNRQoGbuGAeAmpcfvESB Q=;
X-IPAS-Result: A0A5AgBxbD9gmIcNJK1ZCYEJgU+BU1F9WjYxCgGHfgOFOYhWmSSBLhSBEQNUCwEBAQ0BASgKAgQBAYETAYM5AoF6AiU0CQ4CAwEBAQMCAwEBAQEFAQEBAgEGBBQBAQEBAQEBAYY2AQyHBQYBATgRAT5CJgEEG4JoAYJVAy8BAwuiQwKKJXSBNIMEAQEGhSoYghIDBoE4gnaGWYQaHIFJQoERQ4Ipg0gCgTQSHINIgiuBTwpxAQE8Ki8kIAIkIIEXFSAKOJtMjCWQOYEUCoJ8iT+TA4M3ik+TB4JJjwOFUoIJiTSSAoReAgQCBAUCDgEBBoFUOCyBLXAVO4JpUBcCDY44g1aKWXM4AgYKAQEDCXyKCAGBDgEB
IronPort-PHdr: 9a23:PcR4CBAEob7mO1f35Ry+UyQJPHJ1sqjoPgMT9pssgq5PdaLm5Zn5IUjD/qw01g3IUJnVrfVehLmev6PhXDkG5pCM+DAHfYdXXhAIwcMRg0Q7AcGDBEG6SZyibyEzEMlYElMw+Xa9PBtUFdrwIVrIrS764TsbAB6qMw1zK6z8EZLTiMLi0ee09tXTbgxEiSD7b6l1KUC9rB7asY8dho4xJw==3D
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-AV: E=Sophos;i="5.81,219,1610409600"; d="scan'208";a="695656832"
Received: from alln-core-2.cisco.com ([173.36.13.135]) by alln-iport-6.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 03 Mar 2021 11:07:30 +0000
Received: from mail.cisco.com (xbe-rcd-007.cisco.com [173.37.102.22]) by alln-core-2.cisco.com (8.15.2/8.15.2) with ESMTPS id 123B7Ubd010767 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=OK) for <netmod@ietf.org>; Wed, 3 Mar 2021 11:07:30 GMT
Received: from xfe-rcd-002.cisco.com (173.37.227.250) by xbe-rcd-007.cisco.com (173.37.102.22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.792.3; Wed, 3 Mar 2021 05:07:30 -0600
Received: from xfe-rcd-003.cisco.com (173.37.227.251) by xfe-rcd-002.cisco.com (173.37.227.250) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.792.3; Wed, 3 Mar 2021 05:07:29 -0600
Received: from NAM10-DM6-obe.outbound.protection.outlook.com (72.163.14.9) by xfe-rcd-003.cisco.com (173.37.227.251) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.792.3 via Frontend Transport; Wed, 3 Mar 2021 05:07:29 -0600
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=RHy2x+KLuqcT0Ba53DUX9WDdZ5aCYWjB4sqwqa7yvHEsOZkyj5IjQx0hVH9LqlObdzgxgzeW8v6QNqrdjyX9J0LhOhcpQYW80N7yu0JUWoRNooWBPnmjdOCdE0x4k+cIWvr0+jIY6z0YTuO7Kz+F9k14LpiNf+pZw51SvQosbUuVucP7dJ15MYH/yzedTIWPw51uTu8FVDD6XkE8dMg1837ghMBlUn2SlOKFcJGtcwtYvUmoXI/yUyZBa6QNwxcVM2kbHKic4qNK+mv7nGOSa1m+hRO+rFCB7vCRX51T/O1LSSElj3I0k3DjplW2tU3MNEoo7dqIxdV5jH96TnFetg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ESCK1bJXgzYep56wiuZzOetlZpCxINEdliarv0PJrvw=; b=ksy/HyN/fRZM3N4JbtWWMuRbNw92hFd3OgUoVIV72G+3Kv3lTYh3QcdHLC/WnEIPNAD6K9VxdFT+joLHhAaQdAZPxTmduM9kjcWODAAsMYqnjrG86QCmkbhddbZysttM+BCPSB4JRylu2z7pgrWbazMmkYlhr9b1DQcIK8Dwri70058vR82hERz9u/st9jloFF+DS0Ygf6azSH4ghGrcQR3pck8RpJN4yyWSjDJMRydsEp0qO73OTrcB44T0N80jJBwUcMPvRrUPjihUeVCOEWTHTV+rBNPHlzeEfSKg0+J4Pz/n60HFkeShSl/6lB9a8gZE4haRHFKnrj/tD697cg==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cisco.com; dmarc=pass action=none header.from=cisco.com; dkim=pass header.d=cisco.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector2-cisco-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=ESCK1bJXgzYep56wiuZzOetlZpCxINEdliarv0PJrvw=; b=RsilEip2pflpRfoRyTgo9aHTolzjgzEJSIabPwQp3bry7YCjW4FW49QEfOVy8MRoUIIj2cDpYpzZtouIYtJSlCtw2Xg4c2/TVnx2xfr0oBCB9eoq7W5RBmaxpAGrPebBl8L7UXsEA9rmnefbqCk5Td6ZOWXLbWJw5YviOViuPpo=
Received: from MN2PR11MB4366.namprd11.prod.outlook.com (2603:10b6:208:190::17) by BL0PR11MB3252.namprd11.prod.outlook.com (2603:10b6:208:6e::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3890.28; Wed, 3 Mar 2021 11:07:28 +0000
Received: from MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::24c4:4c09:f6f0:5510]) by MN2PR11MB4366.namprd11.prod.outlook.com ([fe80::24c4:4c09:f6f0:5510%2]) with mapi id 15.20.3890.028; Wed, 3 Mar 2021 11:07:28 +0000
From: "Rob Wilton (rwilton)" <rwilton@cisco.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: Proposed IANA text for YANG Module Versioning and Semver Drafts
Thread-Index: AdcQG/9VJO5KypwRTzuE8gHDegltpg==
Date: Wed, 03 Mar 2021 11:07:28 +0000
Message-ID: <MN2PR11MB4366F075349FF0012FEC1FD1B5989@MN2PR11MB4366.namprd11.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
authentication-results: ietf.org; dkim=none (message not signed) header.d=none;ietf.org; dmarc=none action=none header.from=cisco.com;
x-originating-ip: [82.12.233.180]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 384cb8e1-5dce-4522-f224-08d8de3488d3
x-ms-traffictypediagnostic: BL0PR11MB3252:
x-microsoft-antispam-prvs: <BL0PR11MB3252FCF42A71F47F72120919B5989@BL0PR11MB3252.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: PeGmZpJ2FVkkkslZ99diPbTbnOirl5rdTvbyi0c9fceZYEGa5jhXaLNbKeg9dRpaxsj1JrO2QJ+ntGq8I5IWGW9b40khFBpGsV48JY0f4BeHwvZOAcVuNihkRW/QuE9PARvzremCCTHXT4qc+CfdkLhu1BOHx2RUmtz4BYUZCH+1QejxOBeiNayNDThf6XtrLlZm3tGtCe0/aHPs2s4j64QicJEempato9+3LqQ1rerNmRxPG+9tEdQTRBtT/VuHomxpoi0tmJ3vlQtauMoseTah+kcY+t2zqYiQhaXDVo16KiNNfAD2U3a3x9/MRjHodcFxvOR4UQPcPoteb2T6pjCcH1gsIF5kv44HEe7bpDiuL3K8C4XGJKj+liZw+z9ppngFJnEqDBFPTYVAdet+t4657ET1m8GswxWMpUd+H6fQFnZbjdTn35qfOXtkm6JR1pPziTAsUJw2ArrwX9Q/Ht8ilsCsYbQ8urDmf6zM5s2Ai2fTXqkX6HzY/ljPg6TfLu7fe9JGFsrsifk+D5NZzhlY1B/roarpEBLYPsiti6RUOhq8dIGvfbXSexCl6ii8lxJbwS1bDNZlr2bdj5+VkE02bxctKZugdKj2L5g/5qs=
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MN2PR11MB4366.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(396003)(136003)(39860400002)(346002)(376002)(64756008)(66446008)(66556008)(66476007)(86362001)(76116006)(66946007)(6506007)(4001150100001)(316002)(5660300002)(26005)(33656002)(8676002)(8936002)(2906002)(52536014)(7696005)(478600001)(186003)(966005)(9686003)(55016002)(83380400001)(71200400001)(6916009); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: itx2/ZPkiyzF93+jzzFy5fHzdipqgYXadhV1WLdfJYoeQlX74NljvaMsycPUagQKDDtkhw63ziRbqbFqoVVwIdn1LTBiw0wb6kbXMFXvj+Qtc9dKYKljCy7mqmcB8KvpO+9MZ/epuYR4tNwI757xXtYHZxgmn4UF1SOp2zPqMD+jqxu7XkODf6ibEV635RrXbVl3kMOkJu5z7iMrnqWOqc8Oj2EZWdCGW6xcdoIR72DgicR6yspWbYFeo8SSGLgQAgUjdFR/PK7Yh48szvpya863NVI+JCjaTHU1GIyL382EgPxa3fa2eIBZCStjDZFigcslb8zXXhZGwRCwNysFJhPISVuKmWM9nTKWvPZPuvVSfOrOmfhLzCEtpTnytTgDNc07nPIEC8yQEfEoO1scUSHiptQmkvgSVRWLU0yumMS8iicIXOMiCquXsXHdcuPdE1AYjQYVehTwOmsDV12iJpkCYLIhptoM8yMSJaWAeuwfUuiYLNUaqMQMNWbTnUV8D2x8DbCv68LpRM0QxFgAciiUNeRpaGA3QuTVOP64xdMSwApwybETlnG0fAjaB4/KXBDp8YPMYVG6I/kfq3bnCAiiKS7vE/9sUJUchq8zmM94yjNZNg+eitdUtyAkQ3KiOVr/UfKVWISh8v0N2RWLEk384ZyMRTP/p5wng1n8hztjvDpbm1ZVKCb6Ss/9izCv6UGe157KuonNBrZLmfsMPjR9VS/SyRRrf6QZAJZffs8ICVi4t0EWsr2BGSU76gIrLSAIYAsYegpNZHz7M+dXziZvFEMZ4hHPrvhc4nRHCzJF+AlhjhFI+LKvovs7Yv7CfzT72D0kI9vTUP2fGG99UEHONPfoMho0P5JSpl70JjTLjJa76QYl12xQwvM3lQdu7ZpxJAbImaAftOFfJXMIb8mBKo7LAle1ZtckGPW2QabsWgidnTGrDH2X+Rk2rKUDW2MvvDqwPNMVKbeXuJ3iW6UbADBHt0Fx4dB31t332iXN90Uybjqddeax99iVSgSHPgrvPH2bPfTefMYTEsYeVsHKS0A0A3jOyT5svrXdp3lXFBFUchR7Kw/Ew0xlCc/IJieD1yY10gTYSg3KhB/HpQdCJaFocHbYuJF4wT40Uzm8pIoqCXWHFbvF9OQMOowtrt8N5Acx7gWvRFq1hTnWttTHmXdz0w1W8H2D7OLxwuKod5Z2+KcHzNWXMKyDv3f8dM0dlcQlyjW2L9/jhqbj6nLG1v9ChTtTkbvBNk7l9rmBPz7U92ktdRVArnBqggbZhiVCm4GFYsiK7iWTjPg4jnU+QLlyhuz0gbvSIHwe/reVKwFQ9nMpBdc6ag+khPZN
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: MN2PR11MB4366.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 384cb8e1-5dce-4522-f224-08d8de3488d3
X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Mar 2021 11:07:28.6813 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5ae1af62-9505-4097-a69a-c1553ef7840e
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: f5DncZBrsiMkbAlSkhX/dKGMuKeCOoRHRVx2ivPBr/KB0/iYy1P0PuvL4wIdY+iX8BV7GJwRqqlMubtARwvj0g==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BL0PR11MB3252
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.22, xbe-rcd-007.cisco.com
X-Outbound-Node: alln-core-2.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/idZqgFkPhbXe5fyILlcGILGtAt4>
Subject: [netmod] Proposed IANA text for YANG Module Versioning and Semver Drafts
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 03 Mar 2021 11:07:34 -0000
Hi, // As an individual contributor We discussed proposed IANA text at the last NETMOD interim on the YANG versioning work. Tracked by issue https://github.com/netmod-wg/yang-ver-dt/issues/59 I had the action of updating the text based on comments received in the interim meeting and then sending that text to the list. The proposed text is below (that is in the current published versions of both drafts). If the WG has no objections to this text, then the planned next step is to ask IANA for an early review of this text. IANA section in draft-ietf-netmod-yang-module-versioning-02: 11.2. Guidance for versioning in IANA maintained YANG modules Note for IANA (to be removed by the RFC editor): Please check that the registries and IANA YANG modules are referenced in the appropriate way. IANA is responsible for maintaining and versioning YANG modules that are derived from other IANA registries. For example, "iana-if- type.yang" [IfTypeYang] is derived from the "Interface Types (ifType) IANA registry" [IfTypesReg], and "iana-routing-types.yang" [RoutingTypesYang] is derived from the "Address Family Numbers" [AddrFamilyReg] and "Subsequent Address Family Identifiers (SAFI) Parameters" [SAFIReg] IANA registries. Normally, updates to the registries cause any derived YANG modules to be updated in a backwards-compatible way, but there are some cases where the registry updates can cause non-backward-compatible updates to the derived YANG module. An example of such an update is the 2020-12-31 revision of iana-routing-types.yang [RoutingTypesDecRevision], where the enum name for two SAFI values was changed. In all cases, IANA MUST follow the versioning guidance specified in Section 3.1, and MUST include a "rev:nbc-changes" substatement to the latest revision statement whenever an IANA maintained module is updated in a non-backwards-compatible way, as described in Section 3.2. Note: For published IANA maintained YANG modules that contain non- backwards-compatible changes between revisions, a new revision should be published with the "rev:nbc-changes" substatement retrospectively added to any revisions containing non-backwards-compatible changes. Non normative examples of updates to enumeration types in IANA maintained modules that would be classified as non-backwards- compatible changes are: Changing the status of an enumeration typedef to obsolete, changing the status of an enum entry to obsolete, removing an enum entry, changing the identifier of an enum entry, or changing the described meaning of an enum entry. Non normative examples of updates to enumeration types in IANA maintained modules that would be classified as backwards-compatible changes are: Adding a new enum entry to the end of the enumeration, changing the status or an enum entry to deprecated, or improving the description of an enumeration that does not change its defined meaning. Non normative examples of updates to identity types in IANA maintained modules that would be classified as non-backwards- compatible changes are: Changing the status of an identity to obsolete, removing an identity, renaming an identity, or changing the described meaning of an identity. Non normative examples of updates to identity types in IANA maintained modules that would be classified as backwards-compatible changes are: Adding a new identity, changing the status or an identity to deprecated, or improving the description of an identity that does not change its defined meaning. IANA section for draft-ietf-netmod-yang-semver-02 9.2. Guidance for YANG Semver in IANA maintained YANG modules Note for IANA (to be removed by the RFC editor): Please check that the registries and IANA YANG modules are referenced in the appropriate way. IANA is responsible for maintaining and versioning some YANG modules, e.g., iana-if-types.yang [IfTypeYang] and iana-routing-types.yang [RoutingTypesYang] . In addition to following the rules specified in the IANA Considerations section of [I-D.ietf-netmod-yang-module-versioning] , IANA maintained YANG modules MUST also include a YANG Semver revision label for all new revisions, as defined in Section 3 . The YANG Semver version associated with the new revision MUST follow the rules defined in Section 3.3 . Note: For IANA maintained YANG modules that have already been published, revision labels MUST be retrospectively applied to all existing revisions when the next new revision is created, starting at version "1.0.0" for the initial published revision, and then incrementing according to the YANG Semver version rules specified in Section 3.3 . Most changes to IANA maintained YANG modules are expected to be backwards-compatible changes and classified as MINOR version changes. The PATCH version may be incremented instead when only editorial changes are made, and the MAJOR version would be incremented if non- backwards-compatible major changes are made. Given that IANA maintained YANG modules are versioned with a linear history, it is anticipated that it should not be necessary to use the "_compatible" or "_non_compatible" modifiers to the "Z_COMPAT" version element. Comments welcome. Thanks, Rob
- Re: [netmod] Proposed IANA text for YANG Module V… Ladislav Lhotka
- [netmod] Proposed IANA text for YANG Module Versi… Rob Wilton (rwilton)
- Re: [netmod] Proposed IANA text for YANG Module V… Rob Wilton (rwilton)
- Re: [netmod] Proposed IANA text for YANG Module V… Ladislav Lhotka
- Re: [netmod] Proposed IANA text for YANG Module V… tom petch