Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.80) (envelope-from ) id 1WtePa-0002Rk-2T for pgsql-docs@arkaria.postgresql.org; Sun, 08 Jun 2014 14:49:30 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.80) (envelope-from ) id 1WtePZ-0007vh-DZ for pgsql-docs@arkaria.postgresql.org; Sun, 08 Jun 2014 14:49:29 +0000 Received: from makus.postgresql.org ([2001:4800:1501:1::229]) by malur.postgresql.org with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.80) (envelope-from ) id 1WtePX-0007va-Nb for pgsql-docs@postgresql.org; Sun, 08 Jun 2014 14:49:28 +0000 Received: from mail-wi0-x22d.google.com ([2a00:1450:400c:c05::22d]) by makus.postgresql.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.80) (envelope-from ) id 1WtePS-0004r3-Tp for pgsql-docs@postgresql.org; Sun, 08 Jun 2014 14:49:25 +0000 Received: by mail-wi0-f173.google.com with SMTP id bs8so3080559wib.12 for ; Sun, 08 Jun 2014 07:49:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=YstOk/RZb989sW1PCyXL84oBJF0e/7nR836EOK4vOGE=; b=P1BT1pWtLZRP/49xi/iJAG2R50L2B0HV7gl//C2j2i83fW8gD3vkgJplSmsSN9pMa4 BDphOcjDv6AdqvhN9juwPXC9OHFs+ftd/3tMslbufDYbLv7k5CISj+bBz2tvsGRye9Pf 7hzxe7aCEQH71worm8EHA0/MLSO1XNZVf0GEJsJoX3sQhzMTcOXGLbG5urbswYC7PyEr qDvhMOiTND4uzz10o0qtBa8gr/lKe8zLIyc8rLbeKDzB9doAy+sQW2P5jAKqxu30Xj/L Z7zJvGSGhIgL5FbiPBeEGR+Q1AdT683ad8ogWNvaGhsFFjrhfjMfy4jlsxQhrrEZnGVI pVdQ== MIME-Version: 1.0 X-Received: by 10.180.11.9 with SMTP id m9mr12751413wib.51.1402238960008; Sun, 08 Jun 2014 07:49:20 -0700 (PDT) Received: by 10.217.1.145 with HTTP; Sun, 8 Jun 2014 07:49:19 -0700 (PDT) In-Reply-To: References: <1400698826956-5804655.post@n5.nabble.com> <2916.1400704666@sss.pgh.pa.us> Date: Sun, 8 Jun 2014 10:49:19 -0400 Message-ID: Subject: Re: [9.3] Should we mention "set_config(...)" in 18.1.3 in Server Configuration? From: David Johnston To: pgsql-docs@postgresql.org Content-Type: multipart/mixed; boundary=001a11c258dc1b1a4e04fb543303 X-Pg-Spam-Score: -2.0 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org --001a11c258dc1b1a4e04fb543303 Content-Type: multipart/alternative; boundary=001a11c258dc1b1a4a04fb543301 --001a11c258dc1b1a4a04fb543301 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable =E2=80=8BRe-sending to hopefully avoid admin moderation rule.=E2=80=8B Fix= ing top-post as well. On Wed, May 21, 2014 at 4:37 PM, Tom Lane wrote: > >> David G Johnston writes: >> > Section 18.1.3 is named "18.1.3. Other Ways to Set Parameters" yet does >> not >> > reference the ability to use "set_config(...)" to make changes to >> > configuration parameters. >> >> Hm, yeah, seems like an oversight. >> >> Another thing I've never been terribly happy about is that pg_settings is >> mentioned only in the next sub-section. Could we merge that sub-section >> with 18.1.3? >> >> regards, tom lane >> > > =E2=80=8B=E2=80=8B > I am presuming that posting a doc-only patch here instead of -hackers is > acceptable. > > So I finally decided to setup a development environment and generate > actual patches. I have few in mind but I thought that these two changes > might be quick to implement. I thought wrong - mostly due to my desire to > improve things and not just "add and merge" some content. > > I focused my effort on 18.1.1 to 18.1.4 though the actual coverage of > sections 2-4 has changed considerably. I decided not to minimize > white-space changes in that region since because of the re-organization g= it > was unable, especially in a couple of instances, to match up before and > after anyway. The file itself does not have a consistent format and so I > just applied 2-space indentations at each level. I plan to go back and do > polishing but I first want to make sure that the end-user product is > acceptable. > > I've only hit this one file for the moment but figure on reviewing all of > the relevant cross-references for tweaks and consistency. I already did = so > in passing and would not expect anything as invasive as what I am proposi= ng > here - so if others feel these changes have merit I will plan on taking a= ny > ideas and put forth a v2 patch that will hopefully be ready-to-commit. > > Thank you in advance for any attention and education you can provide. > > David J. > =E2=80=8B --001a11c258dc1b1a4a04fb543301 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
=E2=80=8BRe-sending to hopefully avoid admin moderation rule.=E2=80=8B = =C2=A0Fixing top-post as well.


On Wed, May 21, 2014 at 4:37 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
David G Johnston <david.g.johnston@gmail.com> writes:
> Section 18.1.3 is named "18.1.3. Other Ways to Set Parameters&quo= t; yet does not
> reference the ability to use "set_config(...)" to make chang= es to
> configuration parameters.

Hm, yeah, seems like an oversight.

Another thing I've never been terribly happy about is that pg_settings = is
mentioned only in the next sub-section. =C2=A0Could we merge that sub-secti= on
with 18.1.3?

=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2= =A0 =C2=A0 regards, tom lane

=E2=80=8B=E2=80=8B=
I am= presuming that posting a doc-only patch here instead of -hackers is accept= able.

So I finally decided = to setup a development environment and generate actual patches. =C2=A0I hav= e few in mind but I thought that these two changes might be quick to implem= ent. =C2=A0I thought wrong - mostly due to my desire to improve things and = not just "add and merge" some content.

I focused my effort on 18.1.1 t= o 18.1.4 though the actual coverage of sections 2-4 has changed considerabl= y. =C2=A0I decided not to minimize white-space changes in that region since= because of the re-organization git was unable, especially in a couple of i= nstances, to match up before and after anyway. =C2=A0The file itself does n= ot have a consistent format and so I just applied 2-space indentations at e= ach level. =C2=A0I plan to go back and do polishing but I first want to mak= e sure that the end-user product is acceptable.

I've only hit this one file= for the moment but figure on reviewing all of the relevant cross-reference= s for tweaks and consistency. =C2=A0I already did so in passing and would n= ot expect anything as invasive as what I am proposing here - so if others f= eel these changes have merit I will plan on taking any ideas and put forth = a v2 patch that will hopefully be ready-to-commit.

Thank you in advance for any at= tention and education you can provide.

David J.
=E2= =80=8B

