Re: [yang-doctors] Modeling of protocol message structures

"Acee Lindem (acee)" <acee@cisco.com> Thu, 24 September 2020 19:16 UTC

Return-Path: <acee@cisco.com>
X-Original-To: yang-doctors@ietfa.amsl.com
Delivered-To: yang-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 7C8FF3A123F for <yang-doctors@ietfa.amsl.com>; Thu, 24 Sep 2020 12:16:47 -0700 (PDT)
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=G6MlKjv7; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=RHEe3Qq5
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 No2uOlJUFwol for <yang-doctors@ietfa.amsl.com>; Thu, 24 Sep 2020 12:16:45 -0700 (PDT)
Received: from rcdn-iport-2.cisco.com (rcdn-iport-2.cisco.com [173.37.86.73]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id BA7903A123E for <yang-doctors@ietf.org>; Thu, 24 Sep 2020 12:16:45 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=4176; q=dns/txt; s=iport; t=1600975005; x=1602184605; h=from:to:subject:date:message-id:references:in-reply-to: content-id:content-transfer-encoding:mime-version; bh=KJBVDBJi6AQFXc3DgRjY8YZA82j0GaAMmB8/LFJBT3c=; b=G6MlKjv7TPQhcpTPN/JBeDOdBY4Q1+y/1RKiZBBr1TLYoH18cXUQ7Gwo NfxOdU9QDXrD2JnapDzBZvZPNZKH/uNDgBmviFVjZLypEEw5h9W5YYYlU 5+mpAMMGHtxdhGC+Ta4j/dfozenvxIUPe/5wpcseZocFILNBY7ihcKCtH U=;
IronPort-PHdr: 9a23:QPbQLxUDGTOciYvgbh8tPkajy/nV8LGuZFwc94YnhrRSc6+q45XlOgnF6O5wiEPSBNyHufRDiOvf9avnXD9I7ZWAtSUEd5pBH18AhN4NlgMtSMiCFQXgLfHsYiB7eaYKVFJs83yhd0QAHsH4ag7UpX6z5HgZHRCsfQZwL/7+T4jVicn/3uuu+prVNgNPgjf1Yb57IBis6wvLscxDiop5IaF3wRzM8XY=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0AECACe72xf/4YNJK1fHQEBAQEJARIBBQUBQIFPgVIjLgdwWS8sCoQyg0YDpnCCUwNVCwEBAQ0BARgLCgIEAQGESwIXghcCJDgTAgMBAQsBAQUBAQECAQYEbYVcDIVzAgEDAQEQEREMAQEsBAgPAgEIGgImAgICJQsVEAIEARIigwQBgksDLgEOrF0CgTmIYXaBMoMBAQEFgkuCZhiCEAMGgQ4qgnKDaYJBhBIbggCBESccgk0+glwBAYFfgxczggsikAMbKYJwhyScYAqCZ5pVAx+DDI81jkyTBKADAgQCBAUCDgEBBYFrI4FXcBU7KgGCPlAXAg2OHwwXg06FFIVCdDcCBgEJAQEDCXyNaQGBEAEB
X-IronPort-AV: E=Sophos;i="5.77,299,1596499200"; d="scan'208";a="833304970"
Received: from alln-core-12.cisco.com ([173.36.13.134]) by rcdn-iport-2.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 24 Sep 2020 19:16:44 +0000
Received: from XCH-ALN-005.cisco.com (xch-aln-005.cisco.com [173.36.7.15]) by alln-core-12.cisco.com (8.15.2/8.15.2) with ESMTPS id 08OJGive031500 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Thu, 24 Sep 2020 19:16:44 GMT
Received: from xhs-rcd-001.cisco.com (173.37.227.246) by XCH-ALN-005.cisco.com (173.36.7.15) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 24 Sep 2020 14:16:44 -0500
Received: from xhs-aln-003.cisco.com (173.37.135.120) by xhs-rcd-001.cisco.com (173.37.227.246) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Thu, 24 Sep 2020 14:16:44 -0500
Received: from NAM11-BN8-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-003.cisco.com (173.37.135.120) with Microsoft SMTP Server (TLS) id 15.0.1497.2 via Frontend Transport; Thu, 24 Sep 2020 14:16:43 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=C6cJxNpZ8q5HkGfWMaeGtnn0hy3gp15xkEa0MAxNFJQod8aj4NkCS0URardaUDHNpaSQBGQGRdnFmQhcqCfYzmi9B+zr2G0VLqGM60h5lzJCEDnBgX13kszgH9MPQscfzzzFrXT6QgNyBYOpJhlS/oDgAQOMCcPobKXBZ82s8sJy2e0XWTKon6/H5lydLvIBYsutFtPvc1728Z2dmNlc3ewfJHVu/ucHtcwOjtv39PBPx3fMcbvWgUehMrUxG9Orkghf0X99qO7jMpFUl09Kd5wX4bGja/LQaVFTsK+L99DjwQvaCYqzGlUMO82bUypz1GnQZ55N3w/4hNqK5Oy57w==
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=KJBVDBJi6AQFXc3DgRjY8YZA82j0GaAMmB8/LFJBT3c=; b=m4ZYHuKf1vz6S/9hCUPoyuxTy6GXzSD/LAdubqgOGo2OLNrlCbelCooi+Buw9mGlIexqoxB+NCpkGtuLgNz6iZlTM2KllJHM0XtMrDGJb9EI5dvTt85vNn54gqi4S1vyRi3Fzu7gsHoYv0YZ5KJ6+9gMhstnlu5aDa1O9TljRR63rzJjlVvt6S3pgziLve+O/wAcXC0tBS4lVTgmwkMSSMgRytgGvF6ZJ7dC5p2iudc8oRyJxuF6ZmRC7pxs/2pLSa5gscNBrgjxFp4DcD0f29vxlGsx0B1kcQyVnvwaj74Se9aPsVosQuV3LITHo/tJRr6cNExTqW4mXwYLfFILOA==
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=KJBVDBJi6AQFXc3DgRjY8YZA82j0GaAMmB8/LFJBT3c=; b=RHEe3Qq5IwYuFkHqFxOkAXV+eAeKDSz7gDiJEccocRZqbQ79iBd3h4HL3A/b3HDdj8Zi/ugG/B7SfYXBjlYW3V1Q0bkXCwsqtk72gFAKwQnT1NVzIu7i+mIOjCKR4S1hk+y8/ORaw2MK1QCAT/8f/wywJ8zGAhvoKwF24NxEgMA=
Received: from BYAPR11MB2887.namprd11.prod.outlook.com (2603:10b6:a03:89::27) by BY5PR11MB4054.namprd11.prod.outlook.com (2603:10b6:a03:189::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3412.22; Thu, 24 Sep 2020 19:16:43 +0000
Received: from BYAPR11MB2887.namprd11.prod.outlook.com ([fe80::1ddc:cdb4:32cc:f078]) by BYAPR11MB2887.namprd11.prod.outlook.com ([fe80::1ddc:cdb4:32cc:f078%3]) with mapi id 15.20.3412.021; Thu, 24 Sep 2020 19:16:43 +0000
From: "Acee Lindem (acee)" <acee@cisco.com>
To: Ebben Aries <ebben.aries@nokia.com>, YANG Doctors <yang-doctors@ietf.org>
Thread-Topic: [yang-doctors] Modeling of protocol message structures
Thread-Index: AQHWkqQ2seCe7hAhyE2SXKg4AxgmoKl35iCA
Date: Thu, 24 Sep 2020 19:16:42 +0000
Message-ID: <674AE5F9-72B6-41B5-A5FF-3904A0C59BE1@cisco.com>
References: <20200924185441.GA11798@localhost>
In-Reply-To: <20200924185441.GA11798@localhost>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/16.40.20081000
authentication-results: nokia.com; dkim=none (message not signed) header.d=none;nokia.com; dmarc=none action=none header.from=cisco.com;
x-originating-ip: [136.56.133.70]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 0735dbae-b02b-4563-106b-08d860be5f45
x-ms-traffictypediagnostic: BY5PR11MB4054:
x-microsoft-antispam-prvs: <BY5PR11MB4054B7A253CA149E65C0DB1AC2390@BY5PR11MB4054.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: rrPhhbWpTdwW/rhAZZZJlf1zd3HjTyYU3RNzLn0pN+mR23v3lx2dRtBcThl3hMG+Zc/+72EjMj4HvEGZY91Cov2VqLs/b9Qa/xt3qkDXbTF4qkCafBz+fM/z891jgaKPAk43PVEtWthjrGdPg+1TZ2utZWVMebrZPYGC6CNITrGKf/kqmicCzWVJFNRid0ziWZGfFEcLsngHcjJ5iK3LbYBA/ZaHieu0nwr1l6wO0z+x4FwGExD3NhpxzVD7PxiOStk+07pTkocN9UUt2lVqcgjR4S1wycASg5X7RpDY5IonL9DqQbYImWQrz2c34wjswkSjV5JL8/hK7PTh7JJJ0GKSwWS5mZ7cRQev//hxOWmaY2m3x/3/nOsC01Gi/girVdrKfFHT2mzkyE1nXyCnMw==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BYAPR11MB2887.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(346002)(376002)(136003)(396003)(366004)(39860400002)(2906002)(296002)(71200400001)(66476007)(86362001)(5660300002)(6512007)(36756003)(66556008)(186003)(15650500001)(6486002)(26005)(8676002)(66946007)(76116006)(6506007)(64756008)(316002)(83380400001)(110136005)(33656002)(8936002)(66446008)(966005)(478600001)(2616005); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: ZwTELbc4eYJIf0X5BksjdGhPwvVf3/gSkuzk5ppVUnFYv5DnRoqmhwWQX96gg1D8qk9benCN41GcqZPzymFbYci2+RVxQa7I5QWwM+ujU4AChtuoW7hxHqNvkqW7NzvakRGB8fXoVHjXjNyDKP2h6ydKrgvfqoBRIMAdrb9VuxLePaFt22zAI5RXvhyTmA+z39n0CR5ZDxX+zPkMvyhH17Pnbew/Z50YgvXZiYlelqgIPmaXCYoeeGKQHTcqKqiqu8Qk6Kxgm1nyN6QOH3svPDgFukaE2EZEQK84LxEv0IhMP4509Dz8It8RFPRpCRpPiO5yTus6NZ9IXGLV+Vb74Ds5hSgeMSV66FDm/OpBa8nVLE6Qs5zyMr4iP0M07i/CCUECflvtamaX0M86DjA8z730pfGTwqlr01pUm359kXIEp2s2d/Mf7iHMb/kKoutx5wI4kieqQxSfmkKXDZ9udh8iKKQzlr7w67V6HKny1ZTvpWtiEbCwBUTte+6wr572QttzsTpmS6ublTD85HQUdh9CfXt9fiQcQhmzCjs+ZfMAPpM79TAUvdTMET70B+5v1+yKx4Z8fCSI2fuO3VIp6XIXxfHxQAHySKecpQQRlWotub3ocvJxmhxXi6kyy3TUHGmed8Nz1A1OtE8I6HWRQg==
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-ID: <CF699F4638AFA949B833FD112CCDADCF@namprd11.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: BYAPR11MB2887.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 0735dbae-b02b-4563-106b-08d860be5f45
X-MS-Exchange-CrossTenant-originalarrivaltime: 24 Sep 2020 19:16:42.9290 (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: MtHKzKE8j6paVN+XYWnHzHLg5FhIr3C5OG1QYMgoYoCjI9I9M85KA7+6bXdZ3HJ4
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR11MB4054
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.36.7.15, xch-aln-005.cisco.com
X-Outbound-Node: alln-core-12.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/Oeyy4fVPwj64EQ0Rc4qkV8x7ngc>
Subject: Re: [yang-doctors] Modeling of protocol message structures
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Email list of the yang-doctors directorate <yang-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/yang-doctors/>
List-Post: <mailto:yang-doctors@ietf.org>
List-Help: <mailto:yang-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 24 Sep 2020 19:16:47 -0000

Hi Ebben, Esteemed Doctors,
It would be good to understand the reasons for using YANG as a message schema language and how it relates to the tooling and bits on the wire. Note that I didn't read the document other than looking at the YANG model so perhaps these questions are addressed.
Thanks,
Acee

On 9/24/20, 2:55 PM, "yang-doctors on behalf of Ebben Aries" <yang-doctors-bounces@ietf.org on behalf of ebben.aries@nokia.com> wrote:

    I wanted to solicit feedback/opinions from a recent review (that at
    least 1 other of you have had the chance to review) - The draft in
    question is draft-ietf-dots-rfc8782-bis-00

    Now, this is the first I've seen to make its way through YD review (and
    maybe there are others) but the above is an example of modeling the
    message structure payload for the DOTS signaling channel over CoAP.
    There is no relationship to NETCONF/RESTCONF and/or datastores but
    rather just definitions of pure message structures as best as can be
    described in the YANG language (with implementation details left to the
    specficiation).

    For the most part, I think this is fine and a possible use being code
    generation but still need to factor in statements that will not
    translate directly to underlying language semantics and/or rules and
    restrictions that sit outside of the data-model (and only in the
    specification or description stmt) - Is the use being force fit for this
    type of case?

    My questions/comments to everyone:

    - Are we starting to see this as the norm for newer protocol
      specifications in general and is there any rule around such or is it
      up to each author if they want to model any message structures or not
      in the YANG language and publish a module?

    - Is the above necessary?  Does this provide much if any advantage to
      doing so in comparison to the maintenance, publication and potential
      for confusion?

    - We now have the potential for publication of a large amount of YANG
      models that may or may not apply to the regular use to date.  You
      cannot tell the difference or purpose of these modules by purely
      looking at any identifier in the module name or header today.

    - To the above point, modules will be published that could very well
      conflict with proper names of future modules that are centered around
      datastore interaction for that same domain.

    - (Specific to the review and not structures themselves) - Some modules
      related to above have been published and am assuming these did not go
      through YD review.  We now have very generic prefixes published such
      as 'data-channel'.  While of local significance, we should be more
      descriptive and unique across IETF or IANA published modules.

    Thx

    /ebben

    _______________________________________________
    yang-doctors mailing list
    yang-doctors@ietf.org
    https://www.ietf.org/mailman/listinfo/yang-doctors