From mboxrd@z Thu Jan 1 00:00:00 1970 From: George Dunlap Subject: [PATCH] docs/xl: Clarify documentation for mem-max and mem-set Date: Wed, 1 Aug 2018 16:41:24 +0100 Message-ID: <20180801154124.12130-1-george.dunlap@citrix.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from all-amaz-eas1.inumbo.com ([34.197.232.57]) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1fktFj-00077y-1O for xen-devel@lists.xenproject.org; Wed, 01 Aug 2018 15:41:31 +0000 List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" To: xen-devel@lists.xenproject.org Cc: Lars Kurth , Stefano Stabellini , Wei Liu , Andrew Cooper , Tim Deegan , George Dunlap , Julien Grall , Jan Beulich , Ian Jackson List-Id: xen-devel@lists.xenproject.org bWVtLXNldCBpcyB0aGUgcHJpbWFyeSBjb21tYW5kIHRoYXQgdXNlcnMgd2lsbCBuZWVkIHRvIHVz ZSBhbmQKdW5kZXJzdGFuZC4gIE1vdmUgaXQgZmlyc3QsIGFuZCBjbGFyaWZ5IHRoZSB3b3JkaW5n OyBhbHNvIHNwZWNpZnkgdGhhdAp5b3UgY2FuJ3Qgc2V0IHRoZSB0YXJnZXQgaGlnaGVyIHRoYW4g bWF4bWVtIGZyb20gdGhlIGRvbWFpbiBjb25maWcuCgptZW0tbWF4IGlzIGFjdHVhbGx5IGEgcHJl dHR5IHVzZWxlc3MgY29tbWFuZCBhdCB0aGUgbW9tZW50LiAgQ2xhcmlmeQp0aGF0IHVzZXJzIGFy ZSBub3QgZXhwZWN0ZWQgdG8gdXNlIGl0OyBhbmQgZG9jdW1lbnQgYWxsIG9mIGl0cyBxdWlya3kK YmVoYXZpb3IuCgpTaWduZWQtb2ZmLWJ5OiBHZW9yZ2UgRHVubGFwIDxnZW9yZ2UuZHVubGFwQGNp dHJpeC5jb20+Ci0tLQpJJ20gYWN0dWxseSBzb21ld2hhdCB0ZW1wdGVkIHRvIHRha2Ugb3V0IHRo ZSBlbnRyeSBmb3IgbWVtLW1heAplbnRpcmVseSAtLSBpdCdzIG5vdCBhdCBhbGwgY2xlYXIgdG8g bWUgd2hhdCBhbnlvbmUgd291bGQgdXNlIGl0IGZvciwKYW5kIGl0J3Mgb25seSBsaWtlbHkgdG8g Y29uZnVzZSBwZW9wbGUuCgpDQzogSWFuIEphY2tzb24gPGlhbi5qYWNrc29uQGNpdHJpeC5jb20+ CkNDOiBXZWkgTGl1IDx3ZWkubGl1MkBjaXRyaXguY29tPgpDQzogQW5kcmV3IENvb3BlciA8YW5k cmV3LmNvb3BlcjNAY2l0cml4LmNvbT4KQ0M6IEphbiBCZXVsaWNoIDxqYmV1bGljaEBzdXNlLmNv bT4KQ0M6IFRpbSBEZWVnYW4gPHRpbUB4ZW4ub3JnPgpDQzogS29ucmFkIFdpbGsgPGtvbnJhZC53 aWxrQG9yYWNsZS5jb20+CkNDOiBTdGVmYW5vIFN0YWJlbGxpbmkgPHNzdGFiZWxsaW5pQGtlcm5l bC5vcmc+CkNDOiBKdWxpZW4gR3JhbGwgPGp1bGllbi5ncmFsbEBhcm0uY29tPgpDQzogTGFycyBL dXJ0aCA8bGFycy5rdXJ0aEBjaXRyaXguY29tPgotLS0KIGRvY3MvbWFuL3hsLnBvZC4xLmluIHwg NzIgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrLS0tLS0tLS0tLS0tLS0KIDEgZmlsZSBj aGFuZ2VkLCA1MCBpbnNlcnRpb25zKCspLCAyMiBkZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9k b2NzL21hbi94bC5wb2QuMS5pbiBiL2RvY3MvbWFuL3hsLnBvZC4xLmluCmluZGV4IGI3NDc2NGRj ZDMuLjFkM2RhYmYxODUgMTAwNjQ0Ci0tLSBhL2RvY3MvbWFuL3hsLnBvZC4xLmluCisrKyBiL2Rv Y3MvbWFuL3hsLnBvZC4xLmluCkBAIC0zOTMsNDAgKzM5Myw2OCBAQCBsZXNzIHV0aWxpemVkIHRo YW4gYSBoaWdoIENQVSB3b3JrbG9hZC4gIENvbnNpZGVyIHlvdXJzZWxmIHdhcm5lZC4KIAogPWJh Y2sKIAotPWl0ZW0gQjxtZW0tbWF4PiBJPGRvbWFpbi1pZD4gSTxtZW0+Cis9aXRlbSBCPG1lbS1z ZXQ+IEk8ZG9tYWluLWlkPiBJPG1lbT4KIAotU3BlY2lmeSB0aGUgbWF4aW11bSBhbW91bnQgb2Yg bWVtb3J5IHRoZSBkb21haW4gaXMgYWJsZSB0byB1c2UsIGFwcGVuZGluZyAndCcKLWZvciB0ZXJh Ynl0ZXMsICdnJyBmb3IgZ2lnYWJ5dGVzLCAnbScgZm9yIG1lZ2FieXRlcywgJ2snIGZvciBraWxv Ynl0ZXMgYW5kICdiJwotZm9yIGJ5dGVzLgorU2V0IHRoZSB0YXJnZXQgZm9yIHRoZSBkb21haW4n cyBiYWxsb29uIGRyaXZlci4gIEFwcGVuZCAndCcgZm9yCit0ZXJhYnl0ZXMsICdnJyBmb3IgZ2ln YWJ5dGVzLCAnbScgZm9yIG1lZ2FieXRlcywgJ2snIGZvciBraWxvYnl0ZXMKK2FuZCAnYicgZm9y IGJ5dGVzLgogCi1UaGUgbWVtLW1heCB2YWx1ZSBtYXkgbm90IGNvcnJlc3BvbmQgdG8gdGhlIGFj dHVhbCBtZW1vcnkgdXNlZCBpbiB0aGUKLWRvbWFpbiwgYXMgaXQgbWF5IGJhbGxvb24gZG93biBp dHMgbWVtb3J5IHRvIGdpdmUgbW9yZSBiYWNrIHRvIHRoZSBPUy4KK1RoaXMgbXVzdCBiZSBsZXNz IHRoYW4gdGhlIGluaXRpYWwgQjxtYXhtZW0+IHBhcmFtZXRlciBpbiB0aGUgZG9tYWluJ3MKK2Nv bmZpZ3VyYXRpb24uCiAKLVRoZSB2YWx1ZSBnaXZlbiBqdXN0IHNldHMgdGhlIG1lbW9yeSBhbW91 bnQgdGhlIGRvbWFpbiBpcyBhbGxvd2VkIHRvIGFsbG9jYXRlCi1pbiB0aGUgaHlwZXJ2aXNvci4g SXQgY2FuJ3QgYmUgc2V0IGxvd2VyIHRoYW4gdGhlIGN1cnJlbnQgcmVzZXJ2YXRpb24sIGJ1dAot aXQgaXMgYWxsb3dlZCB0byBiZSBoaWdoZXIgdGhhbiB0aGUgY29uZmlndXJlZCBtYXhpbXVtIG1l bW9yeSBzaXplIG9mIHRoZQotZG9tYWluIChCPG1heG1lbT4gcGFyYW1ldGVyIGluIHRoZSBkb21h aW4ncyBjb25maWd1cmF0aW9uKS4gVXNpbmcgQjx4bCBtZW0tbWF4PgotdG8gc2V0IHRoZSBtYXhp bXVtIG1lbW9yeSBhYm92ZSB0aGUgaW5pdGlhbCBCPG1heG1lbT4gdmFsdWUgd2lsbCBub3QgYWxs b3cgdGhlCi1hZGRpdGlvbmFsIG1lbW9yeSB0byBiZSB1c2VkIHZpYSBCPHhsIG1lbS1zZXQ+LiBU aGUgaW5pdGlhbCBCPG1heG1lbT4gdmFsdWUgaXMKLXN0aWxsIHVzZWQgYXMgYW4gdXBwZXIgbGlt aXQgZm9yIEI8eGwgbWVtLXNldD4uCitOb3RlIHRoYXQgdGhpcyBvcGVyYXRpb24gcmVxdWVzdHMg dGhlIGd1ZXN0IG9wZXJhdGluZyBzeXN0ZW0ncyBiYWxsb29uCitkcml2ZXIgdG8gcmVhY2ggdGhl IHRhcmdldCBhbW91bnQgb2YgbWVtb3J5LiAgVGhlIGd1ZXN0IG1heSBmYWlsIHRvCityZWFjaCB0 aGF0IGFtb3VudCBvZiBtZW1vcnkgZm9yIGFueSBudW1iZXIgb2YgcmVhc29ucywgaW5jbHVkaW5n OgogCi1UaGUgZG9tYWluIHdpbGwgbm90IHJlY2VpdmUgYW55IHNpZ25hbCByZWdhcmRpbmcgdGhl IGNoYW5nZWQgbWVtb3J5IGxpbWl0LgorPW92ZXIgNAogCi09aXRlbSBCPG1lbS1zZXQ+IEk8ZG9t YWluLWlkPiBJPG1lbT4KKz1pdGVtCisKK1RoZSBndWVzdCBkb2Vzbid0IGhhdmUgYSBiYWxsb29u IGRyaXZlciBpbnN0YWxsZWQKKworPWl0ZW0KKworVGhlIGd1ZXN0J3MgYmFsbG9vbiBkcml2ZXIg aXMgYnVnZ3kKKworPWl0ZW0KKworVGhlIGd1ZXN0J3MgYmFsbG9vbiBkcml2ZXIgY2Fubm90IGNy ZWF0ZSBmcmVlIGd1ZXN0IG1lbW9yeSBkdWUgdG8KK2d1ZXN0IG1lbW9yeSBwcmVzc3VyZQorCis9 aXRlbQogCi1TZXQgdGhlIGRvbWFpbidzIHVzZWQgbWVtb3J5IHVzaW5nIHRoZSBiYWxsb29uIGRy aXZlcjsgYXBwZW5kICd0JyBmb3IKLXRlcmFieXRlcywgJ2cnIGZvciBnaWdhYnl0ZXMsICdtJyBm b3IgbWVnYWJ5dGVzLCAnaycgZm9yIGtpbG9ieXRlcyBhbmQgJ2InIGZvcgotYnl0ZXMuCitUaGUg Z3Vlc3QncyBiYWxsb29uIGRyaXZlciBjYW5ub3QgYWxsb2NhdGUgbWVtb3J5IGZyb20gWGVuIGJl Y2F1c2Ugb2YKK2h5cGVydmlzb3IgbWVtb3J5IHByZXNzdXJlCiAKLUJlY2F1c2UgdGhpcyBvcGVy YXRpb24gcmVxdWlyZXMgY29vcGVyYXRpb24gZnJvbSB0aGUgZG9tYWluIG9wZXJhdGluZwotc3lz dGVtLCB0aGVyZSBpcyBubyBndWFyYW50ZWUgdGhhdCBpdCB3aWxsIHN1Y2NlZWQuICBUaGlzIGNv bW1hbmQgd2lsbAotZGVmaW5pdGVseSBub3Qgd29yayB1bmxlc3MgdGhlIGRvbWFpbiBoYXMgdGhl IHJlcXVpcmVkIHBhcmF2aXJ0Ci1kcml2ZXIuCis9aXRlbQorCitUaGUgZ3Vlc3QgYWRtaW5pc3Ry YXRvciBoYXMgZGlzYWJsZWQgdGhlIGJhbGxvb24gZHJpdmVyCisKKz1iYWNrCiAKIEI8V2Fybmlu Zzo+IFRoZXJlIGlzIG5vIGdvb2Qgd2F5IHRvIGtub3cgaW4gYWR2YW5jZSBob3cgc21hbGwgb2Yg YQogbWVtLXNldCB3aWxsIG1ha2UgYSBkb21haW4gdW5zdGFibGUgYW5kIGNhdXNlIGl0IHRvIGNy YXNoLiAgQmUgdmVyeQogY2FyZWZ1bCB3aGVuIHVzaW5nIHRoaXMgY29tbWFuZCBvbiBydW5uaW5n IGRvbWFpbnMuCiAKKz1pdGVtIEI8bWVtLW1heD4gSTxkb21haW4taWQ+IEk8bWVtPgorCitTcGVj aWZ5IHRoZSBsaW1pdCBYZW4gd2lsbCBwbGFjZSBvbiB0aGUgYW1vdW50IG9mIG1lbW9yeSBhIGd1 ZXN0IG1heQorYWxsb2NhdGUuIEFwcGVuZCAndCcgZm9yIHRlcmFieXRlcywgJ2cnIGZvciBnaWdh Ynl0ZXMsICdtJyBmb3IKK21lZ2FieXRlcywgJ2snIGZvciBraWxvYnl0ZXMgYW5kICdiJyBmb3Ig Ynl0ZXMuCisKK05CIHRoYXQgdXNlcnMgbm9ybWFsbHkgc2hvdWxkbid0IG5lZWQgdGhpcyBjb21t YW5kOyBCPHhsIG1lbS1zZXQ+IHdpbGwKK3NldCB0aGlzIGFzIGFwcHJvcHJpYXRlIGF1dG9tYXRp Y2FsbHkuCisKK0k8bWVtPiBjYW4ndCBiZSBzZXQgbG93ZXIgdGhhbiB0aGUgY3VycmVudCBtZW1v cnkgdGFyZ2V0IGZvcgorSTxkb21haW4taWQ+LiAgSXQgaXMgYWxsb3dlZCB0byBiZSBoaWdoZXIg dGhhbiB0aGUgY29uZmlndXJlZCBtYXhpbXVtCittZW1vcnkgc2l6ZSBvZiB0aGUgZG9tYWluIChC PG1heG1lbT4gcGFyYW1ldGVyIGluIHRoZSBkb21haW4ncworY29uZmlndXJhdGlvbikuIE5vdGUg aG93ZXZlciB0aGF0IHRoZSBpbml0aWFsIEI8bWF4bWVtPiB2YWx1ZSBpcyBzdGlsbAordXNlZCBh cyBhbiB1cHBlciBsaW1pdCBmb3IgQjx4bCBtZW0tc2V0Pi4gIEFsc28gbm90ZSB0aGF0IGNhbGxp bmcgQjx4bAorbWVtLXNldD4gd2lsbCByZXNldCB0aGlzIHZhbHVlLgorCitUaGUgZG9tYWluIHdp bGwgbm90IHJlY2VpdmUgYW55IHNpZ25hbCByZWdhcmRpbmcgdGhlIGNoYW5nZWQgbWVtb3J5Cits aW1pdC4KKwogPWl0ZW0gQjxtaWdyYXRlPiBbSTxPUFRJT05TPl0gSTxkb21haW4taWQ+IEk8aG9z dD4KIAogTWlncmF0ZSBhIGRvbWFpbiB0byBhbm90aGVyIGhvc3QgbWFjaGluZS4gQnkgZGVmYXVs dCBCPHhsPiByZWxpZXMgb24gc3NoIGFzIGEKLS0gCjIuMTguMAoKCl9fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fClhlbi1kZXZlbCBtYWlsaW5nIGxpc3QKWGVu LWRldmVsQGxpc3RzLnhlbnByb2plY3Qub3JnCmh0dHBzOi8vbGlzdHMueGVucHJvamVjdC5vcmcv bWFpbG1hbi9saXN0aW5mby94ZW4tZGV2ZWw=