Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oOKfh-0006ah-0i for pgsql-docs@arkaria.postgresql.org; Wed, 17 Aug 2022 15:09:29 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1oOKff-0004r8-RR for pgsql-docs@arkaria.postgresql.org; Wed, 17 Aug 2022 15:09:27 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oOKff-0004qY-Bx for pgsql-docs@lists.postgresql.org; Wed, 17 Aug 2022 15:09:27 +0000 Received: from mail.postgrespro.ru ([93.174.131.139]) by magus.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1oOKfc-0006PW-DJ for pgsql-docs@lists.postgresql.org; Wed, 17 Aug 2022 15:09:26 +0000 Received: from [192.168.28.47] (cyclops.postgrespro.ru [93.174.131.138]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client did not present a certificate) by mail.postgrespro.ru (Postfix) with ESMTPSA id 865FA21C1DD7 for ; Wed, 17 Aug 2022 18:09:22 +0300 (MSK) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=postgrespro.ru; s=mail; t=1660748962; bh=rAhpkV3JEdoeiatDoZxUwoE5lsn+gfxxk9TdW/jmLXw=; h=Date:To:From:Subject; b=ezvPAFkjKOvj8BxkGZafhvVU/gi4Ge6WfNzwjzvImfwRLseJwmgAvciRmcBjYX3aJ wg3J+vY+9LVPrX0xETaIc8IoKoQTtjf+VMFB1Kd9rbzypXo/CEL2gg2bgcnhv4Eqwm ih521MvtqfCqGjf3r85mq0tEAXuanCkaTWbZ5qyo= Content-Type: multipart/mixed; boundary="------------Cd2nNeuQ1RTRpBPl0OOWACPu" Message-ID: Date: Wed, 17 Aug 2022 18:09:13 +0300 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.11.0 To: pgsql-docs@lists.postgresql.org Content-Language: en-US From: =?UTF-8?B?0JzQsNC60YHQuNC8INCv0LHQu9C+0LrQvtCy?= Subject: PostgreSQL 15 minor documentation improvements Organization: Postgres Professional List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk This is a multi-part message in MIME format. --------------Cd2nNeuQ1RTRpBPl0OOWACPu Content-Type: multipart/alternative; boundary="------------oHVX8VxBPaVg5yCkAcy0mY99" --------------oHVX8VxBPaVg5yCkAcy0mY99 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Hello! I’ve noticed that some changes concerning replacement of archive_command by archive_library in the documentation for PostgreSQL 15 do not quite fit in: 1. https://www.postgresql.org/docs/15/continuous-archiving.html Archiving of these files happens automatically since you have already configured archive_library. - what about using archive_command? Should it be "...since you have already configured archive_library or archive_command"? 2. The same page. If the archive process has fallen behind because of failures of the archive library, it will keep retrying until the archive succeeds and the backup is complete. - again, what about archive command? 3. https://www.postgresql.org/docs/15/app-pgbasebackup.html All WAL records required for the backup must contain sufficient full-page writes, which requires you to enable |full_page_writes| on the primary and not to use a tool in your |archive_library| to remove full-page writes from WAL files. - the same question here. I believe that we can write in general: and not to use a tool to remove full-page writes from WAL files (?). I have prepared a small patch with possible changes of these places, and also a separate patch with some improvements concerning missed/inapt tags. Please have a look. -- Best regards, Maxim Yablokov Technical writer-translator Postgres Professional --------------oHVX8VxBPaVg5yCkAcy0mY99 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 8bit

Hello!

I’ve noticed that some changes concerning replacement of archive_command by archive_library in the documentation for PostgreSQL 15 do not quite fit in:

1. https://www.postgresql.org/docs/15/continuous-archiving.html
Archiving of these files happens automatically since you have already configured <varname>archive_library</varname>. - what about using archive_command? Should it be "...since you have already configured <varname>archive_library</varname> or <varname>archive_command</varname>"?

2. The same page.
If the archive process has fallen behind because of failures of the archive library, it will keep retrying until the archive succeeds and the backup is complete. - again, what about archive command?

3. https://www.postgresql.org/docs/15/app-pgbasebackup.html

