From mboxrd@z Thu Jan  1 00:00:00 1970
From: George Dunlap <george.dunlap@citrix.com>
Subject: [PATCH 01/16] Introduce skeleton SUPPORT.md
Date: Mon, 13 Nov 2017 15:41:11 +0000
Message-ID: <20171113154126.13038-1-george.dunlap@citrix.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <xen-devel-bounces@lists.xen.org>
Received: from mail6.bemta5.messagelabs.com ([195.245.231.135])
 by lists.xenproject.org with esmtp (Exim 4.84_2)
 (envelope-from <prvs=483948db6=George.Dunlap@citrix.com>)
 id 1eEGri-0007sm-Tp
 for xen-devel@lists.xenproject.org; Mon, 13 Nov 2017 15:41:39 +0000
List-Unsubscribe: <https://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
 <mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <https://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
 <mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Errors-To: xen-devel-bounces@lists.xen.org
Sender: "Xen-devel" <xen-devel-bounces@lists.xen.org>
To: xen-devel@lists.xenproject.org
Cc: Stefano Stabellini <sstabellini@kernel.org>, Wei Liu <wei.liu2@citrix.com>, Konrad Wilk <konrad.wilk@oracle.com>, Andrew Cooper <andrew.cooper3@citrix.com>, Dario Faggioli <dario.faggioli@citrix.com>, Tim Deegan <tim@xen.org>, George Dunlap <george.dunlap@citrix.com>, Julien Grall <julien.grall@arm.com>, Paul Durrant <paul.durrant@citrix.com>, Jan Beulich <jbeulich@suse.com>, Tamas K Lengyel <tamas.lengyel@zentific.com>, Anthony Perard <anthony.perard@citrix.com>, Ian Jackson <ian.jackson@citrix.com>, Roger Pau Monne <roger.pau@citrix.com>
List-Id: xen-devel@lists.xenproject.org

