From mboxrd@z Thu Jan  1 00:00:00 1970
From: Andrew Cooper <andrew.cooper3@citrix.com>
Subject: [PATCH 3/3] docs/admin-guide: Boot time microcode
 loading
Date: Tue, 19 Mar 2019 16:20:07 +0000
Message-ID: <1553012407-19885-4-git-send-email-andrew.cooper3@citrix.com>
References: <1553012407-19885-1-git-send-email-andrew.cooper3@citrix.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <xen-devel-bounces@lists.xenproject.org>
In-Reply-To: <1553012407-19885-1-git-send-email-andrew.cooper3@citrix.com>
List-Unsubscribe: <https://lists.xenproject.org/mailman/options/xen-devel>,
 <mailto:xen-devel-request@lists.xenproject.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xenproject.org>
List-Help: <mailto:xen-devel-request@lists.xenproject.org?subject=help>
List-Subscribe: <https://lists.xenproject.org/mailman/listinfo/xen-devel>,
 <mailto:xen-devel-request@lists.xenproject.org?subject=subscribe>
Errors-To: xen-devel-bounces@lists.xenproject.org
Sender: "Xen-devel" <xen-devel-bounces@lists.xenproject.org>
To: Xen-devel <xen-devel@lists.xen.org>
Cc: Lars Kurth <lars.kurth@citrix.com>, Stefano Stabellini <sstabellini@kernel.org>, Wei Liu <wei.liu2@citrix.com>, Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>, George Dunlap <George.Dunlap@eu.citrix.com>, Andrew Cooper <andrew.cooper3@citrix.com>, Tim Deegan <tim@xen.org>, Julien Grall <julien.grall@arm.com>, Jan Beulich <JBeulich@suse.com>, Ian Jackson <ian.jackson@citrix.com>, =?UTF-8?q?Roger=20Pau=20Monn=C3=A9?= <roger.pau@citrix.com>
List-Id: xen-devel@lists.xenproject.org

