Re: [Suit] draft-moran-suit-manifest-04 - prescriptive

Martin Pagel <> Fri, 15 March 2019 23:20 UTC

Return-Path: <>
Received: from localhost (localhost []) by (Postfix) with ESMTP id 02902124BAA for <>; Fri, 15 Mar 2019 16:20:42 -0700 (PDT)
X-Virus-Scanned: amavisd-new at
X-Spam-Flag: NO
X-Spam-Score: -2.001
X-Spam-Status: No, score=-2.001 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: (amavisd-new); dkim=pass (1024-bit key)
Received: from ([]) by localhost ( []) (amavisd-new, port 10024) with ESMTP id XORMB1bJMu_n for <>; Fri, 15 Mar 2019 16:20:39 -0700 (PDT)
Received: from ( []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by (Postfix) with ESMTPS id B515212008A for <>; Fri, 15 Mar 2019 16:20:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=/s747BwjOEkl4KTiIEulENIDHPakCcypgGZOU7poGzA=; b=mfN4HY/9DFLw62CSFOhV+haPk9jN3qaBezltLntgF37z19wggxiJUvrVSBvLLUS/iLFYWpAqix1YFZgP/RGEX7/obKUdDMVcneSrYikamXzo0P+TzW3cLdFAFg54uaMczyGRTV4zl0gdZIdAPqZPc7b0iZiR+4Zb0GOfXVO5wug=
Received: from ( by ( with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1730.0; Fri, 15 Mar 2019 23:20:35 +0000
Received: from ([fe80::a89a:5b8a:e27c:ec15]) by ([fe80::a89a:5b8a:e27c:ec15%7]) with mapi id 15.20.1730.000; Fri, 15 Mar 2019 23:20:35 +0000
From: Martin Pagel <>
To: Brendan Moran <>, "" <>
Thread-Topic: draft-moran-suit-manifest-04 - prescriptive
Thread-Index: AdTbfYV7dO45RdMkQRKtZzBYR1IzsA==
Date: Fri, 15 Mar 2019 23:20:35 +0000
Message-ID: <>
Accept-Language: en-US
Content-Language: en-US
msip_labels: MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Enabled=True; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_SiteId=72f988bf-86f1-41af-91ab-2d7cd011db47;; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_SetDate=2019-03-15T23:20:34.4811192Z; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Name=General; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Application=Microsoft Azure Information Protection; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_ActionId=37b80e76-2f10-4141-8f25-614ef6a983d7; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Extended_MSFT_Method=Automatic
x-originating-ip: []
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: b090f820-baa5-4688-64b3-08d6a99cd3ff
x-ms-office365-filtering-ht: Tenant
x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600127)(711020)(4605104)(4618075)(2017052603328)(7193020); SRVR:BYAPR21MB1350;
x-ms-traffictypediagnostic: BYAPR21MB1350:
x-ms-exchange-purlcount: 2
x-microsoft-antispam-prvs: <>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 09778E995A
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(376002)(396003)(346002)(136003)(366004)(39860400002)(199004)(13464003)(40434004)(189003)(51444003)(186003)(53936002)(2906002)(478600001)(25786009)(26005)(110136005)(53546011)(6506007)(6116002)(6246003)(3846002)(66066001)(256004)(966005)(102836004)(81166006)(22452003)(81156014)(316002)(6346003)(106356001)(97736004)(8676002)(99286004)(14444005)(5024004)(105586002)(10290500003)(6436002)(9686003)(6306002)(14454004)(2501003)(229853002)(55016002)(7696005)(7736002)(72206003)(305945005)(86362001)(74316002)(8936002)(86612001)(5660300002)(476003)(71190400001)(52536014)(68736007)(10090500001)(8990500004)(71200400001)(486006)(33656002); DIR:OUT; SFP:1102; SCL:1; SRVR:BYAPR21MB1350;; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None ( does not designate permitted sender hosts)
authentication-results: spf=none (sender IP is );
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam-message-info: 6MKevhZTaTspYZEYC4AEjq/68B866QFyMpBxA3dApyIChVIacSvOrunLND02dcW/5vMlhexQCpRszo6WL8tTlaAOK4RYpBWTaXmEmmEMagTSjSRqONyQuhTLwnzQcEe8NsYfz2oCgOphAFcWFmwalqGimEBToy0P+c1KSKjwBwIiwOa7YYMzmlkTnsbP3pwn/00i3Nq899mhhhn5RgFDrEuf6YSDMml2Dq+GMNOyLpPM/0kjnDMw4AMn0q+jfQFHRWyTmgTULCeFm8I08WQ0QX7/nWnr6r4UPjq+QSipZnkadnDTcVbcYMOJaDXs6ABB5UORjmCNEPufuTo/Iym4UhpkGIFrlYfwflDrlahCeivg77diIZ5hckhltnkCjbUU7YtpQ+LNTX1C+5wQjRCGo2ukpG1CZzsGinXKh9r/tvQ=
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: b090f820-baa5-4688-64b3-08d6a99cd3ff
X-MS-Exchange-CrossTenant-originalarrivaltime: 15 Mar 2019 23:20:35.4623 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 72f988bf-86f1-41af-91ab-2d7cd011db47
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR21MB1350
Archived-At: <>
Subject: Re: [Suit] draft-moran-suit-manifest-04 - prescriptive
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Software Updates for Internet of Things <>
List-Unsubscribe: <>, <>
List-Archive: <>
List-Post: <>
List-Help: <>
List-Subscribe: <>, <>
X-List-Received-Date: Fri, 15 Mar 2019 23:20:42 -0000

Hi Brendan, 
This an impressive re-draft, it's almost a new/separate manifest approach all together. I like the switch from a descriptive approach to a prescriptive one and the fact that the manifest is quite small for the basic cases. 

Is your goal to develop a generic installer which could interpret the "script" (apply-image and run-image sections) and apply any number of images on a fairly complicated MCU configuration? (It reminds me a bit of the setup.inf scripting capabilities I added in Windows 2.0) I think that would be quite intriguing for more sophisticated MCUs, but I would expect very constrained MCUs (like the one targeted by MCUBoot) to use a special purpose installer. But because the "script" portions of the manifest are optional, none would need to be present for those cases, correct?

Here are a few specific comments and questions:

* Component Id
I understand the first parameter is a bstr for name, but what's the second (numeric) parameter? Is that some type of offset? Did I miss the explanation for this parameter?

* URIs
If you need to install 10 images, the URIs take up a lot of space and there is a good chance they all have the same base URL. How about allowing to specify the base URL and append the component name to that URL?

* Dependency, Unpacking...
The examples are very useful, but only cover a few manifest options. Can you provide some more examples to cover dependency blocks, unpacking, run_sequence etc?


-----Original Message-----
From: Suit <> On Behalf Of Brendan Moran
Sent: Tuesday, March 12, 2019 3:35 AM
Subject: [Suit] Introducing draft-moran-suit-manifest-04

draft-moran-suit-manifest-04 has now been published.;;sdata=qjrMKS33E91CBhWvq3vqxeyMeEnHC52UoIv1eU6vypM%3D&amp;reserved=0

This draft is the result of combining the information model in draft-moran-suit-behavioural-manifests-00 (the 01 version fixes example formatting only) with that in draft-ietf-suit-information-model, then serialising the result in CBOR. This is a significant departure from previous drafts. It attempts to preserve flexibility, fully define the behaviour of recipient, simplify the manifest structure, reduce code-size of the recipient, and reduce the size of the manifest. This ambitious set of goals required a significant change in approach as compared to draft-moran-suit-manifest-03 and before. In order to outline the approach clearly, we have separately published draft-moran-suit-behavioural-manifests-00. draft-moran-suit-manifest-04 focuses more on the serialisation of the manifest.

I look forward to discussing this draft in more detail.

Best Regards,
IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you.

Suit mailing list;;sdata=XZUgZppgBVKl%2FXViCMnEyGQ030B6u5kZQY1OYCtCYXg%3D&amp;reserved=0