--001a11c258dc1b1a4a04fb543301-- --001a11c258dc1b1a4e04fb543303 Content-Type: text/plain; charset=US-ASCII; name="config_sgml_18_1_1-4_v1.diff" Content-Disposition: attachment; filename="config_sgml_18_1_1-4_v1.diff" Content-Transfer-Encoding: base64 X-Attachment-Id: f_hw6gv94k1 ZGlmZiAtLWdpdCBhL2RvYy9zcmMvc2dtbC9jb25maWcuc2dtbCBiL2RvYy9z cmMvc2dtbC9jb25maWcuc2dtbAppbmRleCA2OTdjZjk5Li42YWM0OGQ2IDEw MDY0NAotLS0gYS9kb2Mvc3JjL3NnbWwvY29uZmlnLnNnbWwKKysrIGIvZG9j L3NyYy9zZ21sL2NvbmZpZy5zZ21sCkBAIC0xMSw3ICsxMSw3IEBACiAgIDxw YXJhPgogICAgVGhlcmUgYXJlIG1hbnkgY29uZmlndXJhdGlvbiBwYXJhbWV0 ZXJzIHRoYXQgYWZmZWN0IHRoZSBiZWhhdmlvciBvZgogICAgdGhlIGRhdGFi YXNlIHN5c3RlbS4gSW4gdGhlIGZpcnN0IHNlY3Rpb24gb2YgdGhpcyBjaGFw dGVyLCB3ZQotICAgZGVzY3JpYmUgaG93IHRvIHNldCBjb25maWd1cmF0aW9u IHBhcmFtZXRlcnMuIFRoZSBzdWJzZXF1ZW50IHNlY3Rpb25zCisgICBkZXNj cmliZSBob3cgdG8gaW50ZXJhY3Qgd2l0aCBjb25maWd1cmF0aW9uIHBhcmFt ZXRlcnMuIFRoZSBzdWJzZXF1ZW50IHNlY3Rpb25zCiAgICBkaXNjdXNzIGVh Y2ggcGFyYW1ldGVyIGluIGRldGFpbC4KICAgPC9wYXJhPgogCkBAIC0yNCw0 NiArMjQsMTAzIEBACiAgICAgPHBhcmE+CiAgICAgIEFsbCBwYXJhbWV0ZXIg bmFtZXMgYXJlIGNhc2UtaW5zZW5zaXRpdmUuIEV2ZXJ5IHBhcmFtZXRlciB0 YWtlcyBhCiAgICAgIHZhbHVlIG9mIG9uZSBvZiBmaXZlIHR5cGVzOiBCb29s ZWFuLCBpbnRlZ2VyLCBmbG9hdGluZyBwb2ludCwKLSAgICAgc3RyaW5nIG9y IGVudW0uIEJvb2xlYW4gdmFsdWVzIGNhbiBiZSB3cml0dGVuIGFzIDxsaXRl cmFsPm9uPC9saXRlcmFsPiwKLSAgICAgPGxpdGVyYWw+b2ZmPC9saXRlcmFs PiwgPGxpdGVyYWw+dHJ1ZTwvbGl0ZXJhbD4sCi0gICAgIDxsaXRlcmFsPmZh bHNlPC9saXRlcmFsPiwgPGxpdGVyYWw+eWVzPC9saXRlcmFsPiwKLSAgICAg PGxpdGVyYWw+bm88L2xpdGVyYWw+LCA8bGl0ZXJhbD4xPC9saXRlcmFsPiwg PGxpdGVyYWw+MDwvbGl0ZXJhbD4KLSAgICAgKGFsbCBjYXNlLWluc2Vuc2l0 aXZlKSBvciBhbnkgdW5hbWJpZ3VvdXMgcHJlZml4IG9mIHRoZXNlLgorICAg ICBzdHJpbmcgb3IgZW51bS4KICAgICA8L3BhcmE+CiAKKyAgICA8aXRlbWl6 ZWRsaXN0PgorCisgICAgPGxpc3RpdGVtPgogICAgIDxwYXJhPgotICAgICBT b21lIHNldHRpbmdzIHNwZWNpZnkgYSBtZW1vcnkgb3IgdGltZSB2YWx1ZS4g IEVhY2ggb2YgdGhlc2UgaGFzIGFuCi0gICAgIGltcGxpY2l0IHVuaXQsIHdo aWNoIGlzIGVpdGhlciBraWxvYnl0ZXMsIGJsb2NrcyAodHlwaWNhbGx5IGVp Z2h0Ci0gICAgIGtpbG9ieXRlcyksIG1pbGxpc2Vjb25kcywgc2Vjb25kcywg b3IgbWludXRlcy4gIERlZmF1bHQgdW5pdHMgY2FuIGJlCi0gICAgIGZvdW5k IGJ5IHJlZmVyZW5jaW5nIDxzdHJ1Y3RuYW1lPnBnX3NldHRpbmdzPC8+Ljxz dHJ1Y3RmaWVsZD51bml0PC8+LgotICAgICBGb3IgY29udmVuaWVuY2UsCi0g ICAgIGEgZGlmZmVyZW50IHVuaXQgY2FuIGFsc28gYmUgc3BlY2lmaWVkIGV4 cGxpY2l0bHkuICBWYWxpZCBtZW1vcnkgdW5pdHMKLSAgICAgYXJlIDxsaXRl cmFsPmtCPC9saXRlcmFsPiAoa2lsb2J5dGVzKSwgPGxpdGVyYWw+TUI8L2xp dGVyYWw+Ci0gICAgIChtZWdhYnl0ZXMpLCA8bGl0ZXJhbD5HQjwvbGl0ZXJh bD4gKGdpZ2FieXRlcyksIGFuZCA8bGl0ZXJhbD5UQjwvbGl0ZXJhbD4gKHRl cmFieXRlcyk7IHZhbGlkIHRpbWUgdW5pdHMKLSAgICAgYXJlIDxsaXRlcmFs Pm1zPC9saXRlcmFsPiAobWlsbGlzZWNvbmRzKSwgPGxpdGVyYWw+czwvbGl0 ZXJhbD4KLSAgICAgKHNlY29uZHMpLCA8bGl0ZXJhbD5taW48L2xpdGVyYWw+ IChtaW51dGVzKSwgPGxpdGVyYWw+aDwvbGl0ZXJhbD4KLSAgICAgKGhvdXJz KSwgYW5kIDxsaXRlcmFsPmQ8L2xpdGVyYWw+IChkYXlzKS4gIE5vdGUgdGhh dCB0aGUgbXVsdGlwbGllcgotICAgICBmb3IgbWVtb3J5IHVuaXRzIGlzIDEw MjQsIG5vdCAxMDAwLgorICAgICAgPGVtcGhhc2lzPkJvb2xlYW48L2VtcGhh c2lzPjogVmFsdWVzIGNhbiBiZSB3cml0dGVuIGFzCisgICAgICA8bGl0ZXJh bD5vbjwvbGl0ZXJhbD4sCisgICAgICA8bGl0ZXJhbD5vZmY8L2xpdGVyYWw+ LAorICAgICAgPGxpdGVyYWw+dHJ1ZTwvbGl0ZXJhbD4sCisgICAgICA8bGl0 ZXJhbD5mYWxzZTwvbGl0ZXJhbD4sCisgICAgICA8bGl0ZXJhbD55ZXM8L2xp dGVyYWw+LAorICAgICAgPGxpdGVyYWw+bm88L2xpdGVyYWw+LAorICAgICAg PGxpdGVyYWw+MTwvbGl0ZXJhbD4sCisgICAgICA8bGl0ZXJhbD4wPC9saXRl cmFsPgorICAgICAgKGFsbCBjYXNlLWluc2Vuc2l0aXZlKSBvciBhbnkgdW5h bWJpZ3VvdXMgcHJlZml4IG9mIHRoZXNlLgogICAgIDwvcGFyYT4KKyAgICA8 L2xpc3RpdGVtPgogCisgICAgPGxpc3RpdGVtPgogICAgIDxwYXJhPgotICAg ICBQYXJhbWV0ZXJzIG9mIHR5cGUgPHF1b3RlPmVudW08Lz4gYXJlIHNwZWNp ZmllZCBpbiB0aGUgc2FtZSB3YXkgYXMgc3RyaW5nCi0gICAgIHBhcmFtZXRl cnMsIGJ1dCBhcmUgcmVzdHJpY3RlZCB0byBhIGxpbWl0ZWQgc2V0IG9mIHZh bHVlcy4gIFRoZSBhbGxvd2VkCi0gICAgIHZhbHVlcyBjYW4gYmUgZm91bmQK LSAgICAgZnJvbSA8c3RydWN0bmFtZT5wZ19zZXR0aW5nczwvPi48c3RydWN0 ZmllbGQ+ZW51bXZhbHM8Lz4uCi0gICAgIEVudW0gcGFyYW1ldGVyIHZhbHVl cyBhcmUgY2FzZS1pbnNlbnNpdGl2ZS4KKyAgICAgIDxlbXBoYXNpcz5TdHJp bmc8L2VtcGhhc2lzPjoKKyAgICAgIEVuY2xvc2UgdGhlIHZhbHVlIGluIHNp bmdsZS1xdW90ZS4gVmFsdWVzIGFyZSBjYXNlLWluc2Vuc2l0aXZlLgorICAg ICAgSWYgbXVsdGlwbGUgdmFsdWVzIGFyZSBhbGxvd2VkIHNlcGFyYXRlIHRo ZW0gd2l0aCBjb21tYXMuCiAgICAgPC9wYXJhPgotICAgPC9zZWN0Mj4KKyAg ICA8L2xpc3RpdGVtPgorCisgICAgPGxpc3RpdGVtPgorICAgIDxwYXJhPgor ICAgICAgPGVtcGhhc2lzPk51bWVyaWM8L2VtcGhhc2lzPgorICAgICAgKGlu dGVnZXIgYW5kIGZsb2F0aW5nIHBvaW50KTogRG8gbm90IHVzZSBzaW5nbGUt cXVvdGVzCisgICAgICAodW5sZXNzIG90aGVyd2lzZSByZXF1aXJlZCkKKyAg ICAgIG9yIHRob3VzYW5kIHNlcGFyYXRvcnMuCisgICAgICBUeXBpY2FsbHkg bWVtb3J5IG9yIHRpbWUgcmVsYXRlZCAtIHNlZSBjb21tZW50cyBpbiB0aGF0 CisgICAgICBzZWN0aW9uIGZvciBkZXRhaWwuCisgICAgPC9wYXJhPgorICAg IDwvbGlzdGl0ZW0+CiAKLSAgIDxzZWN0MiBpZD0iY29uZmlnLXNldHRpbmct Y29uZmlndXJhdGlvbi1maWxlIj4KLSAgICA8dGl0bGU+U2V0dGluZyBQYXJh bWV0ZXJzIHZpYSB0aGUgQ29uZmlndXJhdGlvbiBGaWxlPC90aXRsZT4KKyAg ICA8bGlzdGl0ZW0+CisgICAgPHBhcmE+CisgICAgICA8ZW1waGFzaXM+TnVt ZXJpYyBvciBTdHJpbmcgd2l0aCBVbml0PC9lbXBoYXNpcz46IE1lbW9yeSAm YW1wOyBUaW1lLgorICAgICAgQm90aCBvZiB0aGVzZSBoYXZlIGFuIGltcGxp Y2l0IHVuaXQsIHdoaWNoIGlzIGVpdGhlciBraWxvYnl0ZXMsCisgICAgICBi bG9ja3MgKHR5cGljYWxseSBlaWdodCBraWxvYnl0ZXMpLCBtaWxsaXNlY29u ZHMsIHNlY29uZHMsIG9yIG1pbnV0ZXMuCisgICAgICBBbiBudW1lcmljIHZh bHVlIHdpbGwgdXNlIHRoZSBkZWZhdWx0LCB3aGljaCBjYW4gYmUKKyAgICAg IGZvdW5kIGJ5IHJlZmVyZW5jaW5nIDxzdHJ1Y3RuYW1lPnBnX3NldHRpbmdz PC8+LjxzdHJ1Y3RmaWVsZD51bml0PC8+LgorICAgICAgRm9yIGNvbnZlbmll bmNlLCBhIGRpZmZlcmVudCB1bml0IGNhbiBhbHNvIGJlIHNwZWNpZmllZCBl eHBsaWNpdGx5CisgICAgICB2aWEgYSBzdHJpbmcgdmFsdWUuIEl0IGlzIGNh c2Utc2Vuc2l0aXZlIGFuZAorICAgICAgbWF5IGluY2x1ZGUgYSBzcGFjZSBi ZXR3ZWVuIHRoZSB2YWx1ZSBhbmQgdGhlIHVuaXQKKyAgICAgIDxpdGVtaXpl ZGxpc3Q+CisgICAgICAgIDxsaXN0aXRlbT4KKyAgICAgICAgICA8cGFyYT4K KyAgICAgICAgICAgIFZhbGlkIG1lbW9yeSB1bml0cyBhcmUKKyAgICAgICAg ICAgIDxsaXRlcmFsPmtCPC9saXRlcmFsPiAoa2lsb2J5dGVzKSwKKyAgICAg ICAgICAgIDxsaXRlcmFsPk1CPC9saXRlcmFsPiAobWVnYWJ5dGVzKSwKKyAg ICAgICAgICAgIDxsaXRlcmFsPkdCPC9saXRlcmFsPiAoZ2lnYWJ5dGVzKSwK KyAgICAgICAgICAgIGFuZCA8bGl0ZXJhbD5UQjwvbGl0ZXJhbD4gKHRlcmFi eXRlcykuCisgICAgICAgICAgICBUaGUgbXVsdGlwbGllciBmb3IgbWVtb3J5 IHVuaXRzIGlzIDEwMjQsIG5vdCAxMDAwLgorICAgICAgICAgIDwvcGFyYT4K KyAgICAgICAgPC9saXN0aXRlbT4KKyAgICAgICAgPGxpc3RpdGVtPgorICAg ICAgICAgIDxwYXJhPgorICAgICAgICAgICAgVmFsaWQgdGltZSB1bml0cyBh cmUKKyAgICAgICAgICAgIDxsaXRlcmFsPm1zPC9saXRlcmFsPiAobWlsbGlz ZWNvbmRzKSwKKyAgICAgICAgICAgIDxsaXRlcmFsPnM8L2xpdGVyYWw+IChz ZWNvbmRzKSwKKyAgICAgICAgICAgIDxsaXRlcmFsPm1pbjwvbGl0ZXJhbD4g KG1pbnV0ZXMpLAorICAgICAgICAgICAgPGxpdGVyYWw+aDwvbGl0ZXJhbD4g KGhvdXJzKSwKKyAgICAgICAgICAgIGFuZCA8bGl0ZXJhbD5kPC9saXRlcmFs PiAoZGF5cykuCisgICAgICAgICAgPC9wYXJhPgorICAgICAgICA8L2xpc3Rp dGVtPgorICAgICAgPC9pdGVtaXplZGxpc3Q+CisgICAgPC9wYXJhPgorICAg IDwvbGlzdGl0ZW0+CiAKKyAgICA8bGlzdGl0ZW0+CiAgICAgPHBhcmE+Ci0g ICAgIE9uZSB3YXkgdG8gc2V0IHRoZXNlIHBhcmFtZXRlcnMgaXMgdG8gZWRp dCB0aGUgZmlsZQotICAgICA8ZmlsZW5hbWU+cG9zdGdyZXNxbC5jb25mPC8+ PGluZGV4dGVybT48cHJpbWFyeT5wb3N0Z3Jlc3FsLmNvbmY8Lz48Lz4sCi0g ICAgIHdoaWNoIGlzIG5vcm1hbGx5IGtlcHQgaW4gdGhlIGRhdGEgZGlyZWN0 b3J5LiAgKEEgZGVmYXVsdCBjb3B5IGlzCi0gICAgIGluc3RhbGxlZCB0aGVy ZSB3aGVuIHRoZSBkYXRhYmFzZSBjbHVzdGVyIGRpcmVjdG9yeSBpcwotICAg ICBpbml0aWFsaXplZC4pICBBbiBleGFtcGxlIG9mIHdoYXQgdGhpcyBmaWxl IG1pZ2h0IGxvb2sgbGlrZSBpczoKKyAgICAgIDxlbXBoYXNpcz48cXVvdGU+ ZW51bTwvPjwvZW1waGFzaXM+OiBUaGVzZSBzcGVjaWZpZWQgaW4gdGhlIHNh bWUgd2F5IGFzIHN0cmluZworICAgICAgcGFyYW1ldGVycywgYnV0IGFyZSBy ZXN0cmljdGVkIHRvIGEgbGltaXRlZCBzZXQgb2YgdmFsdWVzIHRoYXQgY2Fu IGJlIHF1ZXJpZWQKKyAgICAgIGZyb20gPHN0cnVjdG5hbWU+cGdfc2V0dGlu Z3M8Lz4uPHN0cnVjdGZpZWxkPmVudW12YWxzPC8+OgorPHByb2dyYW1saXN0 aW5nPgorU0VMRUNUIG5hbWUsIHNldHRpbmcsIGVudW12YWxzIEZST00gcGdf c2V0dGluZ3MgV0hFUkUgZW51bXZhbHMgSVMgTk9UIE5VTEw7Cis8L3Byb2dy YW1saXN0aW5nPgorICAgICAgRW51bSBwYXJhbWV0ZXIgdmFsdWVzIGFyZSBj YXNlLWluc2Vuc2l0aXZlLgorICAgICAgPC9wYXJhPgorICAgIDwvbGlzdGl0 ZW0+CisgICAgPC9pdGVtaXplZGxpc3Q+CisgICAgPC9zZWN0Mj4KKworICAg IDxzZWN0MiBpZD0iY29uZmlnLXNldHRpbmctY29uZmlndXJhdGlvbi1maWxl Ij4KKyAgICAgPHRpdGxlPlBhcmFtZXRlciBJbnRlcmFjdGlvbiB2aWEgQ29u ZmlndXJhdGlvbiBGaWxlPC90aXRsZT4KKworICAgICAgPHBhcmE+CisgICAg ICAgIFRoZSBwcmltYXJ5IHdheSB0byBzZXQgdGhlc2UgcGFyYW1ldGVycyBp cyB0byBlZGl0IHRoZSBmaWxlCisgICAgICAgIDxmaWxlbmFtZT5wb3N0Z3Jl c3FsLmNvbmY8Lz48aW5kZXh0ZXJtPjxwcmltYXJ5PnBvc3RncmVzcWwuY29u ZjwvPjwvPiwKKyAgICAgICAgd2hpY2ggaXMgbm9ybWFsbHkga2VwdCBpbiB0 aGUgZGF0YSBkaXJlY3RvcnkuICAoQSBkZWZhdWx0IGNvcHkgaXMKKyAgICAg ICAgaW5zdGFsbGVkIHRoZXJlIHdoZW4gdGhlIGRhdGFiYXNlIGNsdXN0ZXIg ZGlyZWN0b3J5IGlzCisgICAgICAgIGluaXRpYWxpemVkLikgIEFuIGV4YW1w bGUgb2Ygd2hhdCB0aGlzIGZpbGUgbWlnaHQgbG9vayBsaWtlIGlzOgogPHBy b2dyYW1saXN0aW5nPgogIyBUaGlzIGlzIGEgY29tbWVudAogbG9nX2Nvbm5l Y3Rpb25zID0geWVzCkBAIC03MSwxMjkgKzEyOCwyMDkgQEAgbG9nX2Rlc3Rp bmF0aW9uID0gJ3N5c2xvZycKIHNlYXJjaF9wYXRoID0gJyIkdXNlciIsIHB1 YmxpYycKIHNoYXJlZF9idWZmZXJzID0gMTI4TUIKIDwvcHJvZ3JhbWxpc3Rp bmc+Ci0gICAgIE9uZSBwYXJhbWV0ZXIgaXMgc3BlY2lmaWVkIHBlciBsaW5l LiBUaGUgZXF1YWwgc2lnbiBiZXR3ZWVuIG5hbWUgYW5kCi0gICAgIHZhbHVl IGlzIG9wdGlvbmFsLiBXaGl0ZXNwYWNlIGlzIGluc2lnbmlmaWNhbnQgYW5k IGJsYW5rIGxpbmVzIGFyZQotICAgICBpZ25vcmVkLiBIYXNoIG1hcmtzICg8 bGl0ZXJhbD4jPC9saXRlcmFsPikgZGVzaWduYXRlIHRoZSByZW1haW5kZXIg b2YgdGhlCi0gICAgIGxpbmUgYXMgYSBjb21tZW50LiAgUGFyYW1ldGVyIHZh bHVlcyB0aGF0IGFyZSBub3Qgc2ltcGxlIGlkZW50aWZpZXJzIG9yCi0gICAg IG51bWJlcnMgbXVzdCBiZSBzaW5nbGUtcXVvdGVkLiAgVG8gZW1iZWQgYSBz aW5nbGUgcXVvdGUgaW4gYSBwYXJhbWV0ZXIKLSAgICAgdmFsdWUsIHdyaXRl IGVpdGhlciB0d28gcXVvdGVzIChwcmVmZXJyZWQpIG9yIGJhY2tzbGFzaC1x dW90ZS4KLSAgICA8L3BhcmE+CisgICAgICAgIE9uZSBwYXJhbWV0ZXIgaXMg c3BlY2lmaWVkIHBlciBsaW5lLiBUaGUgZXF1YWwgc2lnbiBiZXR3ZWVuIG5h bWUgYW5kCisgICAgICAgIHZhbHVlIGlzIG9wdGlvbmFsLiBXaGl0ZXNwYWNl IGlzIGluc2lnbmlmaWNhbnQgYW5kIGJsYW5rIGxpbmVzIGFyZQorICAgICAg ICBpZ25vcmVkLiBIYXNoIG1hcmtzICg8bGl0ZXJhbD4jPC9saXRlcmFsPikg ZGVzaWduYXRlIHRoZSByZW1haW5kZXIgb2YgdGhlCisgICAgICAgIGxpbmUg YXMgYSBjb21tZW50LiAgUGFyYW1ldGVyIHZhbHVlcyB0aGF0IGFyZSBub3Qg c2ltcGxlIGlkZW50aWZpZXJzIG9yCisgICAgICAgIG51bWJlcnMgbXVzdCBi ZSBzaW5nbGUtcXVvdGVkLiAgVG8gZW1iZWQgYSBzaW5nbGUgcXVvdGUgaW4g YSBwYXJhbWV0ZXIKKyAgICAgICAgdmFsdWUsIHdyaXRlIGVpdGhlciB0d28g cXVvdGVzIChwcmVmZXJyZWQpIG9yIGJhY2tzbGFzaC1xdW90ZS4KKyAgICAg IDwvcGFyYT4KIAotICAgIDxwYXJhPgotICAgICA8aW5kZXh0ZXJtPgotICAg ICAgPHByaW1hcnk+U0lHSFVQPC9wcmltYXJ5PgotICAgICA8L2luZGV4dGVy bT4KLSAgICAgVGhlIGNvbmZpZ3VyYXRpb24gZmlsZSBpcyByZXJlYWQgd2hl bmV2ZXIgdGhlIG1haW4gc2VydmVyIHByb2Nlc3MKLSAgICAgcmVjZWl2ZXMg YSA8c3lzdGVtaXRlbT5TSUdIVVA8Lz4gc2lnbmFsOyAgdGhpcyBpcyBtb3N0 IGVhc2lseSBkb25lIGJ5Ci0gICAgIHJ1bm5pbmcgPGxpdGVyYWw+cGdfY3Rs IHJlbG9hZDwvPiBmcm9tIHRoZSBjb21tYW5kLWxpbmUgb3IgYnkgY2FsbGlu ZwotICAgICB0aGUgU1FMIGZ1bmN0aW9uIDxmdW5jdGlvbj5wZ19yZWxvYWRf Y29uZigpPC9mdW5jdGlvbj4uIFRoZSBtYWluCi0gICAgIHNlcnZlciBwcm9j ZXNzCi0gICAgIGFsc28gcHJvcGFnYXRlcyB0aGlzIHNpZ25hbCB0byBhbGwg Y3VycmVudGx5IHJ1bm5pbmcgc2VydmVyCi0gICAgIHByb2Nlc3NlcyBzbyB0 aGF0IGV4aXN0aW5nIHNlc3Npb25zIGFsc28gZ2V0IHRoZSBuZXcKLSAgICAg dmFsdWUuIEFsdGVybmF0aXZlbHksIHlvdSBjYW4gc2VuZCB0aGUgc2lnbmFs IHRvIGEgc2luZ2xlIHNlcnZlcgotICAgICBwcm9jZXNzIGRpcmVjdGx5LiAg U29tZSBwYXJhbWV0ZXJzIGNhbiBvbmx5IGJlIHNldCBhdCBzZXJ2ZXIgc3Rh cnQ7Ci0gICAgIGFueSBjaGFuZ2VzIHRvIHRoZWlyIGVudHJpZXMgaW4gdGhl IGNvbmZpZ3VyYXRpb24gZmlsZSB3aWxsIGJlIGlnbm9yZWQKLSAgICAgdW50 aWwgdGhlIHNlcnZlciBpcyByZXN0YXJ0ZWQuICBJbnZhbGlkIHBhcmFtZXRl ciBzZXR0aW5ncyBpbiB0aGUKLSAgICAgY29uZmlndXJhdGlvbiBmaWxlIGFy ZSBsaWtld2lzZSBpZ25vcmVkIChidXQgbG9nZ2VkKSBkdXJpbmcKLSAgICAg PHN5c3RlbWl0ZW0+U0lHSFVQPC8+IHByb2Nlc3NpbmcuCi0gICAgPC9wYXJh PgotICAgPC9zZWN0Mj4KKyAgICAgIDxwYXJhPgorICAgICAgICBQYXJhbWV0 ZXJzIHNldCBpbiB0aGlzIHdheSBwcm92aWRlIHRoZSBnbG9iYWwgZGVmYXVs dCB2YWx1ZSBmb3IgdGhlIGNsdXN0ZXIuCisgICAgICAgIFRoZSBzZXR0aW5n IGFjdHVhbGx5IHNlZW4gYnkgdGhlIGNvbm5lY3RpbmcgdXNlciBvciBpc3N1 ZWQgc3RhdGVtZW50CisgICAgICAgIHdpbGwgYmUgdGhpcyB2YWx1ZSB1bmxl c3MgaXQgaXMgb3ZlcnJpZGRlbi4KKyAgICAgICAgVGhlIG5leHQgc2VjdGlv bnMgZGVzY3JpYmUgd2F5cyBpbiB3aGljaCB0aGUgYWRtaW5pc3RyYXRvcgor ICAgICAgICBvciB1c2VyIGNhbiBvdmVycmlkZSB0aGVzZSBkZWZhdWx0cy4K KyAgICAgIDwvcGFyYT4KIAotICAgPHNlY3QyIGlkPSJjb25maWctc2V0dGlu Zy1vdGhlci1tZXRob2RzIj4KLSAgICA8dGl0bGU+T3RoZXIgV2F5cyB0byBT ZXQgUGFyYW1ldGVyczwvdGl0bGU+CisgICAgICA8cGFyYT4KKyAgICAgICAg PGluZGV4dGVybT4KKyAgICAgICAgICA8cHJpbWFyeT5TSUdIVVA8L3ByaW1h cnk+CisgICAgICAgIDwvaW5kZXh0ZXJtPgorICAgICAgICBUaGUgY29uZmln dXJhdGlvbiBmaWxlIGlzIHJlcmVhZCB3aGVuZXZlciB0aGUgbWFpbiBzZXJ2 ZXIgcHJvY2VzcworICAgICAgICByZWNlaXZlcyBhIDxzeXN0ZW1pdGVtPlNJ R0hVUDwvPiBzaWduYWw7ICB0aGlzIGlzIG1vc3QgZWFzaWx5IGRvbmUgYnkK KyAgICAgICAgcnVubmluZyA8bGl0ZXJhbD5wZ19jdGwgcmVsb2FkPC8+IGZy b20gdGhlIGNvbW1hbmQtbGluZSBvciBieSBjYWxsaW5nCisgICAgICAgIHRo ZSBTUUwgZnVuY3Rpb24gPGZ1bmN0aW9uPnBnX3JlbG9hZF9jb25mKCk8L2Z1 bmN0aW9uPi4gVGhlIG1haW4KKyAgICAgICAgc2VydmVyIHByb2Nlc3MKKyAg ICAgICAgYWxzbyBwcm9wYWdhdGVzIHRoaXMgc2lnbmFsIHRvIGFsbCBjdXJy ZW50bHkgcnVubmluZyBzZXJ2ZXIKKyAgICAgICAgcHJvY2Vzc2VzIHNvIHRo YXQgZXhpc3Rpbmcgc2Vzc2lvbnMgYWxzbyBnZXQgdGhlIG5ldworICAgICAg ICB2YWx1ZS4gQWx0ZXJuYXRpdmVseSwgeW91IGNhbiBzZW5kIHRoZSBzaWdu YWwgdG8gYSBzaW5nbGUgc2VydmVyCisgICAgICAgIHByb2Nlc3MgZGlyZWN0 bHkuICBTb21lIHBhcmFtZXRlcnMgY2FuIG9ubHkgYmUgc2V0IGF0IHNlcnZl ciBzdGFydDsKKyAgICAgICAgYW55IGNoYW5nZXMgdG8gdGhlaXIgZW50cmll cyBpbiB0aGUgY29uZmlndXJhdGlvbiBmaWxlIHdpbGwgYmUgaWdub3JlZAor ICAgICAgICB1bnRpbCB0aGUgc2VydmVyIGlzIHJlc3RhcnRlZC4gIEludmFs aWQgcGFyYW1ldGVyIHNldHRpbmdzIGluIHRoZQorICAgICAgICBjb25maWd1 cmF0aW9uIGZpbGUgYXJlIGxpa2V3aXNlIGlnbm9yZWQgKGJ1dCBsb2dnZWQp IGR1cmluZworICAgICAgICA8c3lzdGVtaXRlbT5TSUdIVVA8Lz4gcHJvY2Vz c2luZy4KKyAgICAgIDwvcGFyYT4KKyAgPC9zZWN0Mj4KIAotICAgIDxwYXJh PgotICAgICBBIHNlY29uZCB3YXkgdG8gc2V0IHRoZXNlIGNvbmZpZ3VyYXRp b24gcGFyYW1ldGVycyBpcyB0byBnaXZlIHRoZW0KLSAgICAgYXMgYSBjb21t YW5kLWxpbmUgb3B0aW9uIHRvIHRoZSA8Y29tbWFuZD5wb3N0Z3JlczwvY29t bWFuZD4gY29tbWFuZCwKLSAgICAgc3VjaCBhczoKLTxwcm9ncmFtbGlzdGlu Zz4KLXBvc3RncmVzIC1jIGxvZ19jb25uZWN0aW9ucz15ZXMgLWMgbG9nX2Rl c3RpbmF0aW9uPSdzeXNsb2cnCi08L3Byb2dyYW1saXN0aW5nPgotICAgICBD b21tYW5kLWxpbmUgb3B0aW9ucyBvdmVycmlkZSBhbnkgY29uZmxpY3Rpbmcg c2V0dGluZ3MgaW4KLSAgICAgPGZpbGVuYW1lPnBvc3RncmVzcWwuY29uZjwv ZmlsZW5hbWU+LiAgTm90ZSB0aGF0IHRoaXMgbWVhbnMgeW91IHdvbid0Ci0g ICAgIGJlIGFibGUgdG8gY2hhbmdlIHRoZSB2YWx1ZSBvbi10aGUtZmx5IGJ5 IGVkaXRpbmcKLSAgICAgPGZpbGVuYW1lPnBvc3RncmVzcWwuY29uZjwvZmls ZW5hbWU+LCBzbyB3aGlsZSB0aGUgY29tbWFuZC1saW5lCi0gICAgIG1ldGhv ZCBtaWdodCBiZSBjb252ZW5pZW50LCBpdCBjYW4gY29zdCB5b3UgZmxleGli aWxpdHkgbGF0ZXIuCi0gICAgPC9wYXJhPgorICAgIDxzZWN0MiBpZD0iY29u ZmlnLXNldHRpbmctc3FsLWNvbW1hbmQtaW50ZXJhY3Rpb24iPgorICAgICA8 dGl0bGU+UGFyYW1ldGVyIEludGVyYWN0aW9uIHZpYSBTUUw8L3RpdGxlPgor ICAgICAgPHBhcmE+CisgICAgICAgIDxwcm9kdWN0bmFtZT5Qb3N0Z3JlU1FM PC9wcm9kdWN0bmFtZT4gcHJvdmlkZXMgdGhyZWUgU1FMIGNvbW1hbmRzCisg ICAgICAgIHRvIGVzdGFibGlzaCBjb25maWd1cmF0aW9uIGRlZmF1bHRzCisg ICAgICAgIHRoYXQgb3ZlcnJpZGUgdGhvc2UgY29uZmlndXJlZCBnbG9iYWxs eS4KKyAgICAgICAgVGhlIGV2YWx1YXRpb24gb2YgdGhlc2UgZGVmYXVsdHMg b2NjdXJzIGF0IHRoZSBiZWdpbm5pbmcgb2YgYQorICAgICAgICBuZXcgc2Vz c2lvbiwgdXBvbiB0aGUgdXNlciBpc3N1aW5nIDx4cmVmIGxpbmtlbmQ9IlNR TC1ESVNDQVJEIj4sCisgICAgICAgIG9yIGlmIHRoZSBzZXJ2ZXIgZm9yY2Vz IHRoZSBzZXNzaW9uIHRvIHJlbG9hZCBpdCBjb25maWd1cmF0aW9uIGFmdGVy IGEKKyAgICAgICAgPHN5c3RlbWl0ZW0+U0lHSFVQPC9zeXN0ZW1pdGVtPgor ICAgICAgPC9wYXJhPgorICAgICAgPGl0ZW1pemVkbGlzdD4KKyAgICAgIDxs aXN0aXRlbT4KKyAgICAgIDxwYXJhPgorICAgICAgICBUaGUgPHhyZWYgbGlu a2VuZD0iU1FMLUFMVEVSU1lTVEVNIj4gY29tbWFuZCBwcm92aWRlcworICAg ICAgICBhbiBTUUwtYWNjZXNzaWJsZSBtZWFucworICAgICAgICB0byBjaGFu Z2UgdGhlIGdsb2JhbCBkZWZhdWx0cy4gU2luY2UgdGhlIHNlcnZlciBtdXN0 CisgICAgICAgIGJlIHJ1bm5pbmcgdG8gZXhlY3V0ZSBTUUwKKyAgICAgICAg dGhlIHRpbWluZyBvZiB3aGVuIHRoZSBhY3R1YWwgdmFsdWUgdGFrZXMgZWZm ZWN0IGRlcGVuZHMKKyAgICAgICAgb24gdGhlIHZhcmlhYmxlIGJlaW5nCisg ICAgICAgIGNoYW5nZWQgLSBidXQgaW4gbm8gY2FzZSBpcyB0aGUgY3VycmVu dCBzZXNzaW9uIGFmZmVjdGVkCisgICAgICAgIG5vciB3aWxsIGFueSBjaGFu Z2UgdGFrZQorICAgICAgICBlZmZlY3QgYmVmb3JlIHRoZSBuZXh0IGNvbmZp Z3VyYXRpb24KKyAgICAgICAgcmVsb2FkICg8c3lzdGVtaXRlbT5TSUdIVVA8 Lz4pIGJ5IHRoZSBzZXJ2ZXIuCisgICAgICA8L3BhcmE+CisgICAgICA8L2xp c3RpdGVtPgorICAgICAgPGxpc3RpdGVtPgorICAgICAgPHBhcmE+CisgICAg ICAgIFRoZSA8eHJlZiBsaW5rZW5kPSJzcWwtYWx0ZXJkYXRhYmFzZSI+IGNv bW1hbmQgYWxsb3dzIHRoZSBkYXRhYmFzZQorICAgICAgICBhZG1pbmlzdHJh dG9yIHRvIG92ZXJyaWRlIGdsb2JhbCBzZXR0aW5ncyBvbiBhIHBlci1kYXRh YmFzZSBiYXNpcy4KKyAgICAgIDwvcGFyYT4KKyAgICAgIDwvbGlzdGl0ZW0+ CisgICAgICA8bGlzdGl0ZW0+CisgICAgICA8cGFyYT4KKyAgICAgICAgVGhl IDx4cmVmIGxpbmtlbmQ9InNxbC1hbHRlcnJvbGUiPiBjb21tYW5kIGFsbG93 cyB0aGUgZGF0YWJhc2UgYWRtaW5pc3RyYXRvcgorICAgICAgICB0byBvdmVy cmlkZSBib3RoIGdsb2JhbCBhbmQgcGVyLWRhdGFiYXNlIHNldHRpbmdzIHdp dGggdXNlci1zcGVjaWZpYyB2YWx1ZXMuCisgICAgICA8L3BhcmE+CisgICAg ICA8L2xpc3RpdGVtPgorICAgICAgPC9pdGVtaXplZGxpc3Q+CiAKLSAgICA8 cGFyYT4KLSAgICAgT2NjYXNpb25hbGx5IGl0IGlzIHVzZWZ1bCB0byBnaXZl IGEgY29tbWFuZCBsaW5lIG9wdGlvbiB0bwotICAgICBvbmUgcGFydGljdWxh ciBzZXNzaW9uIG9ubHkuIFRoZSBlbnZpcm9ubWVudCB2YXJpYWJsZQotICAg ICA8ZW52YXI+UEdPUFRJT05TPC9lbnZhcj4gY2FuIGJlIHVzZWQgZm9yIHRo aXMgcHVycG9zZSBvbiB0aGUKLSAgICAgY2xpZW50IHNpZGU6CisgICAgICA8 cGFyYT4KKyAgICAgICAgT25jZSBhIGNsaWVudCBjb25uZWN0cyB0byB0aGUg ZGF0YWJhc2UgUG9zdGdyZVNRTCBwcm92aWRlcyB0d28KKyAgICAgICAgYWRk aXRpb25hbCBTUUwgY29tbWFuZHMKKyAgICAgICAgdG8gaW50ZXJhY3Qgd2l0 aCBzZXNzaW9uLWxvY2FsIHN5c3RlbSBjb25maWd1cmF0aW9uLgorICAgICAg ICBCb3RoIG9mIHRoZXNlIGNvbW1hbmRzIGhhdmUgZXF1aXZhbGVudAorICAg ICAgICBzeXN0ZW0gYWRtaW5pc3RyYXRpb24gZnVuY3Rpb25zLgorICAgICAg PC9wYXJhPgorCisgICAgICA8aXRlbWl6ZWRsaXN0PgorICAgICAgPGxpc3Rp dGVtPgorICAgICAgPHBhcmE+CisgICAgICBUaGUgPHhyZWYgbGlua2VuZD0i U1FMLVNIT1ciPgorICAgICAgY29tbWFuZCBhbGxvd3MgaW5zcGVjdGlvbiBv ZiB0aGUgY3VycmVudCB2YWx1ZSBvZiBhbGwgcGFyYW1ldGVycy4KKyAgICAg IFRoZSBjb3JyZXNwb25kaW5nIGZ1bmN0aW9uCisgICAgICBpcyA8ZnVuY3Rp b24+Y3VycmVudF9zZXR0aW5nKHNldHRpbmdfbmFtZSB0ZXh0KTwvZnVuY3Rp b24+LgorICAgICAgPC9wYXJhPgorICAgICAgPC9saXN0aXRlbT4KKyAgICAg IDxsaXN0aXRlbT4KKyAgICAgIDxwYXJhPgorICAgICAgVGhlIDx4cmVmIGxp bmtlbmQ9IlNRTC1TRVQiPgorICAgICAgY29tbWFuZCBhbGxvd3MgbW9kaWZp Y2F0aW9uIG9mIHRoZSBjdXJyZW50IHZhbHVlIHNvbWUgcGFyYW1ldGVycy4K KyAgICAgIFRoZSBjb3JyZXNwb25kaW5nIGZ1bmN0aW9uIGlzCisgICAgICA8 ZnVuY3Rpb24+c2V0X2NvbmZpZyhzZXR0aW5nX25hbWUsIG5ld192YWx1ZSwg aXNfbG9jYWwpPC9mdW5jdGlvbj4uCisgICAgICA8L3BhcmE+CisgICAgICA8 L2xpc3RpdGVtPgorICAgICAgPC9pdGVtaXplZGxpc3Q+CisKKyAgICAgIDxw YXJhPgorICAgICAgICBCb3RoIDxlbXBoYXNpcz5TRUxFQ1Q8Lz4gYW5kIDxl bXBoYXNpcz5VUERBVEU8Lz4gY2FuIGJlIGlzc3VlZCBhZ2FpbnN0IHRoZQor ICAgICAgICB2aXJ0dWFsIHRhYmxlIDxzdHJ1Y3RuYW1lPnBnX3NldHRpbmdz PC8+IHRvIHZpZXcgYW5kCisgICAgICAgIGFmZmVjdCB0aGUgc2Vzc2lvbi1s b2NhbCBjb25maWd1cmF0aW9uLgorICAgICAgICBJdHMgZGVmaW5pdGlvbiBj YW4gYmUgZm91bmQgaW4gPHhyZWYgbGlua2VuZD0idmlldy1wZy1zZXR0aW5n cyI+LgorICAgICAgPC9wYXJhPgorCisgICAgICA8aXRlbWl6ZWRsaXN0Pgor ICAgICAgPGxpc3RpdGVtPgorICAgICAgPHBhcmE+CisgICAgICAgIDx4cmVm IGxpbmtlbmQ9IlNRTC1TRUxFQ1QiPi1pbmcgYWdhaW5zdCB0aGlzIHJlbGF0 aW9uCisgICAgICAgIGlzIHRoZSBlcXVpdmFsZW50IG9mIGlzc3VpbmcKKyAg ICAgICAgU0hPVyBidXQgcHJvdmlkZXMgY29uc2lkZXJhYmx5IG1vcmUgZGV0 YWlsIGFzIHdlbGwgYXMKKyAgICAgICAgYWxsb3dpbmcgZm9yIGpvaW5pbmcg YWdhaW5zdCBvdGhlciByZWxhdGlvbnMgYW5kIHNwZWNpZnlpbmcgZmlsdGVy IGNyaXRlcmlhLgorICAgICAgPC9wYXJhPgorICAgICAgPC9saXN0aXRlbT4K KyAgICAgIDxsaXN0aXRlbT4KKyAgICAgIDxwYXJhPgorICAgICAgICA8eHJl ZiBsaW5rZW5kPSJTUUwtVVBEQVRFIj4taW5nIGFnYWluc3QgdGhpcyByZWxh dGlvbiwKKyAgICAgICAgc3BlY2lmaWNhbGx5IHRoZSA8c3RydWN0bmFtZT5z ZXR0aW5nPC8+IGNvbHVtbgorICAgICAgICBpcyB0aGUgZXF1aXZhbGVudCBv ZiBpc3N1aW5nIFNFVCB0aG91Z2ggYWxsIHZhbHVlcyBtdXN0IGJlIHNpbmds ZS1xdW90ZWQuCisgICAgICA8L3BhcmE+CisgICAgICA8cGFyYT4KKyAgICAg ICAgTm90ZSB0aGF0IHRoZSBlcWl2YWxlbnQgb2YKIDxwcm9ncmFtbGlzdGlu Zz4KLWVudiBQR09QVElPTlM9Jy1jIGdlcW89b2ZmJyBwc3FsCitTRVQgY29u ZmlndXJhdGlvbl9wYXJhbWV0ZXIgVE8gREVGQVVMVDsKKzwvPgorICAgICAg ICB3b3VsZCBiZToKKzxwcm9ncmFtbGlzdGluZz4KK1VQREFURSBwZ19zZXR0 aW5ncyBTRVQgc2V0dGluZyA9IHJlc2V0X3ZhbCBXSEVSRSBuYW1lID0gJ2Nv bmZpZ3VyYXRpb25fcGFyYW1ldGVyJzsKIDwvcHJvZ3JhbWxpc3Rpbmc+Ci0g ICAgIChUaGlzIHdvcmtzIGZvciBhbnkgPGFwcGxpY2F0aW9uPmxpYnBxPC8+ LWJhc2VkIGNsaWVudCBhcHBsaWNhdGlvbiwgbm90Ci0gICAgIGp1c3QgPGFw cGxpY2F0aW9uPnBzcWw8L2FwcGxpY2F0aW9uPi4pIE5vdGUgdGhhdCB0aGlz IHdvbid0IHdvcmsgZm9yCi0gICAgIHBhcmFtZXRlcnMgdGhhdCBhcmUgZml4 ZWQgd2hlbiB0aGUgc2VydmVyIGlzIHN0YXJ0ZWQgb3IgdGhhdCBtdXN0IGJl Ci0gICAgIHNwZWNpZmllZCBpbiA8ZmlsZW5hbWU+cG9zdGdyZXNxbC5jb25m PC9maWxlbmFtZT4uCi0gICAgPC9wYXJhPgorICAgICAgPC9wYXJhPgorICAg ICAgPC9saXN0aXRlbT4KKyAgICAgIDwvaXRlbWl6ZWRsaXN0PgogCi0gICAg PHBhcmE+Ci0gICAgIEZ1cnRoZXJtb3JlLCBpdCBpcyBwb3NzaWJsZSB0byBh c3NpZ24gYSBzZXQgb2YgcGFyYW1ldGVyIHNldHRpbmdzIHRvCi0gICAgIGEg dXNlciBvciBhIGRhdGFiYXNlLiAgV2hlbmV2ZXIgYSBzZXNzaW9uIGlzIHN0 YXJ0ZWQsIHRoZSBkZWZhdWx0Ci0gICAgIHNldHRpbmdzIGZvciB0aGUgdXNl ciBhbmQgZGF0YWJhc2UgaW52b2x2ZWQgYXJlIGxvYWRlZC4gIFRoZQotICAg ICBjb21tYW5kcyA8eHJlZiBsaW5rZW5kPSJzcWwtYWx0ZXJyb2xlIj4KLSAg ICAgYW5kIDx4cmVmIGxpbmtlbmQ9InNxbC1hbHRlcmRhdGFiYXNlIj4sCi0g ICAgIHJlc3BlY3RpdmVseSwgYXJlIHVzZWQgdG8gY29uZmlndXJlIHRoZXNl IHNldHRpbmdzLiAgUGVyLWRhdGFiYXNlCi0gICAgIHNldHRpbmdzIG92ZXJy aWRlIGFueXRoaW5nIHJlY2VpdmVkIGZyb20gdGhlCi0gICAgIDxjb21tYW5k PnBvc3RncmVzPC9jb21tYW5kPiBjb21tYW5kLWxpbmUgb3IgdGhlIGNvbmZp Z3VyYXRpb24KLSAgICAgZmlsZSwgYW5kIGluIHR1cm4gYXJlIG92ZXJyaWRk ZW4gYnkgcGVyLXVzZXIgc2V0dGluZ3M7IGJvdGggYXJlCi0gICAgIG92ZXJy aWRkZW4gYnkgcGVyLXNlc3Npb24gc2V0dGluZ3MuCi0gICAgPC9wYXJhPgor ICAgIDwvc2VjdDI+CiAKLSAgICA8cGFyYT4KLSAgICAgU29tZSBwYXJhbWV0 ZXJzIGNhbiBiZSBjaGFuZ2VkIGluIGluZGl2aWR1YWwgPGFjcm9ueW0+U1FM PC9hY3JvbnltPgotICAgICBzZXNzaW9ucyB3aXRoIHRoZSA8eHJlZiBsaW5r ZW5kPSJTUUwtU0VUIj4KLSAgICAgY29tbWFuZCwgZm9yIGV4YW1wbGU6Ci08 c2NyZWVuPgotU0VUIEVOQUJMRV9TRVFTQ0FOIFRPIE9GRjsKLTwvc2NyZWVu PgotICAgICBJZiA8Y29tbWFuZD5TRVQ8Lz4gaXMgYWxsb3dlZCwgaXQgb3Zl cnJpZGVzIGFsbCBvdGhlciBzb3VyY2VzIG9mCi0gICAgIHZhbHVlcyBmb3Ig dGhlIHBhcmFtZXRlci4gU29tZSBwYXJhbWV0ZXJzIGNhbm5vdCBiZSBjaGFu Z2VkIHZpYQotICAgICA8Y29tbWFuZD5TRVQ8L2NvbW1hbmQ+OiBmb3IgZXhh bXBsZSwgaWYgdGhleSBjb250cm9sIGJlaGF2aW9yIHRoYXQKLSAgICAgY2Fu bm90IGJlIGNoYW5nZWQgd2l0aG91dCByZXN0YXJ0aW5nIHRoZSBlbnRpcmUK LSAgICAgPHByb2R1Y3RuYW1lPlBvc3RncmVTUUw8L3Byb2R1Y3RuYW1lPiBz ZXJ2ZXIuICBBbHNvLCBzb21lIHBhcmFtZXRlcnMKLSAgICAgcmVxdWlyZSBz dXBlcnVzZXIgcGVybWlzc2lvbiB0byBjaGFuZ2UgdmlhIDxjb21tYW5kPlNF VDwvY29tbWFuZD4gb3IKLSAgICAgPGNvbW1hbmQ+QUxURVI8Lz4uCi0gICAg PC9wYXJhPgorICAgIDxzZWN0Mj4KKyAgICAgPHRpdGxlPlBhcmFtZXRlciBJ bnRlcmFjdGlvbiB2aWEgU2hlbGw8L3RpdGxlPgorICAgICAgPHBhcmE+Cisg ICAgICBJbiBhZGRpdGlvbiB0byBzZXR0aW5nIGdsb2JhbCBkZWZhdWx0cyBv ciBhdHRhY2hpbmcgb3ZlcnJpZGVzCisgICAgICBhdCB0aGUgZGF0YWJhc2Ug b3Igcm9sZSBzY29wZQorICAgICAgLCB5b3UgbWF5IGNob29zZSB0byBwcm92 aWRlIHRoZW0gdG8KKyAgICAgIDxwcm9kdWN0bmFtZT5Qb3N0Z3JlU1FMPC9w cm9kdWN0bmFtZT4gdmlhIHNoZWxsIGZhY2lsaXRpZXMuCisgICAgICBCb3Ro IHRoZSBzZXJ2ZXIgYW5kIDxhcHBsaWNhdGlvbj5saWJwcTwvPiBjbGllbnQg bGlicmFyeQorICAgICAgaGF2ZSBkZWZpbmVkIHdheXMgdG8gYWNjZXB0Cisg ICAgICBwYXJhbWV0ZXIgdmFsdWVzIHZpYSB0aGUgc2hlbGwuCisgICAgICA8 L3BhcmE+CisgICAgICA8aXRlbWl6ZWRsaXN0PgogCi0gICAgPHBhcmE+Ci0g ICAgIEFub3RoZXIgd2F5IHRvIGNoYW5nZSBjb25maWd1cmF0aW9uIHBhcmFt ZXRlcnMgcGVyc2lzdGVudGx5IGlzIGJ5Ci0gICAgIHVzZSBvZiA8eHJlZiBs aW5rZW5kPSJTUUwtQUxURVJTWVNURU0iPgotICAgICBjb21tYW5kLCBmb3Ig ZXhhbXBsZToKLTxzY3JlZW4+Ci1BTFRFUiBTWVNURU0gU0VUIGNoZWNrcG9p bnRfdGltZW91dCBUTyA2MDA7Ci08L3NjcmVlbj4KLSAgICAgVGhpcyBjb21t YW5kIHdpbGwgYWxsb3cgdXNlcnMgdG8gY2hhbmdlIHZhbHVlcyBwZXJzaXN0 ZW50bHkKLSAgICAgdGhyb3VnaCBTUUwgY29tbWFuZC4gVGhlIHZhbHVlcyB3 aWxsIGJlIGVmZmVjdGl2ZSBhZnRlciByZWxvYWQgb2Ygc2VydmVyIGNvbmZp Z3VyYXRpb24KLSAgICAgKDxhY3JvbnltPlNJR0hVUDwvPikgb3Igc2VydmVy IHN0YXJ0dXAuIFRoZSBlZmZlY3Qgb2YgdGhpcyBjb21tYW5kIGlzIHNpbWls YXIgdG8gd2hlbgotICAgICB1c2VyIG1hbnVhbGx5IGNoYW5nZXMgdmFsdWVz IGluIDxmaWxlbmFtZT5wb3N0Z3Jlc3FsLmNvbmY8L2ZpbGVuYW1lPi4KLSAg ICA8L3BhcmE+Ci0gICA8L3NlY3QyPgorICAgICAgPGxpc3RpdGVtPgorICAg ICAgPHBhcmE+CisgICAgICBPbiB0aGUgPGVtcGhhc2lzPnNlcnZlcjwvZW1w aGFzaXM+LCBjb21tYW5kLWxpbmUgb3B0aW9ucyBjYW4gcGFzc2VkIHRvIHRo ZQorICAgICAgPGNvbW1hbmQ+cG9zdGdyZXM8L2NvbW1hbmQ+IGNvbW1hbmQg ZGlyZWN0bHkgdmlhIHRoZSAiLWMiIHBhcmFtZXRlci4KKzxwcm9ncmFtbGlz dGluZz4KK3Bvc3RncmVzIC1jIGxvZ19jb25uZWN0aW9ucz15ZXMgLWMgbG9n X2Rlc3RpbmF0aW9uPSdzeXNsb2cnCis8L3Byb2dyYW1saXN0aW5nPgorICAg ICAgU2V0dGluZ3MgcHJvdmlkZWQgdGhpcyB3YXkgb3ZlcnJpZGUgdGhvc2Ug cmVzb2x2ZWQgZ2xvYmFsbHkKKyAgICAgICh2aWEgcG9zdGdyZXNxbC5jb25m IG9yIEFMVEVSIFNZU1RFTSkKKyAgICAgIGJ1dCBhcmUgb3RoZXJ3aXNlIHRy ZWF0ZWQgYXMgYmVpbmcgZ2xvYmFsIGZvciB0aGUgcHVycG9zZSBvZgorICAg ICAgZGF0YWJhc2UgYW5kIHJvbGUgb3ZlcnJpZGluZy4KKyAgICAgIDwvcGFy YT4KIAotICAgPHNlY3QyIGlkPSJjb25maWctc2V0dGluZy1leGFtaW5pbmci PgotICAgIDx0aXRsZT5FeGFtaW5pbmcgUGFyYW1ldGVyIFNldHRpbmdzPC90 aXRsZT4KKyAgICAgIDxwYXJhPgorICAgICAgVHlwaWNhbGx5LCBhIHByb2R1 Y3Rpb24gc3lzdGVtIHdpbGwgYmUgYWRtaW5zdGVyZWQgdmlhIGl0cworICAg ICAgPGZpbGVuYW1lPnBvc3RncmVzcWwuY29uZjwvZmlsZW5hbWU+IGZpbGUu CisgICAgICBVc2Ugb2YgdGhpcyBtZWNoYW5pc20gaXMgc3VnZ2VzdGVkIG9u bHkgZm9yIGRldmVsb3BtZW50IGFuZCB0ZXN0aW5nLgorICAgICAgPC9wYXJh PgorICAgICAgPC9saXN0aXRlbT4KIAotICAgIDxwYXJhPgotICAgICBUaGUg PHhyZWYgbGlua2VuZD0iU1FMLVNIT1ciPgotICAgICBjb21tYW5kIGFsbG93 cyBpbnNwZWN0aW9uIG9mIHRoZSBjdXJyZW50IHZhbHVlcyBvZiBhbGwgcGFy YW1ldGVycy4KLSAgICA8L3BhcmE+CisgICAgICA8bGlzdGl0ZW0+CisgICAg ICA8cGFyYT4KKyAgICAgIE9uIHRoZSA8ZW1waGFzaXM+bGlicHEtY2xpZW50 PC9lbXBoYXNpcz4sIGNvbW1hbmQtbGluZSBvcHRpb25zIGFyZQorICAgICAg c3BlY2lmaWVkIHVzaW5nIHRoZQorICAgICAgPGVudmFyPlBHT1BUSU9OUzwv ZW52YXI+IGVudmlyb25tZW50IHZhcmlhYmxlLgorICAgICAgVXBvbiBjb25u ZWN0aW5nIHRvIGEgc2VydmVyIHRoZSBjb250ZW50cyBvZiB0aGlzIHZhcmlh YmxlIGFyZSBzZW50CisgICAgICB0byB0aGUgc2VydmVyIGFzIGlmIHRoZXkg d2VyZSBiZWluZworICAgICAgZXhlY3V0ZWQgdmlhIGEgU1FMIDx4cmVmIGxp bmtlbmQ9IlNRTC1TRVQiPiBhdCB0aGUgYmVnaW5uaW5nIG9mIHRoZSBzZXNz aW9uLgorICAgICAgPC9wYXJhPgogCi0gICAgPHBhcmE+Ci0gICAgIFRoZSB2 aXJ0dWFsIHRhYmxlIDxzdHJ1Y3RuYW1lPnBnX3NldHRpbmdzPC9zdHJ1Y3Ru YW1lPiBhbHNvIGFsbG93cwotICAgICBkaXNwbGF5aW5nIGFuZCB1cGRhdGlu ZyBzZXNzaW9uIHJ1bi10aW1lIHBhcmFtZXRlcnM7ICBzZWUgPHhyZWYKLSAg ICAgbGlua2VuZD0idmlldy1wZy1zZXR0aW5ncyI+IGZvciBkZXRhaWxzIGFu ZCBhIGRlc2NyaXB0aW9uIG9mIHRoZQotICAgICBkaWZmZXJlbnQgdmFyaWFi bGUgdHlwZXMgYW5kIHdoZW4gdGhleSBjYW4gYmUgY2hhbmdlZC4KLSAgICAg PHN0cnVjdG5hbWU+cGdfc2V0dGluZ3M8L3N0cnVjdG5hbWU+IGlzIGVxdWl2 YWxlbnQgdG8gPGNvbW1hbmQ+U0hPVzwvPgotICAgICBhbmQgPGNvbW1hbmQ+ U0VUPC8+LCBidXQgY2FuIGJlIG1vcmUgY29udmVuaWVudAotICAgICB0byB1 c2UgYmVjYXVzZSBpdCBjYW4gYmUgam9pbmVkIHdpdGggb3RoZXIgdGFibGVz LCBvciBzZWxlY3RlZCBmcm9tIHVzaW5nCi0gICAgIGFueSBkZXNpcmVkIHNl bGVjdGlvbiBjb25kaXRpb24uIEl0IGFsc28gY29udGFpbnMgbW9yZSBpbmZv cm1hdGlvbiBhYm91dAotICAgICBlYWNoIHBhcmFtZXRlciB0aGFuIGlzIGF2 YWlsYWJsZSBmcm9tIDxjb21tYW5kPlNIT1c8Lz4uCi0gICAgPC9wYXJhPgor ICAgICAgPHBhcmE+CisgICAgICBIb3dldmVyLCB0aGUgZm9ybWF0IGZvciA8 ZW52YXI+UEdPUFRJT05TPC9lbnZhcj4gaXMgc2ltaWxhciB0byB0aGF0IHBy b3ZpZGVkIHdoZW4gbGF1bmNoaW5nCisgICAgICA8Y29tbWFuZD5wb3N0Z3Jl czwvY29tbWFuZD4gY29tbWFuZC4KKyAgICAgIFNwZWNpZmljYWxseSwgdGhl ICctYycgZmxhZyBzcGVjaWZpY2F0aW9uIGlzIHBhcnQgb2YgdGhlIHZhbHVl LgorPHByb2dyYW1saXN0aW5nPgorZW52IFBHT1BUSU9OUz0iLWMgZ2Vxbz1v ZmYgLWMgc3RhdGVtZW50X3RpbWVvdXQ9JzUgbWluJyIgcHNxbAorPC9wcm9n cmFtbGlzdGluZz4KKyAgICAgIDwvcGFyYT4KIAotICAgPC9zZWN0Mj4KKyAg ICAgIDxwYXJhPgorICAgICAgICBPdGhlciBjbGllbnRzIGFuZCBsaWJyYXJp ZXMgbWF5IHByb3ZpZGUgdGhlaXIgb3duIG1lY2hhbmlzbXMsCisgICAgICAg IHZpYSB0aGUgc2hlbGwgb3Igb3RoZXJ3aXNlLCB0aGF0IGFsbG93IHRoZSB1 c2VyCisgICAgICAgIHRvIHNldHVwIHRoZSBzZXNzaW9uIGNvbmZpZ3VyYXRp b24gd2l0aG91dCByZXF1aXJpbmcgdGhlIHVzZXIKKyAgICAgICAgdG8gaXNz dWUgU1FMIGNvbW1hbmRzLiBQbGVhc2Ugc2VlIHRoZWlyIGRvY3VtZW50YXRp b24KKyAgICAgICAgZm9yIGRldGFpbHMuCisgICAgICA8L3BhcmE+CisgICAg ICA8L2xpc3RpdGVtPgorICAgICAgPC9pdGVtaXplZGxpc3Q+CisKKyAgICA8 L3NlY3QyPgogCiAgICA8c2VjdDIgaWQ9ImNvbmZpZy1pbmNsdWRlcyI+CiAg ICAgPHRpdGxlPkNvbmZpZ3VyYXRpb24gRmlsZSBJbmNsdWRlczwvdGl0bGU+ Cg== --001a11c258dc1b1a4e04fb543303 Content-Type: text/plain Content-Disposition: inline Content-Transfer-Encoding: 8bit MIME-Version: 1.0 -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs --001a11c258dc1b1a4e04fb543303--