From mboxrd@z Thu Jan  1 00:00:00 1970
From: Andrew Cooper <andrew.cooper3@citrix.com>
Subject: [PATCH v3 3/7] docs: Improve documentation and parsing
 for pci=
Date: Wed, 16 Jan 2019 09:00:46 +0000
Message-ID: <1547629250-1405-4-git-send-email-andrew.cooper3@citrix.com>
References: <1547629250-1405-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: <1547629250-1405-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: Juergen Gross <jgross@suse.com>, Andrew Cooper <andrew.cooper3@citrix.com>, Wei Liu <wei.liu2@citrix.com>, Jan Beulich <JBeulich@suse.com>, =?UTF-8?q?Roger=20Pau=20Monn=C3=A9?= <roger.pau@citrix.com>
List-Id: xen-devel@lists.xenproject.org

QWx0ZXIgcGFyc2VfcGNpX3BhcmFtKCkgdG8gdXNlIHBhcnNlX2Jvb2xlYW4oKSwgc28gdGhlIHN1
YiBvcHRpb25zCmJlaGF2ZSBsaWtlIG90aGVyIFhlbiBib29sZWFucy4KClVwZGF0ZSB0aGUgY29t
bWFuZCBsaW5lIGRvY3VtZW50YXRpb24gZm9yIGNvbnNpc3RlbmN5LgoKU2lnbmVkLW9mZi1ieTog
QW5kcmV3IENvb3BlciA8YW5kcmV3LmNvb3BlcjNAY2l0cml4LmNvbT4KLS0tCkNDOiBKYW4gQmV1
bGljaCA8SkJldWxpY2hAc3VzZS5jb20+CkNDOiBXZWkgTGl1IDx3ZWkubGl1MkBjaXRyaXguY29t
PgpDQzogUm9nZXIgUGF1IE1vbm7DqSA8cm9nZXIucGF1QGNpdHJpeC5jb20+CkNDOiBKdWVyZ2Vu
IEdyb3NzIDxqZ3Jvc3NAc3VzZS5jb20+Cgp2MzoKICogTmV3Ci0tLQogZG9jcy9taXNjL3hlbi1j
b21tYW5kLWxpbmUucGFuZG9jIHwgIDkgKysrKy0tLS0tCiB4ZW4vZHJpdmVycy9wYXNzdGhyb3Vn
aC9wY2kuYyAgICAgfCAyMCArKysrLS0tLS0tLS0tLS0tLS0tLQogMiBmaWxlcyBjaGFuZ2VkLCA4
IGluc2VydGlvbnMoKyksIDIxIGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL2RvY3MvbWlzYy94
ZW4tY29tbWFuZC1saW5lLnBhbmRvYyBiL2RvY3MvbWlzYy94ZW4tY29tbWFuZC1saW5lLnBhbmRv
YwppbmRleCBhYjQ4NmUwLi40MWRlYzViIDEwMDY0NAotLS0gYS9kb2NzL21pc2MveGVuLWNvbW1h
bmQtbGluZS5wYW5kb2MKKysrIGIvZG9jcy9taXNjL3hlbi1jb21tYW5kLWxpbmUucGFuZG9jCkBA
IC0xNTAyLDEzICsxNTAyLDEyIEBAIFRoaXMgb3B0aW9uIGlzIGlnbm9yZWQgaW4gKipwdi1zaGlt
KiogbW9kZS4KID4gRGVmYXVsdDogYG9uYAogCiAjIyMgcGNpCi0+IGA9IHtuby19c2VyciB8IHtu
by19cGVycmAKKyAgICA9IExpc3Qgb2YgWyBzZXJyPTxib29sPiwgcGVycj08Ym9vbD4gXQogCi0+
IERlZmF1bHQ6IFNpZ25hbGluZyBsZWZ0IGFzIHNldCBieSBmaXJtd2FyZS4KLQotRGlzYWJsZSBz
aWduYWxpbmcgb2YgU0VSUiAoc3lzdGVtIGVycm9ycykgYW5kL29yIFBFUlIgKHBhcml0eSBlcnJv
cnMpCi1vbiBhbGwgUENJIGRldmljZXMuCisgICAgRGVmYXVsdDogU2lnbmFsaW5nIGxlZnQgYXMg
c2V0IGJ5IGZpcm13YXJlLgogCitPdmVycmlkZSB0aGUgZmlybXdhcmUgc2V0dGluZ3MsIGFuZCBl
eHBsaWNpdGx5IGVuYWJsZSBvciBkaXNhYmxlIHRoZQorc2lnbmFsbGluZyBvZiBQQ0kgU3lzdGVt
IGFuZCBQYXJpdHkgZXJyb3JzLgogCiAjIyMgcGNpLXBoYW50b20KID4gYD1bPHNlZz46XTxidXM+
OjxkZXZpY2U+LDxzdHJpZGU+YApkaWZmIC0tZ2l0IGEveGVuL2RyaXZlcnMvcGFzc3Rocm91Z2gv
cGNpLmMgYi94ZW4vZHJpdmVycy9wYXNzdGhyb3VnaC9wY2kuYwppbmRleCA5M2MyMGI5Li44MTA4
ZWQ1IDEwMDY0NAotLS0gYS94ZW4vZHJpdmVycy9wYXNzdGhyb3VnaC9wY2kuYworKysgYi94ZW4v
ZHJpdmVycy9wYXNzdGhyb3VnaC9wY2kuYwpAQCAtMTg4LDM3ICsxODgsMjUgQEAgY3VzdG9tX3Bh
cmFtKCJwY2ktcGhhbnRvbSIsIHBhcnNlX3BoYW50b21fZGV2KTsKIHN0YXRpYyB1MTYgX19yZWFk
X21vc3RseSBjb21tYW5kX21hc2s7CiBzdGF0aWMgdTE2IF9fcmVhZF9tb3N0bHkgYnJpZGdlX2N0
bF9tYXNrOwogCi0vKgotICogVGhlICdwY2knIHBhcmFtZXRlciBjb250cm9scyBjZXJ0YWluIFBD
SSBkZXZpY2UgYXNwZWN0cy4KLSAqIE9wdGlvbmFsIGNvbW1hIHNlcGFyYXRlZCB2YWx1ZSBtYXkg
Y29udGFpbjoKLSAqCi0gKiAgIHNlcnIgICAgICAgICAgICAgICAgICAgICAgIGRvbid0IHN1cHBy
ZXNzIHN5c3RlbSBlcnJvcnMgKGRlZmF1bHQpCi0gKiAgIG5vLXNlcnIgICAgICAgICAgICAgICAg
ICAgIHN1cHByZXNzIHN5c3RlbSBlcnJvcnMKLSAqICAgcGVyciAgICAgICAgICAgICAgICAgICAg
ICAgZG9uJ3Qgc3VwcHJlc3MgcGFyaXR5IGVycm9ycyAoZGVmYXVsdCkKLSAqICAgbm8tcGVyciAg
ICAgICAgICAgICAgICAgICAgc3VwcHJlc3MgcGFyaXR5IGVycm9ycwotICovCiBzdGF0aWMgaW50
IF9faW5pdCBwYXJzZV9wY2lfcGFyYW0oY29uc3QgY2hhciAqcykKIHsKICAgICBjb25zdCBjaGFy
ICpzczsKICAgICBpbnQgcmMgPSAwOwogCiAgICAgZG8gewotICAgICAgICBib29sX3Qgb24gPSAh
IXN0cm5jbXAocywgIm5vLSIsIDMpOworICAgICAgICBpbnQgdmFsOwogICAgICAgICB1MTYgY21k
X21hc2sgPSAwLCBicmN0bF9tYXNrID0gMDsKIAotICAgICAgICBpZiAoICFvbiApCi0gICAgICAg
ICAgICBzICs9IDM7Ci0KICAgICAgICAgc3MgPSBzdHJjaHIocywgJywnKTsKICAgICAgICAgaWYg
KCAhc3MgKQogICAgICAgICAgICAgc3MgPSBzdHJjaHIocywgJ1wwJyk7CiAKLSAgICAgICAgaWYg
KCAhY21kbGluZV9zdHJjbXAocywgInNlcnIiKSApCisgICAgICAgIGlmICggKHZhbCA9IHBhcnNl
X2Jvb2xlYW4oInNlcnIiLCBzLCBzcykpID49IDAgKQogICAgICAgICB7CiAgICAgICAgICAgICBj
bWRfbWFzayA9IFBDSV9DT01NQU5EX1NFUlI7CiAgICAgICAgICAgICBicmN0bF9tYXNrID0gUENJ
X0JSSURHRV9DVExfU0VSUiB8IFBDSV9CUklER0VfQ1RMX0RUTVJfU0VSUjsKICAgICAgICAgfQot
ICAgICAgICBlbHNlIGlmICggIWNtZGxpbmVfc3RyY21wKHMsICJwZXJyIikgKQorICAgICAgICBl
bHNlIGlmICggKHZhbCA9IHBhcnNlX2Jvb2xlYW4oInBlcnIiLCBzLCBzcykpID49IDAgKQogICAg
ICAgICB7CiAgICAgICAgICAgICBjbWRfbWFzayA9IFBDSV9DT01NQU5EX1BBUklUWTsKICAgICAg
ICAgICAgIGJyY3RsX21hc2sgPSBQQ0lfQlJJREdFX0NUTF9QQVJJVFk7CkBAIC0yMjYsNyArMjE0
LDcgQEAgc3RhdGljIGludCBfX2luaXQgcGFyc2VfcGNpX3BhcmFtKGNvbnN0IGNoYXIgKnMpCiAg
ICAgICAgIGVsc2UKICAgICAgICAgICAgIHJjID0gLUVJTlZBTDsKIAotICAgICAgICBpZiAoIG9u
ICkKKyAgICAgICAgaWYgKCB2YWwgKQogICAgICAgICB7CiAgICAgICAgICAgICBjb21tYW5kX21h
c2sgJj0gfmNtZF9tYXNrOwogICAgICAgICAgICAgYnJpZGdlX2N0bF9tYXNrICY9IH5icmN0bF9t
YXNrOwotLSAKMi4xLjQKCgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fXwpYZW4tZGV2ZWwgbWFpbGluZyBsaXN0Clhlbi1kZXZlbEBsaXN0cy54ZW5wcm9qZWN0
Lm9yZwpodHRwczovL2xpc3RzLnhlbnByb2plY3Qub3JnL21haWxtYW4vbGlzdGluZm8veGVuLWRl
dmVs