UmVjZW50IGRpc2N1c3Npb24gb24geGVuLWRldmVsIGhhcyBkZW1vbnN0cmF0ZWQgdGhhdCBYZW4g
ZXhpc3RpbmcgbWljcm9jb2RlCmxvYWRpbmcgc3VwcG9ydCBpc24ndCBhZGVxdWF0ZWx5IGRvY3Vt
ZW50ZWQuICBUYWtlIHRoZSBvcHBvcnR1bml0eSB0byBhZGRyZXNzCnRoaXMsIGFuZCBzdGFydCBz
b21lIGVuZC11c2VyIGZvY3VzZWQgZG9jdW1lbnRhdGlvbi4KClNpZ25lZC1vZmYtYnk6IEFuZHJl
dyBDb29wZXIgPGFuZHJldy5jb29wZXIzQGNpdHJpeC5jb20+Ci0tLQpDQzogR2VvcmdlIER1bmxh
cCA8R2VvcmdlLkR1bmxhcEBldS5jaXRyaXguY29tPgpDQzogSWFuIEphY2tzb24gPGlhbi5qYWNr
c29uQGNpdHJpeC5jb20+CkNDOiBKYW4gQmV1bGljaCA8SkJldWxpY2hAc3VzZS5jb20+CkNDOiBL
b25yYWQgUnplc3p1dGVrIFdpbGsgPGtvbnJhZC53aWxrQG9yYWNsZS5jb20+CkNDOiBTdGVmYW5v
IFN0YWJlbGxpbmkgPHNzdGFiZWxsaW5pQGtlcm5lbC5vcmc+CkNDOiBUaW0gRGVlZ2FuIDx0aW1A
eGVuLm9yZz4KQ0M6IFdlaSBMaXUgPHdlaS5saXUyQGNpdHJpeC5jb20+CkNDOiBKdWxpZW4gR3Jh
bGwgPGp1bGllbi5ncmFsbEBhcm0uY29tPgpDQzogUm9nZXIgUGF1IE1vbm7DqSA8cm9nZXIucGF1
QGNpdHJpeC5jb20+CkNDOiBMYXJzIEt1cnRoIDxsYXJzLmt1cnRoQGNpdHJpeC5jb20+CgpJJ3Zl
IGRlbGliZXJhdGVseSBvbWl0dGVkIHJ1bnRpbWUgbWljcm9jb2RlIGxvYWRpbmcgYXQgdGhpcyBw
b2ludCwgYmVjYXVzZSBpdAppcyBjdXJyZW50bHkgcmF0aGVyIGJyb2tlbiBhbmQgaXRzIGltcGxl
bWVudGF0aW9uIGlzIGluIGZsdXguICBUaGlzIGRvY3VtZW50CmNhbiBiZSBleHRlbmRlZCBpbiBk
dWUgY291cnNlLgotLS0KIGRvY3MvYWRtaW4tZ3VpZGUvaW5kZXgucnN0ICAgICAgICAgICAgIHwg
ICA1ICsrCiBkb2NzL2FkbWluLWd1aWRlL21pY3JvY29kZS1sb2FkaW5nLnJzdCB8IDEwMyArKysr
KysrKysrKysrKysrKysrKysrKysrKysrKysrKysKIGRvY3MvaW5kZXgucnN0ICAgICAgICAgICAg
ICAgICAgICAgICAgIHwgICA4ICsrKwogMyBmaWxlcyBjaGFuZ2VkLCAxMTYgaW5zZXJ0aW9ucygr
KQogY3JlYXRlIG1vZGUgMTAwNjQ0IGRvY3MvYWRtaW4tZ3VpZGUvaW5kZXgucnN0CiBjcmVhdGUg
bW9kZSAxMDA2NDQgZG9jcy9hZG1pbi1ndWlkZS9taWNyb2NvZGUtbG9hZGluZy5yc3QKCmRpZmYg
LS1naXQgYS9kb2NzL2FkbWluLWd1aWRlL2luZGV4LnJzdCBiL2RvY3MvYWRtaW4tZ3VpZGUvaW5k
ZXgucnN0Cm5ldyBmaWxlIG1vZGUgMTAwNjQ0CmluZGV4IDAwMDAwMDAuLjRkOWJjYjQKLS0tIC9k
ZXYvbnVsbAorKysgYi9kb2NzL2FkbWluLWd1aWRlL2luZGV4LnJzdApAQCAtMCwwICsxLDUgQEAK
K1VzZXIgZG9jdW1lbnRhdGlvbgorPT09PT09PT09PT09PT09PT09CisKKy4uIHRvY3RyZWU6Ogor
ICAgbWljcm9jb2RlLWxvYWRpbmcKZGlmZiAtLWdpdCBhL2RvY3MvYWRtaW4tZ3VpZGUvbWljcm9j
b2RlLWxvYWRpbmcucnN0IGIvZG9jcy9hZG1pbi1ndWlkZS9taWNyb2NvZGUtbG9hZGluZy5yc3QK
bmV3IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMC4uNTgzOTNiOAotLS0gL2Rldi9udWxs
CisrKyBiL2RvY3MvYWRtaW4tZ3VpZGUvbWljcm9jb2RlLWxvYWRpbmcucnN0CkBAIC0wLDAgKzEs
MTAzIEBACitNaWNyb2NvZGUgTG9hZGluZworPT09PT09PT09PT09PT09PT0KKworTGlrZSBtYW55
IG90aGVyIHBpZWNlcyBvZiBoYXJkd2FyZSwgQ1BVcyB0aGVtc2VsdmVzIGhhdmUgZXJyYXRhIHdo
aWNoIGFyZQorZGlzY292ZXJlZCBhZnRlciBzaGlwcGluZywgYW5kIG5lZWQgdG8gYmUgYWRkcmVz
c2VkIGluIHRoZSBmaWVsZC4gIE1pY3JvY29kZQorY2FuIGJlIGNvbnNpZGVyZWQgYXMgZmlybXdh
cmUgZm9yIHRoZSBwcm9jZXNzb3IsIGFuZCBuZXcgbWljcm9jb2RlIGlzCitwdWJsaXNoZWQgYXMg
bmVlZGVkIGJ5IHRoZSBwcm9jZXNzb3IgdmVuZG9ycy4KKworTWljcm9jb2RlIGlzIGluY2x1ZGVk
IGFzIHBhcnQgb2YgdGhlIHN5c3RlbSBmaXJtd2FyZSBieSBhbiBPRU0sIGFuZCBhIHN5c3RlbQor
ZmlybXdhcmUgdXBkYXRlIGlzIHRoZSBwcmVmZXJyZWQgd2F5IG9mIG9idGFpbmluZyB1cGRhdGVk
IG1pY3JvY29kZS4gIEhvd2V2ZXIsCit0aGlzIGlzIG9mdGVuIG5vdCB0aGUgbW9zdCBleHBlZGll
bnQgd2F5IHRvIGdldCB1cGRhdGVkIG1pY3JvY29kZSwgc28gWGVuCitzdXBwb3J0cyBsb2FkaW5n
IG1pY3JvY29kZSBpdHNlbGYuCisKK0Rpc3Ryb3MgdHlwaWNhbGx5IHBhY2thZ2UgbWljcm9jb2Rl
IHVwZGF0ZXMgZm9yIHVzZXJzLCBhbmQgbWF5IHByb3ZpZGUgaG9va3MKK3RvIGNhdXNlIG1pY3Jv
Y29kZSB0byBiZSBhdXRvbWF0aWNhbGx5IGxvYWRlZCBhdCBib290IHRpbWUuICBDb25zdWx0IHlv
dXIgZG9tMAorZGlzdHJvIGd1aWRhbmNlIGZvciBtaWNyb2NvZGUgbG9hZGluZy4KKworTWljcm9j
b2RlIGNhbiBtYWtlIGFsbW9zdCBhcmJpdHJhcnkgY2hhbmdlcyB0byB0aGUgcHJvY2Vzc29yLCBp
bmNsdWRpbmcgdG8KK3NvZnR3YXJlIHZpc2libGUgZmVhdHVyZXMuICBUaGlzIGluY2x1ZGVzIHJl
bW92aW5nIGZlYXR1cmVzIChlLmcuIHRoZSBIYXN3ZWxsCitUU1ggZXJyYXRhIHdoaWNoIG5lY2Vz
c2l0YXRlZCBkaXNhYmxpbmcgdGhlIGZlYXR1cmUgZW50aXJlbHkpLCBvciB0aGUgYWRkaXRpb24K
K29mIGJyYW5kIG5ldyBmZWF0dXJlcyAoZS5nLiB0aGUgU3BlY3RyZSB2MiBjb250cm9scyB0byB3
b3JrIGFyb3VuZCBzcGVjdWxhdGl2ZQorZXhlY3V0aW9uIHZ1bG5lcmFiaWxpdGllcykuCisKKwor
Qm9vdCB0aW1lIG1pY3JvY29kZSBsb2FkaW5nCistLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0K
KworV2hlcmUgcG9zc2libGUsIG1pY3JvY29kZSBzaG91bGQgYmUgbG9hZGVkIGF0IGJvb3QgdGlt
ZS4gIFRoaXMgYWxsb3dzIHRoZSBDUFUKK3RvIGJlIHVwZGF0ZWQgdG8gaXRzIGV2ZW50dWFsIGNv
bmZpZ3VyYXRpb24gYmVmb3JlIFhlbiBzdGFydHMgbWFraW5nIHNldHVwCitkZWNpc2lvbnMgYmFz
ZWQgb24gdGhlIHZpc2libGUgZmVhdHVyZXMuCisKK1hlbiB3aWxsIHJlcG9ydCBkdXJpbmcgYm9v
dCBpZiBpdCBwZXJmb3JtZWQgYSBtaWNyb2NvZGUgdXBkYXRlLiAgZS5nLjo6CisKKyAgW3Jvb3RA
aG9zdCB+XSMgeGwgZG1lc2cgfCBncmVwIG1pY3JvY29kZQorICAoWEVOKSBtaWNyb2NvZGU6IENQ
VTAgdXBkYXRlZCBmcm9tIHJldmlzaW9uIDB4MWEgdG8gMHgyNSwgZGF0ZSA9IDIwMTgtMDQtMDIK
KyAgKFhFTikgbWljcm9jb2RlOiBDUFUyIHVwZGF0ZWQgZnJvbSByZXZpc2lvbiAweDFhIHRvIDB4
MjUsIGRhdGUgPSAyMDE4LTA0LTAyCisgIChYRU4pIG1pY3JvY29kZTogQ1BVNCB1cGRhdGVkIGZy
b20gcmV2aXNpb24gMHgxYSB0byAweDI1LCBkYXRlID0gMjAxOC0wNC0wMgorICAoWEVOKSBtaWNy
b2NvZGU6IENQVTYgdXBkYXRlZCBmcm9tIHJldmlzaW9uIDB4MWEgdG8gMHgyNSwgZGF0ZSA9IDIw
MTgtMDQtMDIKKworVGhlIGV4YWN0IGRldGFpbHMgcHJpbnRlZCBhcmUgc3lzdGVtIGFuZCBtaWNy
b2NvZGUgc3BlY2lmaWMuICBBZnRlciBib290LCB0aGUKK2N1cnJlbnQgbWljcm9jb2RlIHZlcnNp
b24gY2FuIG9idGFpbmVkIGZyb20gd2l0aCBkb20wLiAgZS5nLjo6CisKKyAgW3Jvb3RAaG9zdCB+
XSMgaGVhZCAvcHJvYy9jcHVpbmZvCisgIHByb2Nlc3NvciAgICA6IDAKKyAgdmVuZG9yX2lkICAg
IDogR2VudWluZUludGVsCisgIGNwdSBmYW1pbHkgICA6IDYKKyAgbW9kZWwgICAgICAgIDogNjAK
KyAgbW9kZWwgbmFtZSAgIDogSW50ZWwoUikgWGVvbihSKSBDUFUgRTMtMTI0MCB2MyBAIDMuNDBH
SHoKKyAgc3RlcHBpbmcgICAgIDogMworICBtaWNyb2NvZGUgICAgOiAweDI1CisgIGNwdSBNSHog
ICAgICA6IDMzOTIuMTQ4CisgIGNhY2hlIHNpemUgICA6IDgxOTIgS0IKKyAgcGh5c2ljYWwgaWQg
IDogMAorCisKK0xvYWRpbmcgbWljcm9jb2RlIGZyb20gYSBzaW5nbGUgZmlsZQorfn5+fn5+fn5+
fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+CisKK1hlbiBoYW5kbGVzIG1pY3JvY29kZSBibG9i
cyBpbiB0aGUgYmluYXJ5IGZvcm0gc2hpcHBlZCBieSB2ZW5kb3JzLCB3aGljaCBpcworYWxzbyB0
aGUgZm9ybSB0aGUgcHJvY2Vzc29yIHVzZXMuICBUaGlzIGJpbmFyeSBmb3JtIGNvbnRhaW5zIGhl
YWRlcgoraW5mb3JtYXRpb24gd2hpY2ggWGVuIGFuZCB2YXJpb3VzIHVzZXJzcGFjZSB0b29scyBj
YW4gdXNlIHRvIGlkZW50aWZ5IHRoZQorY29ycmVjdCBibG9iIGZvciBhIHNwZWNpZmljIENQVS4K
KworVG9vbHMgc3VjaCBhcyBkcmFjdXQgd2lsbCBpZGVudGlmeSB0aGUgY29ycmVjdCBibG9iIGZv
ciB0aGUgY3VycmVudCBDUFUsIHdoaWNoCit3aWxsIGJlIGEgZmV3IGtpbG9ieXRlcywgZm9yIG1p
bmltYWwgb3ZlcmhlYWQgZHVyaW5nIGJvb3QuCisKK0FkZGl0aW9uYWxseSwgWGVuIGlzIGNhcGFi
bGUgb2YgaGFuZGxpbmcgYSBudW1iZXIgb2YgYmxvYnMgY29uY2F0ZW5hdGVkCit0b2dldGhlciwg
YW5kIHdpbGwgbG9jYXRlIHRoZSBhcHByb3ByaWF0ZSBibG9iIGJhc2VkIG9uIHRoZSBoZWFkZXIK
K2luZm9ybWF0aW9uLgorCitUaGlzIG9wdGlvbiBpcyBsZXNzIGVmZmljaWVudCBkdXJpbmcgYm9v
dCwgYnV0IG1heSBiZSBwcmVmZXJyZWQgaW4gc2l0dWF0aW9ucword2hlcmUgdGhlIGV4YWN0IENQ
VSBkZXRhaWxzIGFyZW4ndCBrbm93biBhaGVhZCBvZiBib290aW5nIChlLmcuIGluc3RhbGwKK21l
ZGlhKS4KKworVGhlIGZpbGUgY29udGFpbmluZyB0aGUgYmxvYihzKSBuZWVkcyB0byBiZSBhY2Nl
c3NpYmxlIHRvIFhlbiBhcyBlYXJseSBhcworcG9zc2libGUuCisKKyogRm9yIG11bHRpYm9vdC9t
dWx0aWJvb3QyIGJvb3RzLCB0aGlzIGlzIGFjaGlldmVkIGJ5IGxvYWRpbmcgdGhlIGJsb2IgYXMg
YQorICBtdWx0aWJvb3QgbW9kdWxlLiAgVGhlIGBgdWNvZGU9JG51bWBgIGNvbW1hbmQgbGluZSBv
cHRpb24gY2FuIGJlIHVzZWQgdG8KKyAgaWRlbnRpZnkgd2hpY2ggbXVsdGlib290IG1vZHVsZSBj
b250YWlucyB0aGUgbWljcm9jb2RlLCBpbmNsdWRpbmcgbmVnYXRpdmUKKyAgaW5kZXhpbmcgdG8g
Y291bnQgZnJvbSB0aGUgZW5kLgorCisqIEZvciBFRkkgYm9vdHMsIHRoZXJlIGlzbid0IHJlYWxs
eSBhIGNvbmNlcHQgb2YgbW9kdWxlcy4gIEEgbWljcm9jb2RlIGZpbGUKKyAgY2FuIGJlIHNwZWNp
ZmllZCBpbiB0aGUgRUZJIGNvbmZpZ3VyYXRpb24gZmlsZSB3aXRoIGBgdWNvZGU9JGZpbGVgYC4g
IFVzZSBvZgorICB0aGlzIG1lY2hhbmlzbSB3aWxsIG92ZXJyaWRlIGFueSBgYHVjb2RlPWBgIHNl
dHRpbmdzIG9uIHRoZSBjb21tYW5kIGxpbmUuCisKKworTG9hZGluZyBtaWNyb2NvZGUgZnJvbSBh
IExpbnV4IGluaXRyZAorfn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fgorCitG
b3Igc3lzdGVtcyB1c2luZyBhIExpbnV4IGJhc2VkIGRvbTAsIGl0IHVzdWFsbHkgc3VmZmljZXMg
dG8gaW5zdGFsbCB0aGUKK2FwcHJvcHJpYXRlIGRpc3RybyBwYWNrYWdlLCBhbmQgYWRkIGBgdWNv
ZGU9c2NhbmBgIHRvIFhlbidzIGNvbW1hbmQgbGluZS4KKworWGVuIGlzIGNvbXBhdGlibGUgd2l0
aCB0aGUgTGludXggaW5pdHJkIG1pY3JvY29kZSBwcm90b2NvbC4gIFRoZSBpbml0cmQgaXMKK2V4
cGVjdGVkIHRvIGJlIGdlbmVyYXRlZCB3aXRoIGFuIHVuY29tcHJlc3NlZCBDUElPIGZyYWdtZW50
IGF0IHRoZSBiZWdpbm5pbmcKK3doaWNoIGNvbnRhaW5zIGNvbnRhaW5zIG9uZSBvZiB0aGVzZSB0
d28gZmlsZXM6OgorCisgIGtlcm5lbC94ODYvbWljcm9jb2RlL0dlbnVpbmVJbnRlbC5iaW4KKyAg
a2VybmVsL3g4Ni9taWNyb2NvZGUvQXV0aGVudGljQU1ELmJpbgorCitUaGUgYGB1Y29kZT1zY2Fu
YGAgY29tbWFuZCBsaW5lIG9wdGlvbiB3aWxsIGNhdXNlIFhlbiB0byBzZWFyY2ggdGhyb3VnaCBh
bGwKK21vZHVsZXMgdG8gZmluZCBhbnkgQ1BJTyBhcmNoaXZlcywgYW5kIGxvb2sgdXAgdGhlIGFw
cGxpY2FibGUgZmlsZSBpbiB0aGUgQ1BJTworYXJjaGl2ZS4KZGlmZiAtLWdpdCBhL2RvY3MvaW5k
ZXgucnN0IGIvZG9jcy9pbmRleC5yc3QKaW5kZXggNzMyZWJlMC4uYWIzZDBlMCAxMDA2NDQKLS0t
IGEvZG9jcy9pbmRleC5yc3QKKysrIGIvZG9jcy9pbmRleC5yc3QKQEAgLTEsMiArMSwxMCBAQAog
VGhlIFhlbiBIeXBlcnZpc29yIGRvY3VtZW50YXRpb24KID09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09CisKK1VzZXIgZG9jdW1lbnRhdGlvbgorLS0tLS0tLS0tLS0tLS0tLS0tCisKKy4u
IHRvY3RyZWU6OgorICAgOm1heGRlcHRoOiAyCisKKyAgIGFkbWluLWd1aWRlL2luZGV4Ci0tIAoy
LjEuNAoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClhl
bi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVuLWRldmVsQGxpc3RzLnhlbnByb2plY3Qub3JnCmh0dHBz
Oi8vbGlzdHMueGVucHJvamVjdC5vcmcvbWFpbG1hbi9saXN0aW5mby94ZW4tZGV2ZWw=