Re: [Anima] Éric Vyncke's No Objection on draft-ietf-anima-grasp-api-08: (with COMMENT)

"Eric Vyncke (evyncke)" <evyncke@cisco.com> Tue, 01 December 2020 19:32 UTC

Return-Path: <evyncke@cisco.com>
X-Original-To: anima@ietfa.amsl.com
Delivered-To: anima@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A90333A1479; Tue, 1 Dec 2020 11:32:55 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -9.601
X-Spam-Level:
X-Spam-Status: No, score=-9.601 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_H2=-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=Bb6gDNQ+; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=GXVN5LxN
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 cMo0hvM5nUL5; Tue, 1 Dec 2020 11:32:51 -0800 (PST)
Received: from alln-iport-2.cisco.com (alln-iport-2.cisco.com [173.37.142.89]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id D0BA33A1475; Tue, 1 Dec 2020 11:32:50 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=3290; q=dns/txt; s=iport; t=1606851171; x=1608060771; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=si8cDHohyItbgStRVwCHdlC0tnNrjd3a5OaJTYaH/8Q=; b=Bb6gDNQ+0Nmqpf5FrOR9+6MsN+ztbI0pk5RCXmG3S19CDGiJb6ymp2Xy 8uhG6eBJngnch6A5qRUvr9GbImEuQjVuxyqAM/EynNuPJDOc+MslJJqzD k1/0Fyf/kLKkx+NSO6LfD/TQA/1b6KskOfHi4eUk6H/qFTmwlRZZcf2c/ I=;
X-IPAS-Result: =?us-ascii?q?A0DyBwDImcZffY0NJK1iHQEBAQEJARIBBQUBQIFPgVJRg?= =?us-ascii?q?VYvLoQ8g0kDjTUnihaEcol/glMDVAsBAQENAQEtAgQBAYRKAheBfAIlOBMCA?= =?us-ascii?q?wEBAQMCAwEBAQEFAQEBAgEGBBQBAYY8DIVyAQEBAwESEREMAQE3AQsEAgEIE?= =?us-ascii?q?QMBAgMCJgICAh8RFQUDCAIEAQ0FIoMEglYDDiABoWgCgTyIaXaBMoMEAQEFh?= =?us-ascii?q?RsNC4IQCYEOKoJzg3aCKRuEExuBQT+BEScMEIJVPoIbgiODFzOCLJN/o2k4V?= =?us-ascii?q?wqCcJYahRcDH4MhiiCUYYRgjwyNfI5hAQyEIQIEAgQFAg4BAQWBbSGBWXAVO?= =?us-ascii?q?yoBgj5QFwINjiGDcYpYdAI1AgYBCQEBAwkBe48EAQE?=
IronPort-PHdr: =?us-ascii?q?9a23=3A/WeRhxR9OzORuh2EU75JTEKyB9psv++ubAcI9p?= =?us-ascii?q?oqja5Pea2//pPkeVbS/uhpkESQBNmJ5PdNiu6QuKflCiQM4peE5XYFdpEEFx?= =?us-ascii?q?oIkt4fkAFoBsmZQVb6I/jnY21ffoxCWVZp8mv9PR1TH8DzNFLXq3y2qzUVH0?= =?us-ascii?q?a3OQ98PO+gHInUgoy+3Pyz/JuGZQJOiXK9bLp+IQ/wox/Ws5wdgJBpLeA6zR?= =?us-ascii?q?6arw=3D=3D?=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-AV: E=Sophos;i="5.78,385,1599523200"; d="scan'208";a="627850079"
Received: from alln-core-8.cisco.com ([173.36.13.141]) by alln-iport-2.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 01 Dec 2020 19:32:39 +0000
Received: from XCH-ALN-003.cisco.com (xch-aln-003.cisco.com [173.36.7.13]) by alln-core-8.cisco.com (8.15.2/8.15.2) with ESMTPS id 0B1JWddS021425 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Tue, 1 Dec 2020 19:32:39 GMT
Received: from xhs-aln-003.cisco.com (173.37.135.120) by XCH-ALN-003.cisco.com (173.36.7.13) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 1 Dec 2020 13:32:39 -0600
Received: from xhs-rtp-002.cisco.com (64.101.210.229) by xhs-aln-003.cisco.com (173.37.135.120) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Tue, 1 Dec 2020 13:32:38 -0600
Received: from NAM10-MW2-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, 1 Dec 2020 14:32:38 -0500
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=BC9PQWH6jZMqiRTiLEFeDELxBaAYUcmpdiqZIGzktX1lOGF+TbJ3dLMEYMV8NuQC70ypNuUk+6RlLEYO9KRG4naI9ji9+KAfB2aa3NgELsgf0kvR/mhzEJEAdh3xUqWSdEgp9uZRRM5e0Q0D0pQz0pSHneL0jHvP7vK4IukTT2vLpGMwiCt/W6d9GRl5nlxAZIfxudgHjraRtIdBhVrp+Ib5p5Rkka67B1CJXqRVXNk2zA06wBkIfwt2Id4i4YS1n/iV/GNWKWDg31x2Jz3FMlk9MrrYVPnGYUT0qdjhHSoUbUkipTaLYXoLso6C0Z+uENZKCCxbUWWBzocshZTRKQ==
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=si8cDHohyItbgStRVwCHdlC0tnNrjd3a5OaJTYaH/8Q=; b=oM1zW8rIN9E4W/bL+8KDAf9XUEViVU+XyqfX62MYxnZrdwG0WJS1pP680szS1rZXylzBq0ygu2a1I3YqwzHkxk4DgKBN/E7fSWfGL0UOgUd9YaqBE90VKPhTEkAuMCCOWh2a9tupLO334TyAYqcMJaXfnRFKRF40f8vYyFeYJjiCLJ1S5WlvQy+uzSaXEzf/n1GNQnV4aHUqMQ/dUU8AqpZD5oWGztMMsVt6LAn7zw6Qp8pL5NiC/C3mduR/Dv7FJm4iU4Ux7IkhQljdjniMdmQjn/J8vyufRss75MgCF6XPJzZ5B3EB2IMGkf0rBzQGosbH7dDZn26w6qtGb9eGSQ==
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=si8cDHohyItbgStRVwCHdlC0tnNrjd3a5OaJTYaH/8Q=; b=GXVN5LxNUkGogT3uxVbVplJNZ0laKA0jXSKVxXDza3mxDU2VcZhbXagX+4GNoZhqwDGmriEln4Sf1bAZ4ccGRnvwZVIwEIggqQ3Yo74y50wwaVFmZF5cZvgTX8hTkpeYLL41bMsIT2gEL7nOTuvM5O9loIgyRdj2V7liD82XKT0=
Received: from PH0PR11MB4966.namprd11.prod.outlook.com (2603:10b6:510:42::21) by PH0PR11MB5158.namprd11.prod.outlook.com (2603:10b6:510:3b::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3632.17; Tue, 1 Dec 2020 19:32:36 +0000
Received: from PH0PR11MB4966.namprd11.prod.outlook.com ([fe80::453b:b2f5:ec29:410d]) by PH0PR11MB4966.namprd11.prod.outlook.com ([fe80::453b:b2f5:ec29:410d%7]) with mapi id 15.20.3611.025; Tue, 1 Dec 2020 19:32:36 +0000
From: "Eric Vyncke (evyncke)" <evyncke@cisco.com>
To: Brian E Carpenter <brian.e.carpenter@gmail.com>, The IESG <iesg@ietf.org>
CC: "draft-ietf-anima-grasp-api@ietf.org" <draft-ietf-anima-grasp-api@ietf.org>, "anima-chairs@ietf.org" <anima-chairs@ietf.org>, "anima@ietf.org" <anima@ietf.org>, Sheng Jiang <jiangsheng@huawei.com>
Thread-Topic: =?utf-8?B?w4lyaWMgVnluY2tlJ3MgTm8gT2JqZWN0aW9uIG9uIGRyYWZ0LWlldGYtYW5p?= =?utf-8?Q?ma-grasp-api-08:_(with_COMMENT)?=
Thread-Index: AQHWyBgqAgowc0MeAUm3ttoUGFt+zKnisgQA
Date: Tue, 1 Dec 2020 19:32:36 +0000
Message-ID: <360F1EFC-C189-4827-AA79-AD2A84CEACEE@cisco.com>
References: <160683220837.26332.5741732795874744093@ietfa.amsl.com> <b051a6da-6550-b25d-94e2-c5c7f19e9bdc@gmail.com>
In-Reply-To: <b051a6da-6550-b25d-94e2-c5c7f19e9bdc@gmail.com>
Accept-Language: fr-BE, en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/16.43.20110804
authentication-results: gmail.com; dkim=none (message not signed) header.d=none;gmail.com; dmarc=none action=none header.from=cisco.com;
x-originating-ip: [2001:420:c0c1:36:c5a2:8fb:e443:c1ef]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: bc481aec-e278-406e-475b-08d8962fdbe2
x-ms-traffictypediagnostic: PH0PR11MB5158:
x-microsoft-antispam-prvs: <PH0PR11MB5158EEEBC53AC18BBFA75D59A9F40@PH0PR11MB5158.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: Dz+BMzNlipH2B5LH+XKJklCwNzW/SJd9ELnP4nb9z/FidUxbZqzzJ9HmISepOL++Kh9Dp0Bu8xQXuIgcFYpodoI/lwMgl2BfxQId7goEbfda6h1U1QJX4vygNWAOkaKntUUv0DbP28u+Tzl5hx6pCsm6grnF8NxjrDKgCdCrHgFa5PwdijpfX3SkyMlmRO+HqfpSpGiYh6tKh8c35AfBIl5Ya0Cwk9yVXZ9h25rjAORWmGzpZY0MR6ryrBM1jpVtOJWfzmrGIMLTMwPw+iSI+JoWuaVEGiqlGnOwm/hh+K27Zlph7uAJcEmW5ZxwGweg
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:PH0PR11MB4966.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(346002)(396003)(376002)(39850400004)(136003)(8936002)(4326008)(86362001)(36756003)(66476007)(478600001)(91956017)(76116006)(66946007)(71200400001)(83380400001)(66446008)(64756008)(66556008)(6486002)(33656002)(224303003)(5660300002)(54906003)(186003)(2616005)(6512007)(316002)(2906002)(53546011)(110136005)(6506007); DIR:OUT; SFP:1101;
x-ms-exchange-antispam-messagedata: nci0FuXnJX2D4no18akewTZke1WvChjA30apsr3gNuQgDVLlRkabSKVqB3bPLFVOfYKTUzQHlHZSTQukWkTqSTZ8lN7aKmtJ5rUKu0/OIcpkCk9pS+zKG0nmpnGDoRhcl3PqWk5wHSuiwUqPjYCgZsySedMgSQIGqLIF/X7VaapebFuIP2YkBjQSI+Oq/GRGZL825RbitdluvYcycrK+7VupK8SeVKtwzacibPTPQaTorqkjM7CAEdvzRHQxa8B/XMGn/MQFxQDUQc6rZC3itE9d3Ou2t2HUm/89Mp/xpRQsx8H4aE6yPID4loWRfYxpUpiLqHlo9kVYBti0CbgcSyk8cRxHd6zVUmYI1UC0DE98rJ/F9nVkSd7y5MQmpfzYj+sNPwKDAjke3py+8/eXy1LRUGY9W4li6yoGUrgm9Jsi/vI+9coS/re9tI/xXyZNykkk6cPUCbQy3r7Qv8R7Z0CR2EIl+tBo8Pv+iTNQf2QaeclIRxhzFA5h3r3XT+oM5IO1E/uE6ueexBpK+SEK0OlWR+g4TAEXupnN6k9nqTJh9OAxMagHVqwobiCcZljVf+rmX/WCIW598XiDYcxpWMTAS4C4wgiB5GGxi10ZO6Jn7DAL/cSYKm8db9l25vrTyl2ip/a76icwRfpLJDyptCMvLxn+WjRp+ZX/qON33cDo6TjHiQMxFIHgja5czHGGs/mllAK+2Y4UwHG8ThpNOKk1WTacLV0CjxukhSRirkf3aV0sCBXcEtqhtQ+nZTFL/nOy0Fzru6hkW/m5qFxyJiz6Ai0ZXxeeAjTzB0zDWdmLEhohSCEUxgJlfTf3BfKf
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-ID: <B964074419D4404FB6B6AA35CA333FFB@namprd11.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: PH0PR11MB4966.namprd11.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: bc481aec-e278-406e-475b-08d8962fdbe2
X-MS-Exchange-CrossTenant-originalarrivaltime: 01 Dec 2020 19:32:36.8867 (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: ry4AdJeyK5j+0O8d6Tr0tCbkJsIQQSBvxKOohnI6HSKMhE22ri9JC/jHXsmxlSFFT1UrjWWeRJfaMqrvsH0kmA==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5158
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.36.7.13, xch-aln-003.cisco.com
X-Outbound-Node: alln-core-8.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/anima/PZNRodmEhD2WyqNlx7pdOHTgFSk>
Subject: Re: [Anima] =?utf-8?q?=C3=89ric_Vyncke=27s_No_Objection_on_draft-iet?= =?utf-8?q?f-anima-grasp-api-08=3A_=28with_COMMENT=29?=
X-BeenThere: anima@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Autonomic Networking Integrated Model and Approach <anima.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/anima>, <mailto:anima-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/anima/>
List-Post: <mailto:anima@ietf.org>
List-Help: <mailto:anima-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/anima>, <mailto:anima-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 01 Dec 2020 19:32:56 -0000

Brian,

I agree on your two points ;-)

-----Original Message-----
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Date: Tuesday, 1 December 2020 at 20:28
To: Eric Vyncke <evyncke@cisco.com>om>, The IESG <iesg@ietf.org>
Cc: "draft-ietf-anima-grasp-api@ietf.org" <draft-ietf-anima-grasp-api@ietf.org>rg>, "anima-chairs@ietf.org" <anima-chairs@ietf.org>rg>, "anima@ietf.org" <anima@ietf.org>rg>, Sheng Jiang <jiangsheng@huawei.com>
Subject: Re: Éric Vyncke's No Objection on draft-ietf-anima-grasp-api-08: (with COMMENT)

    On 02-Dec-20 03:16, Éric Vyncke via Datatracker wrote:
    ...

    > Please find below one some non-blocking COMMENT points, and one nits. I have
    > also request IoT directorate and INT directorate reviews, so, you may expect
    > more reviews.

    Some of the reviews requested at Last Call never showed up, which is mildly annoying if they're going to show up late.

    All your comments are easy to fix, assuming "new ID needed".

    Thanks
        Brian

    > 
    > I hope that this helps to improve the document,
    > 
    > Regards,
    > 
    > -éric
    > 
    > == COMMENTS ==
    > 
    > -- Section 1 --
    > In figure 1, is the "GRASP API Library" identical to the "basic GRASP library"
    > mentioned later in the text?
    > 
    > -- Section 2.1 --
    > May I assume that the bulleted list is not exhaustive? Probably worth stating
    > "For example, ..." if this is the case.
    > 
    > -- Section 2.2.1 --
    > This whole section looks more like a tutorial than something useful in an IETF
    > document ;-) but no problem to leave it. Same applies for section 2.2.2 and
    > even to 2.2.3.
    > 
    > -- Section 2.3.2.2 --
    > Should it be specified that the timeout is an *unsigned* integer? Same applies
    > for "loop_count" in section 2.3.2.3
    > 
    > -- Section 2.3 --
    > Several occurrences of "returned parameters"... should it better be "returned
    > values" ?
    > 
    > -- Section 2.3.3 --
    > "All ASAs must use this call." should it be followed by "before issuing any
    > other API calls" ?
    > 
    > "automatically if an ASA crashes" but what about "graceful termination" ?
    > 
    > == NITS ==
    > 
    > -- Section 1 --
    > Suggestion move figure 1 earlier in the text to improve readability.
    > 
    > 
    > 
    >