QWRkIGEgbWFjaGluZS1yZWFkYWJsZSBmaWxlIHRvIGRlc2NyaWJlIHdoYXQgZmVhdHVyZXMgYXJl
IGluIHdoYXQKc3RhdGUgb2YgYmVpbmcgJ3N1cHBvcnRlZCcsIGFzIHdlbGwgYXMgaW5mb3JtYXRp
b24gYWJvdXQgaG93IGxvbmcgdGhpcwpyZWxlYXNlIHdpbGwgYmUgc3VwcG9ydGVkLCBhbmQgc28g
b24uCgpUaGUgZG9jdW1lbnQgc2hvdWxkIGJlIGZvcm1hdHRlZCB1c2luZyAic2VtYW50aWMgbmV3
bGluZXMiIFsxXSwgdG8gbWFrZQpjaGFuZ2VzIGVhc2llci4KCkJlZ2luIHdpdGggdGhlIGJhc2lj
IGZyYW1ld29yay4KClNpZ25lZC1vZmYtYnk6IElhbiBKYWNrc29uIDxpYW4uamFja3NvbkBjaXRy
aXguY29tPgpTaWduZWQtb2ZmLWJ5OiBHZW9yZ2UgRHVubGFwIDxnZW9yZ2UuZHVubGFwQGNpdHJp
eC5jb20+CgpbMV0gaHR0cDovL3Job2Rlc21pbGwub3JnL2JyYW5kb24vMjAxMi9vbmUtc2VudGVu
Y2UtcGVyLWxpbmUvCi0tLQpDQzogSWFuIEphY2tzb24gPGlhbi5qYWNrc29uQGNpdHJpeC5jb20+
CkNDOiBXZWkgTGl1IDx3ZWkubGl1MkBjaXRyaXguY29tPgpDQzogQW5kcmV3IENvb3BlciA8YW5k
cmV3LmNvb3BlcjNAY2l0cml4LmNvbT4KQ0M6IEphbiBCZXVsaWNoIDxqYmV1bGljaEBzdXNlLmNv
bT4KQ0M6IFRpbSBEZWVnYW4gPHRpbUB4ZW4ub3JnPgpDQzogRGFyaW8gRmFnZ2lvbGkgPGRhcmlv
LmZhZ2dpb2xpQGNpdHJpeC5jb20+CkNDOiBUYW1hcyBLIExlbmd5ZWwgPHRhbWFzLmxlbmd5ZWxA
emVudGlmaWMuY29tPgpDQzogUm9nZXIgUGF1IE1vbm5lIDxyb2dlci5wYXVAY2l0cml4LmNvbT4K
Q0M6IFN0ZWZhbm8gU3RhYmVsbGluaSA8c3N0YWJlbGxpbmlAa2VybmVsLm9yZz4KQ0M6IEFudGhv
bnkgUGVyYXJkIDxhbnRob255LnBlcmFyZEBjaXRyaXguY29tPgpDQzogUGF1bCBEdXJyYW50IDxw
YXVsLmR1cnJhbnRAY2l0cml4LmNvbT4KQ0M6IEtvbnJhZCBXaWxrIDxrb25yYWQud2lsa0BvcmFj
bGUuY29tPgpDQzogSnVsaWVuIEdyYWxsIDxqdWxpZW4uZ3JhbGxAYXJtLmNvbT4KLS0tCiBTVVBQ
T1JULm1kIHwgMTk2ICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr
KysrKysrKysrKysrKysrKysKIDEgZmlsZSBjaGFuZ2VkLCAxOTYgaW5zZXJ0aW9ucygrKQogY3Jl
YXRlIG1vZGUgMTAwNjQ0IFNVUFBPUlQubWQKCmRpZmYgLS1naXQgYS9TVVBQT1JULm1kIGIvU1VQ
UE9SVC5tZApuZXcgZmlsZSBtb2RlIDEwMDY0NAppbmRleCAwMDAwMDAwMDAwLi5kN2YyYWU0NWU0
Ci0tLSAvZGV2L251bGwKKysrIGIvU1VQUE9SVC5tZApAQCAtMCwwICsxLDE5NiBAQAorIyBTdXBw
b3J0IHN0YXRlbWVudCBmb3IgdGhpcyByZWxlYXNlCisKK1RoaXMgZG9jdW1lbnQgZGVzY3JpYmVz
IHRoZSBzdXBwb3J0IHN0YXR1cyAKK2FuZCBpbiBwYXJ0aWN1bGFyIHRoZSBzZWN1cml0eSBzdXBw
b3J0IHN0YXR1cyBvZiB0aGUgWGVuIGJyYW5jaAord2l0aGluIHdoaWNoIHlvdSBmaW5kIGl0Lgor
CitTZWUgdGhlIGJvdHRvbSBvZiB0aGUgZmlsZSAKK2ZvciB0aGUgZGVmaW5pdGlvbnMgb2YgdGhl
IHN1cHBvcnQgc3RhdHVzIGxldmVscyBldGMuCisKKyMgUmVsZWFzZSBTdXBwb3J0CisKKyAgICBY
ZW4tVmVyc2lvbjogNC4xMC11bnN0YWJsZQorICAgIEluaXRpYWwtUmVsZWFzZTogbi9hCisgICAg
U3VwcG9ydGVkLVVudGlsOiBUQkQKKyAgICBTZWN1cml0eS1TdXBwb3J0LVVudGlsOiBVbnJlbGVh
c2VkIC0gbm90IHlldCBzZWN1cml0eS1zdXBwb3J0ZWQKKworIyBGZWF0dXJlIFN1cHBvcnQKKwor
IyBGb3JtYXQgYW5kIGRlZmluaXRpb25zCisKK1RoaXMgZmlsZSBjb250YWlucyBwcm9zZSwgYW5k
IG1hY2hpbmUtcmVhZGFibGUgZnJhZ21lbnRzLgorVGhlIGRhdGEgaW4gYSBtYWNoaW5lLXJlYWRh
YmxlIGZyYWdtZW50IHJlbGF0ZSB0bwordGhlIHNlY3Rpb24gYW5kIHN1YnNlY3Rpb24gaW4gd2hp
Y2ggaXQgaXMgZm91bmQuCisKK1RoZSBmaWxlIGlzIGluIG1hcmtkb3duIGZvcm1hdC4KK1RoZSBt
YWNoaW5lLXJlYWRhYmxlIGZyYWdtZW50cyBhcmUgbWFya2Rvd24gbGl0ZXJhbHMKK2NvbnRhaW5p
bmcgUkZDLTgyMi1saWtlIChkZWI4MjItbGlrZSkgZGF0YS4KKworIyMgS2V5cyBmb3VuZCBpbiB0
aGUgRmVhdHVyZSBTdXBwb3J0IHN1YnNlY3Rpb25zCisKKyMjIyBTdGF0dXMKKworVGhpcyBnaXZl
cyB0aGUgb3ZlcmFsbCBzdGF0dXMgb2YgdGhlIGZlYXR1cmUsCitpbmNsdWRpbmcgc2VjdXJpdHkg
c3VwcG9ydCBzdGF0dXMsIGZ1bmN0aW9uYWwgY29tcGxldGVuZXNzLCBldGMuCitSZWZlciB0byB0
aGUgZGV0YWlsZWQgZGVmaW5pdGlvbnMgYmVsb3cuCisKK0lmIHN1cHBvcnQgZGlmZmVycyBiYXNl
ZCBvbiBpbXBsZW1lbnRhdGlvbgorKGZvciBpbnN0YW5jZSwgeDg2IC8gQVJNLCBMaW51eCAvIFFF
TVUgLyBGcmVlQlNEKSwKK29uZSBsaW5lIGZvciBlYWNoIHNldCBvZiBpbXBsZW1lbnRhdGlvbnMg
d2lsbCBiZSBsaXN0ZWQuCisKKyMjIERlZmluaXRpb24gb2YgU3RhdHVzIGxhYmVscworCitFYWNo
IFN0YXR1cyB2YWx1ZSBjb3JyZXNwb25kcyB0byBsZXZlbHMgb2Ygc2VjdXJpdHkgc3VwcG9ydCwK
K3Rlc3RpbmcsIHN0YWJpbGl0eSwgZXRjLiwgYXMgZm9sbG93czoKKworIyMjIEV4cGVyaW1lbnRh
bAorCisgICAgRnVuY3Rpb25hbCBjb21wbGV0ZW5lc3M6IE5vCisgICAgRnVuY3Rpb25hbCBzdGFi
aWxpdHk6IEhlcmUgYmUgZHJhZ29ucworICAgIEludGVyZmFjZSBzdGFiaWxpdHk6IE5vdCBzdGFi
bGUKKyAgICBTZWN1cml0eSBzdXBwb3J0ZWQ6IE5vCisKKyMjIyBUZWNoIFByZXZpZXcKKworICAg
IEZ1bmN0aW9uYWwgY29tcGxldGVuZXNzOiBZZXMKKyAgICBGdW5jdGlvbmFsIHN0YWJpbGl0eTog
UXVpcmt5CisgICAgSW50ZXJmYWNlIHN0YWJpbGl0eTogUHJvdmlzaW9uYWxseSBzdGFibGUKKyAg
ICBTZWN1cml0eSBzdXBwb3J0ZWQ6IE5vCisKKyMjIyMgU3VwcG9ydGVkCisKKyAgICBGdW5jdGlv
bmFsIGNvbXBsZXRlbmVzczogWWVzCisgICAgRnVuY3Rpb25hbCBzdGFiaWxpdHk6IE5vcm1hbAor
ICAgIEludGVyZmFjZSBzdGFiaWxpdHk6IFllcworICAgIFNlY3VyaXR5IHN1cHBvcnRlZDogWWVz
CisKKyMjIyMgRGVwcmVjYXRlZAorCisgICAgRnVuY3Rpb25hbCBjb21wbGV0ZW5lc3M6IFllcwor
ICAgIEZ1bmN0aW9uYWwgc3RhYmlsaXR5OiBRdWlya3kKKyAgICBJbnRlcmZhY2Ugc3RhYmlsaXR5
OiBObyAoYXMgaW4sIG1heSBkaXNhcHBlYXIgdGhlIG5leHQgcmVsZWFzZSkKKyAgICBTZWN1cml0
eSBzdXBwb3J0ZWQ6IFllcworCitBbGwgb2YgdGhlc2UgbWF5IGFwcGVhciBpbiBtb2RpZmllZCBm
b3JtLiAgCitUaGVyZSBhcmUgc2V2ZXJhbCBpbnRlcmZhY2VzLCBmb3IgaW5zdGFuY2UsCit3aGlj
aCBhcmUgb2ZmaWNpYWxseSBkZWNsYXJlZCBhcyBub3Qgc3RhYmxlOworaW4gc3VjaCBhIGNhc2Ug
dGhpcyBmZWF0dXJlIG1heSBiZSBkZXNjcmliZWQgYXMgIlN0YWJsZSAvIEludGVyZmFjZSBub3Qg
c3RhYmxlIi4KKworIyMgRGVmaW5pdGlvbiBvZiB0aGUgc3RhdHVzIGxhYmVsIGludGVycHJldGF0
aW9uIHRhZ3MKKworIyMjIEZ1bmN0aW9uYWxseSBjb21wbGV0ZQorCitEb2VzIGl0IGJlaGF2ZSBs
aWtlIGEgZnVsbHkgZnVuY3Rpb25hbCBmZWF0dXJlPworRG9lcyBpdCB3b3JrIG9uIGFsbCBleHBl
Y3RlZCBwbGF0Zm9ybXMsCitvciBkb2VzIGl0IG9ubHkgd29yayBmb3IgYSB2ZXJ5IHNwZWNpZmlj
IHN1Yi1jYXNlPworRG9lcyBpdCBoYXZlIGEgc2Vuc2libGUgVUksCitvciBkbyB5b3UgaGF2ZSB0
byBoYXZlIGEgZGVlcCB1bmRlcnN0YW5kaW5nIG9mIHRoZSBpbnRlcm5hbHMKK3RvIGdldCBpdCB0
byB3b3JrIHByb3Blcmx5PworCisjIyMgRnVuY3Rpb25hbCBzdGFiaWxpdHkKKworV2hhdCBpcyB0
aGUgcmlzayBvZiBpdCBleGhpYml0aW5nIGJ1Z3M/CisKK0dlbmVyYWwgYW5zd2VycyB0byB0aGUg
YWJvdmU6CisKKyAqICoqSGVyZSBiZSBkcmFnb25zKioKKworICAgUHJldHR5IGxpa2VseSB0byBz
dGlsbCBjcmFzaCAvIGZhaWwgdG8gd29yay4KKyAgIE5vdCByZWNvbW1lbmRlZCB1bmxlc3MgeW91
IGxpa2UgbGlmZSBvbiB0aGUgYmxlZWRpbmcgZWRnZS4KKworICogKipRdWlya3kqKgorCisgICBN
b3N0bHkgd29ya3MgYnV0IG1heSBoYXZlIG9kZCBiZWhhdmlvciBoZXJlIGFuZCB0aGVyZS4KKyAg
IFJlY29tbWVuZGVkIGZvciBwbGF5aW5nIGFyb3VuZCBvciBmb3Igbm9uLXByb2R1Y3Rpb24gdXNl
IGNhc2VzLgorCisgKiAqKk5vcm1hbCoqCisKKyAgIFJlYWR5IGZvciBwcm9kdWN0aW9uIHVzZQor
CisjIyMgSW50ZXJmYWNlIHN0YWJpbGl0eQorCitJZiBJIGJ1aWxkIGEgc3lzdGVtIGJhc2VkIG9u
IHRoZSBjdXJyZW50IGludGVyZmFjZXMsCit3aWxsIHRoZXkgc3RpbGwgd29yayB3aGVuIEkgdXBn
cmFkZSB0byB0aGUgbmV4dCB2ZXJzaW9uPworCisgKiAqKk5vdCBzdGFibGUqKgorCisgICBJbnRl
cmZhY2UgaXMgc3RpbGwgaW4gdGhlIGVhcmx5IHN0YWdlcyBhbmQKKyAgIHN0aWxsIGZhaXJseSBs
aWtlbHkgdG8gYmUgYnJva2VuIGluIGZ1dHVyZSB1cGRhdGVzLgorCisgKiAqKlByb3Zpc2lvbmFs
bHkgc3RhYmxlKioKKworICAgV2UncmUgbm90IHlldCBwcm9taXNpbmcgYmFja3dhcmRzIGNvbXBh
dGliaWxpdHksCisgICBidXQgd2UgdGhpbmsgdGhpcyBpcyBwcm9iYWJseSB0aGUgZmluYWwgZm9y
bSBvZiB0aGUgaW50ZXJmYWNlLgorICAgSXQgbWF5IHN0aWxsIHJlcXVpcmUgc29tZSB0d2Vha3Mu
CisKKyAqICoqU3RhYmxlKioKKworICAgV2Ugd2lsbCB0cnkgdmVyeSBoYXJkIHRvIGF2b2lkIGJy
ZWFraW5nIGJhY2t3YXJkcyAgY29tcGF0aWJpbGl0eSwKKyAgIGFuZCB0byBmaXggYW55IHJlZ3Jl
c3Npb25zIHRoYXQgYXJlIHJlcG9ydGVkLgorCisjIyMgU2VjdXJpdHkgc3VwcG9ydGVkCisKK1dp
bGwgWFNBcyBiZSBpc3N1ZWQgaWYgc2VjdXJpdHktcmVsYXRlZCBidWdzIGFyZSBkaXNjb3ZlcmVk
CitpbiB0aGUgZnVuY3Rpb25hbGl0eT8KKworSWYgIm5vIiwKK2FueW9uZSB3aG8gZmluZHMgYSBz
ZWN1cml0eS1yZWxhdGVkIGJ1ZyBpbiB0aGUgZmVhdHVyZQord2lsbCBiZSBhZHZpc2VkIHRvCitw
b3N0IGl0IHB1YmxpY2x5IHRvIHRoZSBYZW4gUHJvamVjdCBtYWlsaW5nIGxpc3RzCisob3IgY29u
dGFjdCBhbm90aGVyIHNlY3VyaXR5IHJlc3BvbnNlIHRlYW0sCitpZiBhIHJlbGV2YW50IG9uZSBl
eGlzdHMpLgorCitCdWdzIGZvdW5kIGFmdGVyIHRoZSBlbmQgb2YgKipTZWN1cml0eS1TdXBwb3J0
LVVudGlsKioKK2luIHRoZSBSZWxlYXNlIFN1cHBvcnQgc2VjdGlvbiB3aWxsIHJlY2VpdmUgYW4g
WFNBCitpZiB0aGV5IGFsc28gYWZmZWN0IG5ld2VyLCBzZWN1cml0eS1zdXBwb3J0ZWQsIHZlcnNp
b25zIG9mIFhlbi4KK0hvd2V2ZXIsIHRoZSBYZW4gUHJvamVjdCB3aWxsIG5vdCBwcm92aWRlIG9m
ZmljaWFsIGZpeGVzCitmb3Igbm9uLXNlY3VyaXR5LXN1cHBvcnRlZCB2ZXJzaW9ucy4KKworVGhy
ZWUgY29tbW9uICdkaXZlcnNpb25zJyBmcm9tIHRoZSAnU3VwcG9ydGVkJyBjYXRlZ29yeQorYXJl
IGdpdmVuIHRoZSBmb2xsb3dpbmcgbGFiZWxzOgorCisgICogKipTdXBwb3J0ZWQsIE5vdCBzZWN1
cml0eSBzdXBwb3J0ZWQqKgorCisgICAgRnVuY3Rpb25hbGx5IGNvbXBsZXRlLCBub3JtYWwgc3Rh
YmlsaXR5LAorICAgIGludGVyZmFjZSBzdGFibGUsIGJ1dCBubyBzZWN1cml0eSBzdXBwb3J0CisK
KyAgKiAqKlN1cHBvcnRlZCwgU2VjdXJpdHkgc3VwcG9ydCBleHRlcm5hbCoqCisgIAorICAgIFRo
aXMgZmVhdHVyZSBpcyBzZWN1cml0eSBzdXBwb3J0ZWQKKyAgICBieSBhIGRpZmZlcmVudCBvcmdh
bml6YXRpb24gKG5vdCB0aGUgWGVuUHJvamVjdCkuCisgICAgU2VlICoqRXh0ZXJuYWwgc2VjdXJp
dHkgc3VwcG9ydCoqIGJlbG93LgorCisgICogKipTdXBwb3J0ZWQsIHdpdGggY2F2ZWF0cyoqCisK
KyAgICBUaGlzIGZlYXR1cmUgaXMgc2VjdXJpdHkgc3VwcG9ydGVkIG9ubHkgdW5kZXIgY2VydGFp
biBjb25kaXRpb25zLAorICAgIG9yIHN1cHBvcnQgaXMgZ2l2ZW4gb25seSBmb3IgY2VydGFpbiBh
c3BlY3RzIG9mIHRoZSBmZWF0dXJlLAorICAgIG9yIHRoZSBmZWF0dXJlIHNob3VsZCBiZSB1c2Vk
IHdpdGggY2FyZQorICAgIGJlY2F1c2UgaXQgaXMgZWFzeSB0byB1c2UgaW5zZWN1cmVseSB3aXRo
b3V0IGtub3dpbmcgaXQuCisgICAgQWRkaXRpb25hbCBkZXRhaWxzIHdpbGwgYmUgZ2l2ZW4gaW4g
dGhlIGRlc2NyaXB0aW9uLgorCisjIyMgSW50ZXJhY3Rpb24gd2l0aCBvdGhlciBmZWF0dXJlcwor
CitOb3QgYWxsIGZlYXR1cmVzIGludGVyYWN0IHdlbGwgd2l0aCBhbGwgb3RoZXIgZmVhdHVyZXMu
CitTb21lIGZlYXR1cmVzIGFyZSBvbmx5IGZvciBIVk0gZ3Vlc3RzOyBzb21lIGRvbid0IHdvcmsg
d2l0aCBtaWdyYXRpb24sICZjLgorCisjIyMgRXh0ZXJuYWwgc2VjdXJpdHkgc3VwcG9ydAorCitU
aGUgWGVuUHJvamVjdCBzZWN1cml0eSB0ZWFtCitwcm92aWRlcyBzZWN1cml0eSBzdXBwb3J0IGZv
ciBYZW5Qcm9qZWN0IHByb2plY3RzLgorCitXZSBhbHNvIHByb3ZpZGUgc2VjdXJpdHkgc3VwcG9y
dCBmb3IgWGVuLXJlbGF0ZWQgY29kZSBpbiBMaW51eCwKK3doaWNoIGlzIGFuIGV4dGVybmFsIHBy
b2plY3QgYnV0IGRvZXNuJ3QgaGF2ZSBpdHMgb3duIHNlY3VyaXR5IHByb2Nlc3MuCisKK0V4dGVy
bmFsIHByb2plY3RzIHRoYXQgcHJvdmlkZSB0aGVpciBvd24gc2VjdXJpdHkgc3VwcG9ydCBmb3Ig
WGVuLXJlbGF0ZWQgZmVhdHVyZXMgYXJlIGxpc3RlZCBiZWxvdy4KKworICAqIFFFTVUgaHR0cHM6
Ly93aWtpLnFlbXUub3JnL2luZGV4LnBocC9TZWN1cml0eVByb2Nlc3MKKworICAqIExpYnZpcnQg
aHR0cHM6Ly9saWJ2aXJ0Lm9yZy9zZWN1cml0eXByb2Nlc3MuaHRtbAorCisgICogRnJlZUJTRCBo
dHRwczovL3d3dy5mcmVlYnNkLm9yZy9zZWN1cml0eS8KKyAgCisgICogTmV0QlNEIGh0dHA6Ly93
d3cubmV0YnNkLm9yZy9zdXBwb3J0L3NlY3VyaXR5LworICAKKyAgKiBPcGVuQlNEIGh0dHBzOi8v
d3d3Lm9wZW5ic2Qub3JnL3NlY3VyaXR5Lmh0bWwKKworIAotLSAKMi4xNS4wCgoKX19fX19fX19f
X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KWGVuLWRldmVsIG1haWxpbmcg
bGlzdApYZW4tZGV2ZWxAbGlzdHMueGVuLm9yZwpodHRwczovL2xpc3RzLnhlbi5vcmcveGVuLWRl
dmVsCg==