All WAL records required for the backup must contain sufficient full-page writes, which requires you to enable full_page_writes on the primary and not to use a tool in your archive_library to remove full-page writes from WAL files. - the same question here. I believe that we can write in general: and not to use a tool to remove full-page writes from WAL files (?).

I have prepared a small patch with possible changes of these places, and also a separate patch with some improvements concerning missed/inapt tags. Please have a look.

--
Best regards,
Maxim Yablokov
Technical writer-translator
Postgres Professional
--------------oHVX8VxBPaVg5yCkAcy0mY99-- --------------Cd2nNeuQ1RTRpBPl0OOWACPu Content-Type: text/x-patch; charset=UTF-8; name="PGSQL15_archive_fix.patch" Content-Disposition: attachment; filename="PGSQL15_archive_fix.patch" Content-Transfer-Encoding: base64 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9iYWNrdXAuc2dtbCBiL2RvYy9zcmMvc2dtbC9i YWNrdXAuc2dtbAppbmRleCA3M2E3NzRkM2Q3Zi4uMmE2NGY2MDFmZmUgMTAwNjQ0Ci0tLSBh L2RvYy9zcmMvc2dtbC9iYWNrdXAuc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwvYmFja3VwLnNn bWwKQEAgLTk0NSwxMSArOTQ1LDExIEBAIFNFTEVDVCAqIEZST00gcGdfYmFja3VwX3N0b3Ao d2FpdF9mb3JfYXJjaGl2ZSA9PiB0cnVlKTsKICAgICAgT24gYSBzdGFuZGJ5LCA8dmFybmFt ZT5hcmNoaXZlX21vZGU8L3Zhcm5hbWU+IG11c3QgYmUgPGxpdGVyYWw+YWx3YXlzPC9saXRl cmFsPiBpbiBvcmRlcgogICAgICBmb3IgPGZ1bmN0aW9uPnBnX2JhY2t1cF9zdG9wPC9mdW5j dGlvbj4gdG8gd2FpdC4KICAgICAgQXJjaGl2aW5nIG9mIHRoZXNlIGZpbGVzIGhhcHBlbnMg YXV0b21hdGljYWxseSBzaW5jZSB5b3UgaGF2ZQotICAgICBhbHJlYWR5IGNvbmZpZ3VyZWQg PHZhcm5hbWU+YXJjaGl2ZV9saWJyYXJ5PC92YXJuYW1lPi4gSW4gbW9zdCBjYXNlcyB0aGlz Ci0gICAgIGhhcHBlbnMgcXVpY2tseSwgYnV0IHlvdSBhcmUgYWR2aXNlZCB0byBtb25pdG9y IHlvdXIgYXJjaGl2ZQorICAgICBhbHJlYWR5IGNvbmZpZ3VyZWQgPHZhcm5hbWU+YXJjaGl2 ZV9saWJyYXJ5PC92YXJuYW1lPiBvciA8dmFybmFtZT5hcmNoaXZlX2NvbW1hbmQ8L3Zhcm5h bWU+LgorICAgICBJbiBtb3N0IGNhc2VzIHRoaXMgaGFwcGVucyBxdWlja2x5LCBidXQgeW91 IGFyZSBhZHZpc2VkIHRvIG1vbml0b3IgeW91ciBhcmNoaXZlCiAgICAgIHN5c3RlbSB0byBl bnN1cmUgdGhlcmUgYXJlIG5vIGRlbGF5cy4KLSAgICAgSWYgdGhlIGFyY2hpdmUgcHJvY2Vz cyBoYXMgZmFsbGVuIGJlaGluZAotICAgICBiZWNhdXNlIG9mIGZhaWx1cmVzIG9mIHRoZSBh cmNoaXZlIGxpYnJhcnksIGl0IHdpbGwga2VlcCByZXRyeWluZworICAgICBJZiB0aGUgYXJj aGl2ZSBwcm9jZXNzIGhhcyBmYWxsZW4gYmVoaW5kIGJlY2F1c2Ugb2YgZmFpbHVyZXMgb2Yg dGhlIGFyY2hpdmUgbGlicmFyeSBvcgorICAgICBhcmNoaXZlIGNvbW1hbmQsIGl0IHdpbGwg a2VlcCByZXRyeWluZwogICAgICB1bnRpbCB0aGUgYXJjaGl2ZSBzdWNjZWVkcyBhbmQgdGhl IGJhY2t1cCBpcyBjb21wbGV0ZS4KICAgICAgSWYgeW91IHdpc2ggdG8gcGxhY2UgYSB0aW1l IGxpbWl0IG9uIHRoZSBleGVjdXRpb24gb2YKICAgICAgPGZ1bmN0aW9uPnBnX2JhY2t1cF9z dG9wPC9mdW5jdGlvbj4sIHNldCBhbiBhcHByb3ByaWF0ZQpkaWZmIC0tZ2l0IGEvZG9jL3Ny Yy9zZ21sL3JlZi9wZ19iYXNlYmFja3VwLnNnbWwgYi9kb2Mvc3JjL3NnbWwvcmVmL3BnX2Jh c2ViYWNrdXAuc2dtbAppbmRleCA1NmFjN2I3NTRiZS4uYjBhMThjNmQ0ODkgMTAwNjQ0Ci0t LSBhL2RvYy9zcmMvc2dtbC9yZWYvcGdfYmFzZWJhY2t1cC5zZ21sCisrKyBiL2RvYy9zcmMv c2dtbC9yZWYvcGdfYmFzZWJhY2t1cC5zZ21sCkBAIC0xMDIsOCArMTAyLDcgQEAgUG9zdGdy ZVNRTCBkb2N1bWVudGF0aW9uCiAgICAgIDxwYXJhPgogICAgICAgQWxsIFdBTCByZWNvcmRz IHJlcXVpcmVkIGZvciB0aGUgYmFja3VwIG11c3QgY29udGFpbiBzdWZmaWNpZW50IGZ1bGwt cGFnZSB3cml0ZXMsCiAgICAgICB3aGljaCByZXF1aXJlcyB5b3UgdG8gZW5hYmxlIDx2YXJu YW1lPmZ1bGxfcGFnZV93cml0ZXM8L3Zhcm5hbWU+IG9uIHRoZSBwcmltYXJ5IGFuZAotICAg ICAgbm90IHRvIHVzZSBhIHRvb2wgaW4geW91ciA8dmFybmFtZT5hcmNoaXZlX2xpYnJhcnk8 L3Zhcm5hbWU+IHRvIHJlbW92ZQotICAgICAgZnVsbC1wYWdlIHdyaXRlcyBmcm9tIFdBTCBm aWxlcy4KKyAgICAgIG5vdCB0byB1c2UgYSB0b29sIHRvIHJlbW92ZSBmdWxsLXBhZ2Ugd3Jp dGVzIGZyb20gV0FMIGZpbGVzLgogICAgICA8L3BhcmE+CiAgICAgPC9saXN0aXRlbT4KICAg IDwvaXRlbWl6ZWRsaXN0Pgo= --------------Cd2nNeuQ1RTRpBPl0OOWACPu Content-Type: text/x-patch; charset=UTF-8; name="PGSQL15_tags_fix.patch" Content-Disposition: attachment; filename="PGSQL15_tags_fix.patch" Content-Transfer-Encoding: base64 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9hZG1pbnBhY2suc2dtbCBiL2RvYy9zcmMvc2dt bC9hZG1pbnBhY2suc2dtbAppbmRleCA0MGNhYjI5YjI0Ny4uMjhhY2U1NzRkZDUgMTAwNjQ0 Ci0tLSBhL2RvYy9zcmMvc2dtbC9hZG1pbnBhY2suc2dtbAorKysgYi9kb2Mvc3JjL3NnbWwv YWRtaW5wYWNrLnNnbWwKQEAgLTIyLDggKzIyLDkgQEAKICAgZnVuY3Rpb25zIGluIDx4cmVm IGxpbmtlbmQ9ImZ1bmN0aW9ucy1hZG1pbi1nZW5maWxlLXRhYmxlIi8+LCB3aGljaAogICBw cm92aWRlIHJlYWQtb25seSBhY2Nlc3MuKQogICBPbmx5IGZpbGVzIHdpdGhpbiB0aGUgZGF0 YWJhc2UgY2x1c3RlciBkaXJlY3RvcnkgY2FuIGJlIGFjY2Vzc2VkLCB1bmxlc3MgdGhlCi0g IHVzZXIgaXMgYSBzdXBlcnVzZXIgb3IgZ2l2ZW4gcHJpdmlsZWdlcyBvZiBvbmUgb2YgdGhl IHBnX3JlYWRfc2VydmVyX2ZpbGVzLAotICBvciBwZ193cml0ZV9zZXJ2ZXJfZmlsZXMgcm9s ZXMsIGFzIGFwcHJvcHJpYXRlIGZvciB0aGUgZnVuY3Rpb24sIGJ1dCBlaXRoZXIgYQorICB1 c2VyIGlzIGEgc3VwZXJ1c2VyIG9yIGdpdmVuIHByaXZpbGVnZXMgb2Ygb25lIG9mIHRoZQor ICA8bGl0ZXJhbD5wZ19yZWFkX3NlcnZlcl9maWxlczwvbGl0ZXJhbD4gb3IgPGxpdGVyYWw+ cGdfd3JpdGVfc2VydmVyX2ZpbGVzPC9saXRlcmFsPgorICByb2xlcywgYXMgYXBwcm9wcmlh dGUgZm9yIHRoZSBmdW5jdGlvbiwgYnV0IGVpdGhlciBhCiAgIHJlbGF0aXZlIG9yIGFic29s dXRlIHBhdGggaXMgYWxsb3dhYmxlLgogIDwvcGFyYT4KIApkaWZmIC0tZ2l0IGEvZG9jL3Ny Yy9zZ21sL2FyY2hpdmUtbW9kdWxlcy5zZ21sIGIvZG9jL3NyYy9zZ21sL2FyY2hpdmUtbW9k dWxlcy5zZ21sCmluZGV4IGVlNzBlOTIyNDkwLi4zN2IxZmMwNjFlZCAxMDA2NDQKLS0tIGEv ZG9jL3NyYy9zZ21sL2FyY2hpdmUtbW9kdWxlcy5zZ21sCisrKyBiL2RvYy9zcmMvc2dtbC9h cmNoaXZlLW1vZHVsZXMuc2dtbApAQCAtMTEyLDggKzExMiw4IEBAIHR5cGVkZWYgYm9vbCAo KkFyY2hpdmVGaWxlQ0IpIChjb25zdCBjaGFyICpmaWxlLCBjb25zdCBjaGFyICpwYXRoKTsK ICAgICB3YXMgc3VjY2Vzc2Z1bGx5IGFyY2hpdmVkLCB3aGljaCBtYXkgaW5jbHVkZSByZWN5 Y2xpbmcgb3IgcmVtb3ZpbmcgdGhlCiAgICAgb3JpZ2luYWwgV0FMIGZpbGUuICBJZiA8bGl0 ZXJhbD5mYWxzZTwvbGl0ZXJhbD4gaXMgcmV0dXJuZWQsIHRoZSBzZXJ2ZXIgd2lsbAogICAg IGtlZXAgdGhlIG9yaWdpbmFsIFdBTCBmaWxlIGFuZCByZXRyeSBhcmNoaXZpbmcgbGF0ZXIu Ci0gICAgPGxpdGVyYWw+ZmlsZTwvbGl0ZXJhbD4gd2lsbCBjb250YWluIGp1c3QgdGhlIGZp bGUgbmFtZSBvZiB0aGUgV0FMIGZpbGUgdG8KLSAgICBhcmNoaXZlLCB3aGlsZSA8bGl0ZXJh bD5wYXRoPC9saXRlcmFsPiBjb250YWlucyB0aGUgZnVsbCBwYXRoIG9mIHRoZSBXQUwKKyAg ICA8cmVwbGFjZWFibGU+ZmlsZTwvcmVwbGFjZWFibGU+IHdpbGwgY29udGFpbiBqdXN0IHRo ZSBmaWxlIG5hbWUgb2YgdGhlIFdBTCBmaWxlIHRvCisgICAgYXJjaGl2ZSwgd2hpbGUgPHJl cGxhY2VhYmxlPnBhdGg8L3JlcGxhY2VhYmxlPiBjb250YWlucyB0aGUgZnVsbCBwYXRoIG9m IHRoZSBXQUwKICAgICBmaWxlIChpbmNsdWRpbmcgdGhlIGZpbGUgbmFtZSkuCiAgICA8L3Bh cmE+CiAgIDwvc2VjdDI+CmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvYmFja3VwLnNnbWwg Yi9kb2Mvc3JjL3NnbWwvYmFja3VwLnNnbWwKaW5kZXggNzNhNzc0ZDNkN2YuLjRlYWI2NDEx YTRlIDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvYmFja3VwLnNnbWwKKysrIGIvZG9jL3Ny Yy9zZ21sL2JhY2t1cC5zZ21sCkBAIC02NjgsOSArNjY4LDEwIEBAIHRlc3QgISAtZiAvbW50 L3NlcnZlci9hcmNoaXZlZGlyLzAwMDAwMDAxMDAwMDAwQTkwMDAwMDA2NSAmYW1wOyZhbXA7 IGNwIHBnX3dhbC8wCiAgICA8cGFyYT4KICAgICBJZiB0aGUgYXJjaGl2ZSBmdW5jdGlvbiBl bWl0cyBhbiA8bGl0ZXJhbD5FUlJPUjwvbGl0ZXJhbD4gb3IKICAgICA8bGl0ZXJhbD5GQVRB TDwvbGl0ZXJhbD4sIHRoZSBhcmNoaXZlciBwcm9jZXNzIGFib3J0cyBhbmQgZ2V0cyByZXN0 YXJ0ZWQgYnkKLSAgICB0aGUgcG9zdG1hc3Rlci4gIElmIHlvdSBhcmUgYXJjaGl2aW5nIHZp YSBzaGVsbCBjb21tYW5kLCBGQVRBTCBpcyBlbWl0dGVkIGlmCi0gICAgdGhlIGNvbW1hbmQg aXMgdGVybWluYXRlZCBieSBhIHNpZ25hbCAob3RoZXIgdGhhbgotICAgIDxzeXN0ZW1pdGVt PlNJR1RFUk08L3N5c3RlbWl0ZW0+IHRoYXQgaXMgdXNlZCBhcyBwYXJ0IG9mIGEgc2VydmVy IHNodXRkb3duKQorICAgIHRoZSBwb3N0bWFzdGVyLiAgSWYgeW91IGFyZSBhcmNoaXZpbmcg dmlhIHNoZWxsIGNvbW1hbmQsCisgICAgPGxpdGVyYWw+RkFUQUw8L2xpdGVyYWw+IGlzIGVt aXR0ZWQgaWYgdGhlIGNvbW1hbmQgaXMgdGVybWluYXRlZCBieSBhIHNpZ25hbAorICAgIChv dGhlciB0aGFuIDxzeXN0ZW1pdGVtPlNJR1RFUk08L3N5c3RlbWl0ZW0+CisgICAgdGhhdCBp cyB1c2VkIGFzIHBhcnQgb2YgYSBzZXJ2ZXIgc2h1dGRvd24pCiAgICAgb3IgYW4gZXJyb3Ig YnkgdGhlIHNoZWxsIHdpdGggYW4gZXhpdCBzdGF0dXMgZ3JlYXRlciB0aGFuIDEyNSAoc3Vj aCBhcwogICAgIGNvbW1hbmQgbm90IGZvdW5kKS4gIEluIHN1Y2ggY2FzZXMsIHRoZSBmYWls dXJlIGlzIG5vdCByZXBvcnRlZCBpbgogICAgIDx4cmVmIGxpbmtlbmQ9InBnLXN0YXQtYXJj aGl2ZXItdmlldyIvPi4KQEAgLTg3Miw4ICs4NzMsOCBAQCB0ZXN0ICEgLWYgL21udC9zZXJ2 ZXIvYXJjaGl2ZWRpci8wMDAwMDAwMTAwMDAwMEE5MDAwMDAwNjUgJmFtcDsmYW1wOyBjcCBw Z193YWwvMAogICAgPGxpc3RpdGVtPgogICAgIDxwYXJhPgogICAgICBDb25uZWN0IHRvIHRo ZSBzZXJ2ZXIgKGl0IGRvZXMgbm90IG1hdHRlciB3aGljaCBkYXRhYmFzZSkgYXMgYSB1c2Vy IHdpdGgKLSAgICAgcmlnaHRzIHRvIHJ1biBwZ19iYWNrdXBfc3RhcnQgKHN1cGVydXNlciwg b3IgYSB1c2VyIHdobyBoYXMgYmVlbiBncmFudGVkCi0gICAgIEVYRUNVVEUgb24gdGhlIGZ1 bmN0aW9uKSBhbmQgaXNzdWUgdGhlIGNvbW1hbmQ6CisgICAgIHJpZ2h0cyB0byBydW4gPGZ1 bmN0aW9uPnBnX2JhY2t1cF9zdGFydDwvZnVuY3Rpb24+IChzdXBlcnVzZXIsCisgICAgIG9y IGEgdXNlciB3aG8gaGFzIGJlZW4gZ3JhbnRlZCBFWEVDVVRFIG9uIHRoZSBmdW5jdGlvbikg YW5kIGlzc3VlIHRoZSBjb21tYW5kOgogPHByb2dyYW1saXN0aW5nPgogU0VMRUNUIHBnX2Jh Y2t1cF9zdGFydChsYWJlbCA9PiAnbGFiZWwnLCBmYXN0ID0+IGZhbHNlKTsKIDwvcHJvZ3Jh bWxpc3Rpbmc+CmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvYmFzZWJhY2t1cC10by1zaGVs bC5zZ21sIGIvZG9jL3NyYy9zZ21sL2Jhc2ViYWNrdXAtdG8tc2hlbGwuc2dtbAppbmRleCA4 NTg2OGRiM2MxNS4uM2Q1NDk2ZjY5MmYgMTAwNjQ0Ci0tLSBhL2RvYy9zcmMvc2dtbC9iYXNl YmFja3VwLXRvLXNoZWxsLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL2Jhc2ViYWNrdXAtdG8t c2hlbGwuc2dtbApAQCAtMTIsOSArMTIsOSBAQAogICBjYWxsZWQgPGxpdGVyYWw+c2hlbGw8 L2xpdGVyYWw+LiBUaGlzIG1ha2VzIGl0IHBvc3NpYmxlIHRvIHJ1bgogICA8bGl0ZXJhbD5w Z19iYXNlYmFja3VwIC0tdGFyZ2V0PXNoZWxsPC9saXRlcmFsPiBvciwgZGVwZW5kaW5nIG9u IGhvdyB0aGlzCiAgIG1vZHVsZSBpcyBjb25maWd1cmVkLAotICA8bGl0ZXJhbD5wZ19iYXNl YmFja3VwIC0tdGFyZ2V0PXNoZWxsOkRFVEFJTF9TVFJJTkc8L2xpdGVyYWw+LCBhbmQgY2F1 c2UKLSAgYSBzZXJ2ZXIgY29tbWFuZCBjaG9zZW4gYnkgdGhlIHNlcnZlciBhZG1pbmlzdHJh dG9yIHRvIGJlIGV4ZWN1dGVkIGZvcgotICBlYWNoIHRhciBhcmNoaXZlIGdlbmVyYXRlZCBi eSB0aGUgYmFja3VwIHByb2Nlc3MuIFRoZSBjb21tYW5kIHdpbGwgcmVjZWl2ZQorICA8bGl0 ZXJhbD5wZ19iYXNlYmFja3VwIC0tdGFyZ2V0PXNoZWxsOjxyZXBsYWNlYWJsZT5ERVRBSUxf U1RSSU5HPHJlcGxhY2VhYmxlPjwvbGl0ZXJhbD4sCisgIGFuZCBjYXVzZSBhIHNlcnZlciBj b21tYW5kIGNob3NlbiBieSB0aGUgc2VydmVyIGFkbWluaXN0cmF0b3IgdG8gYmUgZXhlY3V0 ZWQKKyAgZm9yIGVhY2ggdGFyIGFyY2hpdmUgZ2VuZXJhdGVkIGJ5IHRoZSBiYWNrdXAgcHJv Y2Vzcy4gVGhlIGNvbW1hbmQgd2lsbCByZWNlaXZlCiAgIHRoZSBjb250ZW50cyBvZiB0aGUg YXJjaGl2ZSB2aWEgc3RhbmRhcmQgaW5wdXQuCiAgPC9wYXJhPgogCmRpZmYgLS1naXQgYS9k b2Mvc3JjL3NnbWwvcmVmL2FsdGVyX3B1YmxpY2F0aW9uLnNnbWwgYi9kb2Mvc3JjL3NnbWwv cmVmL2FsdGVyX3B1YmxpY2F0aW9uLnNnbWwKaW5kZXggM2UzMzhmNGNjNWQuLjNhNzQ5NzNk YTAxIDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvcmVmL2FsdGVyX3B1YmxpY2F0aW9uLnNn bWwKKysrIGIvZG9jL3NyYy9zZ21sL3JlZi9hbHRlcl9wdWJsaWNhdGlvbi5zZ21sCkBAIC0x MjEsNyArMTIxLDcgQEAgQUxURVIgUFVCTElDQVRJT04gPHJlcGxhY2VhYmxlIGNsYXNzPSJw YXJhbWV0ZXIiPm5hbWU8L3JlcGxhY2VhYmxlPiBSRU5BTUUgVE8gPHIKICAgICAgIHdpdGgg ZGlmZmVyZW50IGNvbHVtbiBsaXN0cyBpcyBub3Qgc3VwcG9ydGVkLiBTbywgY2hhbmdpbmcg dGhlIGNvbHVtbgogICAgICAgbGlzdHMgb2YgdGhlIHRhYmxlcyBiZWluZyBzdWJzY3JpYmVk IGNvdWxkIGNhdXNlIGluY29uc2lzdGVuY3kgb2YgY29sdW1uCiAgICAgICBsaXN0cyBhbW9u ZyBwdWJsaWNhdGlvbnMsIGluIHdoaWNoIGNhc2UgPGNvbW1hbmQ+QUxURVIgUFVCTElDQVRJ T048L2NvbW1hbmQ+Ci0gICAgICB3aWxsIGJlIHN1Y2Nlc3NmdWwgYnV0IGxhdGVyIHRoZSBX YWxTZW5kZXIgb24gdGhlIHB1Ymxpc2hlciBvciB0aGUKKyAgICAgIHdpbGwgYmUgc3VjY2Vz c2Z1bCBidXQgbGF0ZXIgdGhlIHdhbHNlbmRlciBvbiB0aGUgcHVibGlzaGVyIG9yIHRoZQog ICAgICAgc3Vic2NyaWJlciBtYXkgdGhyb3cgYW4gZXJyb3IuIEluIHRoaXMgc2NlbmFyaW8s IHRoZSB1c2VyIG5lZWRzIHRvCiAgICAgICByZWNyZWF0ZSB0aGUgc3Vic2NyaXB0aW9uIGFm dGVyIGFkanVzdGluZyB0aGUgY29sdW1uIGxpc3Qgb3IgZHJvcCB0aGUKICAgICAgIHByb2Js ZW1hdGljIHB1YmxpY2F0aW9uIHVzaW5nCmRpZmYgLS1naXQgYS9kb2Mvc3JjL3NnbWwvcmVm L3BzcWwtcmVmLnNnbWwgYi9kb2Mvc3JjL3NnbWwvcmVmL3BzcWwtcmVmLnNnbWwKaW5kZXgg NjViYjBhNmEzZjMuLjAyZmRiMTJkYzc3IDEwMDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvcmVm L3BzcWwtcmVmLnNnbWwKKysrIGIvZG9jL3NyYy9zZ21sL3JlZi9wc3FsLXJlZi5zZ21sCkBA IC00NjI1LDEwICs0NjI1LDEwIEBAIHRlc3RkYj0mZ3Q7IFxzZXQgUFJPTVBUMSAnJVslMDMz WzE7MzM7NDBtJV0lbkAlLyVSJVslMDMzWzBtJV0lIyAnCiAgICAgYW5kIFNRTCBvYmplY3Qg bmFtZXMgaW4gbWFueSAoYnkgbm8gbWVhbnMgYWxsKSBjb250ZXh0cy4gIEZvciBleGFtcGxl LAogICAgIGF0IHRoZSBzdGFydCBvZiBhIGNvbW1hbmQsIHR5cGluZyA8bGl0ZXJhbD5pbnM8 L2xpdGVyYWw+IGFuZCBwcmVzc2luZwogICAgIFRBQiB3aWxsIGZpbGwgaW4gPGxpdGVyYWw+ aW5zZXJ0IGludG8gPC9saXRlcmFsPi4gIFRoZW4sIHR5cGluZyBhIGZldwotICAgIGNoYXJh Y3RlcnMgb2YgYSB0YWJsZSBvciBzY2hlbWEgbmFtZSBhbmQgcHJlc3NpbmcgVEFCIHdpbGwg ZmlsbCBpbiB0aGUKLSAgICB1bmZpbmlzaGVkIG5hbWUsIG9yIG9mZmVyIGEgbWVudSBvZiBw b3NzaWJsZSBjb21wbGV0aW9ucyB3aGVuIHRoZXJlJ3MKLSAgICBtb3JlIHRoYW4gb25lLiAg KERlcGVuZGluZyBvbiB0aGUgbGlicmFyeSBpbiB1c2UsIHlvdSBtYXkgbmVlZCB0bwotICAg IHByZXNzIFRBQiBtb3JlIHRoYW4gb25jZSB0byBnZXQgYSBtZW51LikKKyAgICBjaGFyYWN0 ZXJzIG9mIGEgdGFibGUgb3Igc2NoZW1hIG5hbWUgYW5kIHByZXNzaW5nIDxsaXRlcmFsPlRB QjwvbGl0ZXJhbD4KKyAgICB3aWxsIGZpbGwgaW4gdGhlIHVuZmluaXNoZWQgbmFtZSwgb3Ig b2ZmZXIgYSBtZW51IG9mIHBvc3NpYmxlIGNvbXBsZXRpb25zCisgICAgd2hlbiB0aGVyZSdz IG1vcmUgdGhhbiBvbmUuICAoRGVwZW5kaW5nIG9uIHRoZSBsaWJyYXJ5IGluIHVzZSwgeW91 IG1heSBuZWVkIHRvCisgICAgcHJlc3MgPGxpdGVyYUw+VEFCPC9saXRlcmFsPiBtb3JlIHRo YW4gb25jZSB0byBnZXQgYSBtZW51LikKICAgICA8L3BhcmE+CiAKICAgICA8cGFyYT4KQEAg LTQ2NTcsNyArNDY1Nyw3IEBAICRlbmRpZgogICAgICBvZiA8YXBwbGljYXRpb24+cHNxbDwv YXBwbGljYXRpb24+LiAgVGhpcyBwcmV2ZW50cyB0YWIgY29tcGxldGlvbiwKICAgICAgdXNl IG9yIHJlY29yZGluZyBvZiBjb21tYW5kIGxpbmUgaGlzdG9yeSwgYW5kIGVkaXRpbmcgb2Yg bXVsdGktbGluZQogICAgICBjb21tYW5kcy4gIEl0IGlzIHBhcnRpY3VsYXJseSB1c2VmdWwg d2hlbiB5b3UgbmVlZCB0byBjb3B5LWFuZC1wYXN0ZQotICAgICB0ZXh0IHRoYXQgY29udGFp bnMgVEFCIGNoYXJhY3RlcnMuCisgICAgIHRleHQgdGhhdCBjb250YWlucyA8bGl0ZXJhbD5U QUI8L2xpdGVyYWw+IGNoYXJhY3RlcnMuCiAgICAgPC9wYXJhPgogICAgPC9yZWZzZWN0Mz4K ICAgPC9yZWZzZWN0Mj4K --------------Cd2nNeuQ1RTRpBPl0OOWACPu--