[netmod] Impact of changing an import statement on YANG versioning (https://github.com/netmod-wg/yang-ver-dt/issues/4)

"Reshad Rahman (rrahman)" <rrahman@cisco.com> Tue, 07 July 2020 15:50 UTC

Return-Path: <rrahman@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 68B2E3A0EEA for <netmod@ietfa.amsl.com>; Tue, 7 Jul 2020 08:50:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.597
X-Spam-Level:
X-Spam-Status: No, score=-9.597 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, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, 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=hJCuGP6X; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=Fz5YjFeG
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 2oX60s0ZXxvJ for <netmod@ietfa.amsl.com>; Tue, 7 Jul 2020 08:50:57 -0700 (PDT)
Received: from alln-iport-5.cisco.com (alln-iport-5.cisco.com [173.37.142.92]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A23BB3A0EE9 for <netmod@ietf.org>; Tue, 7 Jul 2020 08:50:57 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=11961; q=dns/txt; s=iport; t=1594137057; x=1595346657; h=from:to:subject:date:message-id:mime-version; bh=zmc5m9wbDuLiqYvd8U5FqGn//Ajxhn2fy+6sLC/M8v0=; b=hJCuGP6XVXfYd2GpkBGKLq9DXtVtK2T/0Linum9VT8aE8oIE+FfkTSVX 94G3fIgFzyi8hGKarZmYCnTdJ0j3HlaNSu+SZkG117xssA/rvs9+itc7p QnGRbAVBVqZjg2g/LX5p2nXGV+Kqzwo+shVmnuGvErcDKByVAMq7srOzG I=;
IronPort-PHdr: =?us-ascii?q?9a23=3A48aWdBdLK9hrDRWS6RUi/EmnlGMj4e+mNxMJ6p?= =?us-ascii?q?chl7NFe7ii+JKnJkHE+PFxlwaQB9fa5u5Kze3MvPOoVW8B5MOHt3YPONxJWg?= =?us-ascii?q?QegMob1wonHIaeCEL9IfKrCk5yHMlLWFJ/uX3uN09TFZX/akHc5Hqo4m1aFh?= =?us-ascii?q?D2LwEgIOPzF8bbhNi20Obn/ZrVbk1IiTOxbKk0Ig+xqFDat9Idhs1pLaNixw?= =?us-ascii?q?=3D=3D?=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0DwEABFmQRf/5xdJa1gHQEBKwsGAQU?= =?us-ascii?q?FAQIBCQGBYYEhL1EHb1gvLAqEKINEAgOhO4RrglIDVQsBAQEMAQEjCgIEAQG?= =?us-ascii?q?EYIF6AiQ4EwIDAQELAQEFAQEBAgEGBG2FWwELhgcRHQEBOBEBQwcCBDAnBDW?= =?us-ascii?q?DBAGBfk0DLgEOnkUCgTmIYXaBMoMBAQEFhRgYgg4DBoE4AYJoigEagUE/gTg?= =?us-ascii?q?cgh9sglwChHUzgi2PJIMXhkOLO5BWCoJcBIhHkH8DHYJznCoYhTMPjACBZYg?= =?us-ascii?q?3lEUCBAIEBQIOAQEFgWoiKYEtcBVlAYI+UBcCDY5VGIMiilZ0NwIGAQcBAQM?= =?us-ascii?q?JfI5eAYEQAQE?=
X-IronPort-AV: E=Sophos;i="5.75,324,1589241600"; d="scan'208,217";a="520248145"
Received: from rcdn-core-5.cisco.com ([173.37.93.156]) by alln-iport-5.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 07 Jul 2020 15:50:56 +0000
Received: from XCH-RCD-002.cisco.com (xch-rcd-002.cisco.com [173.37.102.12]) by rcdn-core-5.cisco.com (8.15.2/8.15.2) with ESMTPS id 067Fou5n030929 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL) for <netmod@ietf.org>; Tue, 7 Jul 2020 15:50:56 GMT
Received: from xhs-rcd-003.cisco.com (173.37.227.248) by XCH-RCD-002.cisco.com (173.37.102.12) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 7 Jul 2020 10:50:56 -0500
Received: from xhs-rtp-002.cisco.com (64.101.210.229) by xhs-rcd-003.cisco.com (173.37.227.248) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 7 Jul 2020 10:50:56 -0500
Received: from NAM11-BN8-obe.outbound.protection.outlook.com (64.101.32.56) by xhs-rtp-002.cisco.com (64.101.210.229) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Tue, 7 Jul 2020 11:50:55 -0400
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=TuWoeVCQ/W20jHKNcdr8BwOxwGM3+z5RpIXDY6U1Efkg4n197u3L1tqVHzkfIuSXWJETD9vokLN982YFPjTLD9k0ufDyiGMMOmdrNW0M/EUcBiod+dM4vq1ofFb1MvRyDm9YECl0CCAQIPEy2K5RgsPhVAqgWEGV5qdkk006DXfwpipMa2xkwVulmCA6UQ5D08HAUGPgKwB9UBDyj3FfxR1yvNwdA/48pElmE8za2MAD1ORtbalqqdVPRiSbgrONqYJGTaU+Ga4TkRPZJY7zLFVKVIzd/g4T08CxayYTK2VkTd34i0BuMcZhyYtsXwAmM3D/+B4WoYIFl8nmLtvBLA==
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=zmc5m9wbDuLiqYvd8U5FqGn//Ajxhn2fy+6sLC/M8v0=; b=i0ItYoR6Pen6K2DkUcyzlPyW/3ZsCWZ+lQKAUBrN/3+Q/zg8BA8/2+M3bwLIJYgVIw5fscGAM4RGuPhJriF9+BURriDCRszbuzqPMKKoaNI9AG0vsHc7wZyIJO7wl3uO2Lv/xJ3p1Gjwbzk5Ua5CMDupMKdknxznUk0w+LdznkkLjpaiwABZzeyxF/mMNr/kdMTvdgA/22jyx8oB2VylclYki+asHhQjY3S97JRl7c97BWGYKgFqiWYFF+sKzFbz2wTHXjuxLthKYENkIeg6ZylrMicJb0+mg+RT0WVBA9U3MDyd2VR9I1+pOe6fEkG9sZMyCaJydZTVFArecXZQ9g==
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=zmc5m9wbDuLiqYvd8U5FqGn//Ajxhn2fy+6sLC/M8v0=; b=Fz5YjFeGlR1+p3qMvcY40UnH8t/W392yDFYpm/LzdHTqNMxPlUaJ/Xm2vUOUE27dVRn0eZYr1tsgjcsMhF3Tt5A8xsTOFkx+pvQcrEtRzJR4Co7JNw6grQcHRND7bGtmoBtLwdr3+X3IVaqWwzOWpm0URLaxO7wHxqt7tPEk+v0=
Received: from BN6PR11MB3875.namprd11.prod.outlook.com (2603:10b6:405:80::37) by BN6PR11MB1234.namprd11.prod.outlook.com (2603:10b6:404:47::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3153.27; Tue, 7 Jul 2020 15:50:55 +0000
Received: from BN6PR11MB3875.namprd11.prod.outlook.com ([fe80::3076:a505:335e:a8ff]) by BN6PR11MB3875.namprd11.prod.outlook.com ([fe80::3076:a505:335e:a8ff%6]) with mapi id 15.20.3153.029; Tue, 7 Jul 2020 15:50:55 +0000
From: "Reshad Rahman (rrahman)" <rrahman@cisco.com>
To: "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: Impact of changing an import statement on YANG versioning (https://github.com/netmod-wg/yang-ver-dt/issues/4)
Thread-Index: AQHWVHZm1m3u+RdSCESjzd5vduTl6w==
Date: Tue, 7 Jul 2020 15:50:54 +0000
Message-ID: <A75AE5E2-953B-47AD-841D-552254047C86@cisco.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/16.37.20051002
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: [142.113.229.50]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 805cf738-a350-4874-abe9-08d8228d88b0
x-ms-traffictypediagnostic: BN6PR11MB1234:
x-microsoft-antispam-prvs: <BN6PR11MB1234B7DD6C579021BA015389AB660@BN6PR11MB1234.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-forefront-prvs: 0457F11EAF
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: NqV3ukqS9cJ+q8sWKkbaJlOVZNgUaLdVAxhkZBC808e6X1y5azKwSRxKWbKUBc4MMaQokC9G+hlXV3hiYL9pz7XNzF6pvmEwHwzMTKsiHhVWe0WTZz3gBe7ZP0li7lj6fpmh9rbC27UHY2hb+XtPBf08cAzGcZ2l2TaaSqvLTkbSkpg2nEvfQzSD5xqTvJuliWFnCf5biHUfpyPTZ/vdIFOlH585wycpgWiIbBkZFdpNdw6ZXejmOjta05T9JHW2PnU8hkmAnZUZPnBaCEkMwbT2Xq3EbqDzAWZI5rntNYOjODddTdQgInE+M50nUqh4UuS1obcVPVnAOrCCki02wUpZFPSkHciG987gRWxVl/3aSreuPAJGcjgQ40T+3AUbPCV+7A74l6Ys2tnCQ+RSvg==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BN6PR11MB3875.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(136003)(39860400002)(376002)(366004)(346002)(396003)(8936002)(71200400001)(8676002)(2616005)(186003)(2906002)(6512007)(66556008)(6506007)(64756008)(66446008)(66946007)(66476007)(26005)(86362001)(83380400001)(76116006)(478600001)(6916009)(33656002)(91956017)(5660300002)(36756003)(6486002)(316002)(9326002); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: Qy+bcQx2GnKEUVPunk6aiEHNngoYaOUXiiyZRy1xy9JAqEZ3mdeBOUVdJh78jdh7QYnJb3mfd062Rw80CmlULde7ZP4MT8qhWUMYG49DkvBT6Q2u+N9l/ZffqoN2/1i7OZciV3BJ/blVWp9MEEwn64/R70VP2xeRHCs7gHitbEttvV0MerXmbiUBx7+29dQRoOdAl5CcPqE2Nz9kxmsF9ilSGhne4RM00YdKCXSCB22fT2gLqPZLqHuQVKrRXzwkC4iwg7Zt7tKYuq51faO69zEDEYJ4lwT2K0C/GdtiutDUbD4Y8gr+9jee/SEvnYGXJKWnxfp9qKrfiqgNPhpJ7vyFM86VNBsHw1rg6RFIZM8aGNFyxqW2ub1xBJ5DbOw52pZCDi+xUe3Zc/ALfuWreEhbGzQcpv8XGaKSOC3qRftFhneCyWzWeDnvW/fKvXU6GrVsPVTaW93zBHeqQdFMk54AdCGRU19Nhd9PufovSWM91+lL+2ukUyHXkAeEHttg
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_A75AE5E2953B47AD841D552254047C86ciscocom_"
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: BN6PR11MB3875.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 805cf738-a350-4874-abe9-08d8228d88b0
X-MS-Exchange-CrossTenant-originalarrivaltime: 07 Jul 2020 15:50:54.9629 (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: FL4imYJJ1v0azjiC50+dFikrGhJGPh+bC0OiT6NdfqlBdr8YzsnbMnQiAy0ScdGmN0MfjxYTZ9E12gLdvu8I4A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR11MB1234
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.12, xch-rcd-002.cisco.com
X-Outbound-Node: rcdn-core-5.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/7Na3BOKiLxwylDaij9fiupJx-u8>
Subject: [netmod] Impact of changing an import statement on YANG versioning (https://github.com/netmod-wg/yang-ver-dt/issues/4)
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: Tue, 07 Jul 2020 15:51:00 -0000

Hi,

We’ve been having discussions on the impact of changing an import statement and would like to get thoughts from the WG.

Consider module A which imports module B.

  1.  Module A revision 1.0.0 has “revision-or-derived 1.0.0” for import of module B.
import moduleB {
  rev:revision-or-derived 1.0.0;
}
  2.  An update to module A so that it needs to import at least 2.0.0 of module B
import moduleB {
  rev:revision-or-derived 2.0.0;
}

When module’s A import is updated in step b, we’ve discussed 3 options:

  1.  Always consider the change as BC (new revision 1.1.0 for module A) and let the client figure out the impact on its use of module A
  2.  Always consider the change as NBC (new revision 2.0.0 for module A, tag the import as NBC using nbc-change extension) and let the client figure out the impact on its use of module A
  3.  Handle this conditionally. So if the impact on module A is NBC (depending on whether module A’s namespace has been impacted in NBC way),  do as in 2 (this can have ripple effect on importing module hierarchy, e.g. module C uses module A, module D uses module C etc). If the impact on module A is BC, do as in 1

Regards,
Reshad.