Received: from merganser.its.uu.se (merganser.its.uu.se [130.238.6.236]) by hub.org (8.9.3/8.9.3) with ESMTP id KAA46174 for ; Mon, 6 Mar 2000 10:57:15 -0500 (EST) (envelope-from peter@localhost.its.uu.se) Received: from regulus.its.uu.se ([130.238.7.19]:64696 "EHLO regulus.its.uu.se") by merganser.its.uu.se with ESMTP id ; Mon, 6 Mar 2000 16:56:18 +0100 Received: from peter (helo=localhost) by regulus.its.uu.se with local-esmtp (Exim 3.02 #2) id 12Rzuy-0000ET-00 for pgsql-docs@postgresql.org; Mon, 06 Mar 2000 16:59:36 +0100 Date: Mon, 6 Mar 2000 16:59:36 +0100 (CET) From: Peter Eisentraut To: pgsql-docs@postgresql.org Subject: Bug reporting guidelines Message-ID: MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="8323328-1743718507-952350422=:362" Content-ID: Sender: Peter Eisentraut This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. Send mail to mime@docserver.cac.washington.edu for more info. --8323328-1743718507-952350422=:362 Content-Type: TEXT/PLAIN; CHARSET=ISO-8859-1 Content-Transfer-Encoding: 8BIT Content-ID: Is everyone okay with the attached bug reporting guidelines? Any corrections and suggestions whatsoever are welcome. I've tried to find a careful balance between 'use your common sense' and 'better safe than sorry', albeit skewed to the latter. (I do have this in DocBook. Just showing it first.) Thomas, when is the deadline for doc changes? I have some minor corrections to the installation procedure lying around as well. -- Peter Eisentraut Sernanders väg 10:115 peter_e@gmx.net 75262 Uppsala http://yi.org/peter-e/ Sweden --8323328-1743718507-952350422=:362 Content-Type: TEXT/PLAIN; NAME="pgsql-bugs.txt" Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Bug reporting guidelines Content-Disposition: ATTACHMENT; FILENAME="pgsql-bugs.txt" QnVnIFJlcG9ydGluZyBHdWlkZWxpbmVzDQoNCldoZW4geW91IGVuY291bnRl ciBhIGJ1ZyBpbiBQb3N0Z3JlU1FMIHdlIHdhbnQgdG8gaGVhciBhYm91dCBp dC4gWW91ciBidWcNCnJlcG9ydHMgYXJlIGFuIGltcG9ydGFudCBwYXJ0IGlu IG1ha2luZyBQb3N0Z3JlU1FMIG1vcmUgcmVsaWFibGUgYmVjYXVzZQ0KZXZl biB0aGUgdXRtb3N0IGNhcmUgY2Fubm90IGd1YXJhbnRlZSB0aGF0IGV2ZXJ5 IHBhcnQgb2YgUG9zdGdyZVNRTCB3aWxsDQp3b3JrIG9uIGV2ZXJ5IHBsYXRm b3JtIHVuZGVyIGV2ZXJ5IGNpcmN1bXN0YW5jZS4NCg0KVGhlIGZvbGxvd2lu ZyBzdWdnZXN0aW9ucyBhcmUgaW50ZW5kZWQgdG8gYXNzaXN0IHlvdSBpbiBm b3JtaW5nIGJ1ZyByZXBvcnRzDQp0aGF0IGNhbiBiZSBoYW5kbGVkIGluIGFu IGVmZmVjdGl2ZSBmYXNoaW9uLiBObyBvbmUgaXMgcmVxdWlyZWQgdG8gZm9s bG93DQp0aGVtIGJ1dCBpdCB0ZW5kcyB0byBiZSB0byBldmVyeW9uZSdzIGFk dmFudGFnZS4NCg0KV2UgY2Fubm90IHByb21pc2UgdG8gZml4IGV2ZXJ5IGJ1 ZyByaWdodCBhd2F5LiBJZiB0aGUgYnVnIGlzIG9idmlvdXMsDQpjcml0aWNh bCwgb3IgYWZmZWN0cyBhIGxvdCBvZiB1c2VycywgY2hhbmNlcyBhcmUgZ29v ZCB0aGF0IHNvbWVvbmUgd2lsbCBsb29rDQppbnRvIGl0LiBJdCBjb3VsZCBh bHNvIGhhcHBlbiB0aGF0IHdlIHRlbGwgeW91IHRvIHVwZGF0ZSB0byBhIG5l d2VyIHZlcnNpb24NCnRvIHNlZSBpZiB0aGUgYnVnIGhhcHBlbnMgdGhlcmUu IE9yIHdlIG1pZ2h0IGRlY2lkZSB0aGF0IHRoZSBidWcgY2Fubm90IGJlDQpm aXhlZCBiZWZvcmUgc29tZSBtYWpvciByZXdyaXRlIHdlIG1pZ2h0IGJlIHBs YW5uaW5nIGlzIGRvbmUuIE9yIHBlcmhhcHMNCml0J3Mgc2ltcGx5IHRvbyBo YXJkIGFuZCB0aGVyZSBhcmUgbW9yZSBpbXBvcnRhbnQgdGhpbmdzIG9uIHRo ZSBhZ2VuZGEuIElmDQp5b3UgbmVlZCBoZWxwIGltbWVkaWF0ZWx5LCBjb25z aWRlciBvYnRhaW5pbmcgYSBjb21tZXJjaWFsIHN1cHBvcnQgY29udHJhY3Qu DQoNCklkZW50aWZ5aW5nIEJ1Z3MNCg0KQmVmb3JlIHlvdSBhc2sgIklzIHRo aXMgYSBidWc/IiwgcGxlYXNlIHJlYWQgYW5kIHJlLXJlYWQgdGhlIGRvY3Vt ZW50YXRpb24NCnRvIHZlcmlmeSB0aGF0IHlvdSBjYW4gcmVhbGx5IGRvIHdo YXRldmVyIGl0IGlzIHlvdSBhcmUgdHJ5aW5nLiBJZiBpdCBpcyBub3QNCmNs ZWFyIGZyb20gdGhlIGRvY3VtZW50YXRpb24gd2hldGhlciB5b3UgY2FuIGRv IHNvbWV0aGluZyBvciBub3QsIHBsZWFzZQ0KcmVwb3J0IHRoYXQgdG9vLCBp dCdzIGEgYnVnIGluIHRoZSBkb2N1bWVudGF0aW9uLiBJZiBpdCB0dXJucyBv dXQgdGhhdCB0aGUNCnByb2dyYW0gZG9lcyBzb21ldGhpbmcgZGlmZmVyZW50 IGZyb20gd2hhdCB0aGUgZG9jdW1lbnRhdGlvbiBzYXlzLCB0aGF0J3MgYQ0K YnVnLiBUaGF0IG1pZ2h0IGluY2x1ZGUsIGJ1dCBpcyBub3QgbGltaXRlZCB0 bywgdGhlIGZvbGxvd2luZyBjaXJjdW1zdGFuY2VzOg0KDQogICAqIEEgcHJv Z3JhbSB0ZXJtaW5hdGVzIHdpdGggYSBmYXRhbCBzaWduYWwgb3IgYW4gb3Bl cmF0aW5nIHN5c3RlbSBlcnJvcg0KICAgICBtZXNzYWdlIHRoYXQgd291bGQg cG9pbnQgdG8gYSBwcm9ibGVtIGluIHRoZSBwcm9ncmFtIChmb3IgZXhhbXBs ZSBub3QNCiAgICAgImRpc2sgZnVsbCIpLg0KDQogICAqIEEgcHJvZ3JhbSBw cm9kdWNlcyB0aGUgd3Jvbmcgb3V0cHV0IGZvciBhbnkgZ2l2ZW4gaW5wdXQu DQoNCiAgICogQSBwcm9ncmFtIHJlZnVzZXMgdG8gYWNjZXB0IHZhbGlkIGlu cHV0Lg0KDQogICAqIEEgcHJvZ3JhbSBhY2NlcHRzIGludmFsaWQgaW5wdXQg d2l0aG91dCBhIG5vdGljZSBvciBlcnJvciBtZXNzYWdlLg0KDQogICAqIFBv c3RncmVTUUwgZmFpbHMgdG8gY29tcGlsZSwgYnVpbGQsIG9yIGluc3RhbGwg YWNjb3JkaW5nIHRvIHRoZQ0KICAgICBpbnN0cnVjdGlvbnMgb24gc3VwcG9y dGVkIHBsYXRmb3Jtcy4NCg0KSGVyZSAicHJvZ3JhbSIgcmVmZXJzIHRvIGFu eSBleGVjdXRhYmxlLCBub3Qgb25seSB0aGUgYmFja2VuZCBzZXJ2ZXIuDQoN CkJlaW5nIHNsb3cgb3IgcmVzb3VyY2UtaG9nZ2luZyBpcyBub3QgbmVjZXNz YXJpbHkgYSBidWcuIFJlYWQgdGhlDQpkb2N1bWVudGF0aW9uIG9yIGFzayBv biBvbmUgb2YgdGhlIG1haWxpbmcgbGlzdHMgZm9yIGhlbHAgaW4gdHVuaW5n IHlvdXINCmFwcGxpY2F0aW9ucy4gRmFpbGluZyB0byBjb21wbHkgdG8gU1FM IGlzIG5vdCBhIGJ1ZyB1bmxlc3MgY29tcGxpYW5jZSBmb3INCnRoZSBzcGVj aWZpYyBmZWF0dXJlIGlzIGV4cGxpY2l0bHkgY2xhaW1lZC4NCg0KQmVmb3Jl IHlvdSBjb250aW51ZSwgY2hlY2sgb24gdGhlIFRPRE8gbGlzdCBhbmQgaW4g dGhlIEZBUSB0byBzZWUgaWYgeW91cg0KYnVnIGlzIGFscmVhZHkga25vd24u IElmIHlvdSBjYW4ndCBkZWNvZGUgdGhlIGluZm9ybWF0aW9uIG9uIHRoZSBU T0RPIGxpc3QsDQpyZXBvcnQgeW91ciBwcm9ibGVtLiBUaGUgbGVhc3Qgd2Ug Y2FuIGRvIGlzIG1ha2UgdGhlIFRPRE8gbGlzdCBjbGVhcmVyLg0KDQpXaGF0 IHRvIHJlcG9ydA0KDQpUaGUgbW9zdCBpbXBvcnRhbnQgdGhpbmcgdG8gcmVt ZW1iZXIgYWJvdXQgYnVnIHJlcG9ydGluZyBpcyB0byBzdGF0ZSBhbGwgdGhl DQpmYWN0cyBhbmQgb25seSBmYWN0cy4gRG8gbm90IHNwZWN1bGF0ZSB3aGF0 IHlvdSB0aGluayB3ZW50IHdyb25nLCB3aGF0ICJpdA0Kc2VlbWVkIHRvIGRv Iiwgb3Igd2hpY2ggcGFydCBvZiB0aGUgcHJvZ3JhbSBoYXMgYSBmYXVsdC4g SWYgeW91IGFyZSBub3QNCmZhbWlsaWFyIHdpdGggdGhlIGltcGxlbWVudGF0 aW9uIHlvdSB3b3VsZCBwcm9iYWJseSBndWVzcyB3cm9uZyBhbmQgbm90IGhl bHANCnVzIGEgYml0LiBBbmQgZXZlbiBpZiB5b3UgYXJlLCBlZHVjYXRlZCBl eHBsYW5hdGlvbnMgYXJlIGEgZ3JlYXQgc3VwcGxlbWVudA0KdG8gYnV0IG5v IHN1YnN0aXR1dGUgZm9yIGZhY3RzLiBJZiB3ZSBhcmUgZ29pbmcgdG8gZml4 IHRoZSBidWcgd2Ugc3RpbGwgaGF2ZQ0KdG8gc2VlIGl0IGhhcHBlbiBmb3Ig b3Vyc2VsdmVzIGZpcnN0LiBSZXBvcnRpbmcgdGhlIGJhcmUgZmFjdHMgaXMg cmVsYXRpdmVseQ0Kc3RyYWlnaHRmb3J3YXJkICh5b3UgY2FuIHByb2JhYmx5 IGNvcHkgYW5kIHBhc3RlIHRoZW0gZnJvbSB0aGUgc2NyZWVuKSBidXQNCmFs bCB0b28gb2Z0ZW4gaW1wb3J0YW50IGRldGFpbHMgYXJlIGxlZnQgb3V0IGJl Y2F1c2Ugc29tZW9uZSB0aG91Z2h0IGl0DQpkb2Vzbid0IG1hdHRlciBvciB0 aGUgcmVwb3J0IHdvdWxkICJyaW5nIGEgYmVsbCIgYW55d2F5Lg0KDQpUaGUg Zm9sbG93aW5nIGl0ZW1zIHNob3VsZCBiZSBjb250YWluZWQgaW4gZXZlcnkg YnVnIHJlcG9ydDoNCg0KICAgKiBUaGUgZXhhY3Qgc2VxdWVuY2Ugb2Ygc3Rl cHMgZnJvbSBwcm9ncmFtIHN0YXJ0dXAgbmVjZXNzYXJ5IHRvIHJlcHJvZHVj ZQ0KICAgICB0aGUgcHJvYmxlbS4gVGhpcyBzaG91bGQgYmUgc2VsZi1jb250 YWluZWQ7IGl0IGlzIG5vdCBlbm91Z2ggdG8gc2VuZCBpbg0KICAgICBhIGJh cmUgc2VsZWN0IHN0YXRlbWVudCB3aXRob3V0IHRoZSBwcmVjZWVkaW5nIGNy ZWF0ZSB0YWJsZSBhbmQgaW5zZXJ0DQogICAgIHN0YXRlbWVudHMsIGlmIHRo ZSBvdXRwdXQgc2hvdWxkIGRlcGVuZCBvbiB0aGUgZGF0YSBpbiB0aGUgdGFi bGVzLiBXZQ0KICAgICBkbyBub3QgaGF2ZSB0aGUgdGltZSB0byBkZWNvZGUg eW91ciBkYXRhYmFzZSBzY2hlbWEsIGFuZCBpZiB3ZSBhcmUNCiAgICAgc3Vw cG9zZWQgdG8gbWFrZSB1cCBvdXIgb3duIGRhdGEgd2Ugd291bGQgcHJvYmFi bHkgbWlzcyB0aGUgcHJvYmxlbS4NCiAgICAgVGhlIGJlc3QgZm9ybWF0IGZv ciBhIHRlc3QgY2FzZSBmb3IgcXVlcnktbGFuZ3VhZ2UgcmVsYXRlZCBwcm9i bGVtcyBpcw0KICAgICBhIGZpbGUgdGhhdCBjYW4gYmUgcnVuIHRocm91Z2gg dGhlIHBzcWwgZnJvbnRlbmQgdGhhdCBzaG93cyB0aGUNCiAgICAgcHJvYmxl bS4gKEJlIHN1cmUgdG8gbm90IGhhdmUgYW55dGhpbmcgaW4geW91ciB+Ly5w c3FscmMgc3RhcnR1cCBmaWxlLikNCiAgICAgWW91IGFyZSBlbmNvdXJhZ2Vk IHRvIG1pbmltaXplIHRoZSBzaXplIG9mIHlvdXIgZXhhbXBsZSwgYnV0IHRo aXMgaXMNCiAgICAgbm90IGFic29sdXRlbHkgbmVjZXNzYXJ5LiBJZiB0aGUg YnVnIGlzIHJlcHJvZHVjZWFibGUsIHdlJ2xsIGZpbmQgaXQNCiAgICAgZWl0 aGVyIHdheS4NCg0KICAgICBJZiB5b3VyIGFwcGxpY2F0aW9uIHVzZXMgc29t ZSBvdGhlciBjbGllbnQgaW50ZXJmYWNlLCBzdWNoIGFzIFBIUCwgdGhlbg0K ICAgICBwbGVhc2UgdHJ5IHRvIGlzb2xhdGUgdGhlIG9mZmVuZGluZyBxdWVy aWVzLiBXZSBwcm9iYWJseSB3b24ndCBzZXQgdXAgYQ0KICAgICB3ZWIgc2Vy dmVyIHRvIHJlcHJvZHVjZSB5b3VyIHByb2JsZW0uIEluIGFueSBjYXNlIHJl bWVtYmVyIHRvIHByb3ZpZGUNCiAgICAgdGhlIGV4YWN0IGlucHV0IGZpbGVz LCBkbyBub3QgZ3Vlc3MgdGhhdCB0aGUgcHJvYmxlbSBoYXBwZW5zIGZvciAi bGFyZ2UNCiAgICAgZmlsZXMiIG9yICJtaWQtc2l6ZSBkYXRhYmFzZXMiLCBl dGMuDQoNCiAgICogVGhlIG91dHB1dCB5b3UgZ290LiBQbGVhc2UgZG8gbm90 IHNheSB0aGF0IGl0ICJkaWRuJ3Qgd29yayIgb3INCiAgICAgImZhaWxlZCIu IElmIHRoZXJlIGlzIGFuIGVycm9yIG1lc3NhZ2UsIHNob3cgaXQsIGV2ZW4g aWYgeW91IGRvbid0DQogICAgIHVuZGVyc3RhbmQgaXQuIElmIHRoZSBwcm9n cmFtIHRlcm1pbmF0ZXMgd2l0aCBhbiBvcGVyYXRpbmcgc3lzdGVtDQogICAg IGVycm9yLCBzYXkgd2hpY2guIElmIG5vdGhpbmcgYXQgYWxsIGhhcHBlbnMs IHNheSBzby4gRXZlbiBpZiB0aGUgcmVzdWx0DQogICAgIG9mIHlvdXIgdGVz dCBjYXNlIGlzIGEgcHJvZ3JhbSBjcmFzaCBvciBvdGhlcndpc2Ugb2J2aW91 cyBpdCBtaWdodCBub3QNCiAgICAgaGFwcGVuIG9uIG91ciBwbGF0Zm9ybS4g VGhlIGVhc2llc3QgdGhpbmcgaXMgdG8gY29weSB0aGUgb3V0cHV0IGZyb20N CiAgICAgdGhlIHRlcm1pbmFsLCBpZiBwb3NzaWJsZS4NCg0KICAgICAgICAg IE5vdGU6IEluIGNhc2Ugb2YgZmF0YWwgZXJyb3JzLCB0aGUgZXJyb3IgbWVz c2FnZSBwcm92aWRlZCBieQ0KICAgICAgICAgIHRoZSBjbGllbnQgbWlnaHQg bm90IGNvbnRhaW4gYWxsIHRoZSBpbmZvcm1hdGlvbiBhdmFpbGFibGUuDQog ICAgICAgICAgSW4gdGhhdCBjYXNlLCBhbHNvIGxvb2sgYXQgdGhlIG91dHB1 dCBvZiB0aGUgZGF0YWJhc2Ugc2VydmVyLg0KICAgICAgICAgIElmIHlvdSBk byBub3Qga2VlcCB5b3VyIHNlcnZlciBvdXRwdXQsIHRoaXMgd291bGQgYmUg YSBnb29kDQogICAgICAgICAgdGltZSB0byBzdGFydCBkb2luZyBzby4NCg0K ICAgKiBUaGUgb3V0cHV0IHlvdSBleHBlY3RlZCBpcyB2ZXJ5IGltcG9ydGFu dCB0byBzdGF0ZS4gSWYgeW91IGp1c3Qgd3JpdGUNCiAgICAgIlRoaXMgY29t bWFuZCBnaXZlcyBtZSB0aGF0IG91dHB1dC4iIG9yICJUaGlzIGlzIG5vdCB3 aGF0IEkgZXhwZWN0ZWQuIiwNCiAgICAgd2UgbWlnaHQgcnVuIGl0IG91cnNl bHZlcywgc2NhbiB0aGUgb3V0cHV0LCBhbmQgdGhpbmsgaXQgbG9va3Mgb2th eSBhbmQNCiAgICAgaXMgZXhhY3RseSB3aGF0IHdlIGV4cGVjdGVkLiBXZSBz aG91bGRuJ3QgaGF2ZSB0byBzcGVuZCB0aGUgdGltZSB0bw0KICAgICBkZWNv ZGUgdGhlIGV4YWN0IHNlbWFudGljcyBiZWhpbmQgeW91ciBjb21tYW5kcy4g RXNwZWNpYWxseSByZWZyYWluDQogICAgIGZyb20gbWVyZWx5IHNheWluZyB0 aGF0ICJUaGlzIGlzIG5vdCB3aGF0IFNRTCBzYXlzL09yYWNsZSBkb2VzLiIN CiAgICAgRGlnZ2luZyBvdXQgdGhlIGNvcnJlY3QgYmVoYXZpb3IgZnJvbSBT UUwgaXMgbm90IGEgZnVuIHVuZGVydGFraW5nLCBub3INCiAgICAgZG8gd2Ug YWxsIGtub3cgaG93IGFsbCB0aGUgb3RoZXIgcmVsYXRpb25hbCBkYXRhYmFz ZXMgb3V0IHRoZXJlIGJlaGF2ZS4NCiAgICAgKElmIHlvdXIgcHJvYmxlbSBp cyBhIHByb2dyYW0gY3Jhc2ggeW91IGNhbiBvYnZpb3VzbHkgb21pdCB0aGlz IGl0ZW0uKQ0KDQogICAqIEFueSBjb21tYW5kIGxpbmUgb3B0aW9ucyBhbmQg b3RoZXIgc3RhcnR1cCBvcHRpb25zLCBpbmNsdWRpbmcgY29uY2VybmVkDQog ICAgIGVudmlyb25tZW50IHZhcmlhYmxlcyBvciBjb25maWd1cmF0aW9uIGZp bGVzIHRoYXQgeW91IGNoYW5nZWQgZnJvbSB0aGUNCiAgICAgZGVmYXVsdC4g QWdhaW4sIGJlIGV4YWN0LiBJZiB5b3UgYXJlIHVzaW5nIGEgcHJlLXBhY2th Z2VkIGRpc3RyaWJ1dGlvbg0KICAgICB0aGF0IHN0YXJ0cyB0aGUgZGF0YWJh c2Ugc2VydmVyIGF0IGJvb3QgdGltZSwgeW91IHNob3VsZCB0cnkgdG8gZmlu ZA0KICAgICBvdXQgaG93IHRoYXQgaXMgZG9uZS4NCg0KICAgKiBBbnl0aGlu ZyB5b3UgZGlkIGF0IGFsbCBkaWZmZXJlbnRseSBmcm9tIHRoZSBpbnN0YWxs YXRpb24gaW5zdHJ1Y3Rpb25zLg0KDQogICAqIFRoZSBQb3N0Z3JlU1FMIHZl cnNpb24uIFlvdSBjYW4gcnVuIHRoZSBjb21tYW5kIFNFTEVDVCB2ZXJzaW9u KCk7IHRvDQogICAgIGZpbmQgb3V0LiBJZiB0aGlzIGZ1bmN0aW9uIGRvZXMg bm90IGV4aXN0LCBzYXkgc28sIHRoZW4gd2Uga25vdyB0aGF0DQogICAgIHlv dXIgdmVyc2lvbiBpcyBvbGQgZW5vdWdoLiBJZiB5b3UgY2FuJ3Qgc3RhcnQg dXAgdGhlIHNlcnZlciBvciBhDQogICAgIGNsaWVudCwgbG9vayBpbnRvIHRo ZSBSRUFETUUgZmlsZSBpbiB0aGUgc291cmNlIGRpcmVjdG9yeSBvciBhdCB0 aGUNCiAgICAgbmFtZSBvZiB5b3VyIGRpc3RyaWJ1dGlvbiBmaWxlIG9yIHBh Y2thZ2UgbmFtZS4gSWYgeW91ciB2ZXJzaW9uIGlzDQogICAgIG9sZGVyIHRo YW4gNi41IHdlIHdpbGwgYWxtb3N0IGNlcnRhaW5seSB0ZWxsIHlvdSB0byB1 cGdyYWRlLiBUaGVyZSBhcmUNCiAgICAgdG9ucyBvZiBidWdzIGluIG9sZCB2 ZXJzaW9ucywgdGhhdCdzIHdoeSB3ZSB3cml0ZSBuZXcgb25lcy4NCg0KICAg ICBJZiB5b3UgcnVuIGEgcHJlLXBhY2thZ2VkIHZlcnNpb24sIHN1Y2ggYXMg UlBNcywgc2F5IHNvLCBpbmNsdWRpbmcgYW55DQogICAgIHN1YnZlcnNpb24g dGhlIHBhY2thZ2UgbWF5IGhhdmUuIElmIHlvdSBhcmUgdGFsa2luZyBhYm91 dCBhIENWUw0KICAgICBzbmFwc2hvdCwgbWVudGlvbiB0aGF0LCBpbmNsdWRp bmcgaXRzIGRhdGUgYW5kIHRpbWUuDQoNCiAgICogUGxhdGZvcm0gaW5mb3Jt YXRpb24uIFRoaXMgaW5jbHVkZXMgdGhlIGtlcm5lbCBuYW1lIGFuZCB2ZXJz aW9uLCBDDQogICAgIGxpYnJhcnksIHByb2Nlc3NvciwgbWVtb3J5IGluZm9y bWF0aW9uLiBJbiBtb3N0IGNhc2VzIGl0IGlzIHN1ZmZpY2llbnQNCiAgICAg dG8gcmVwb3J0IHRoZSB2ZW5kb3IgYW5kIHZlcnNpb24sIGJ1dCBkbyBub3Qg YXNzdW1lIGV2ZXJ5b25lIGtub3dzIHdoYXQNCiAgICAgZXhhY3RseSAiRGVi aWFuIiBjb250YWlucyBvciB0aGF0IGV2ZXJ5b25lIHJ1bnMgb24gUGVudGl1 bXMuIElmIHlvdQ0KICAgICBoYXZlIGluc3RhbGxhdGlvbiBwcm9ibGVtcyBp bmZvcm1hdGlvbiBhYm91dCBjb21waWxlcnMsIG1ha2UsIGV0Yy4gaXMNCiAg ICAgYWxzbyBuZWNlc3NhcnkuDQoNCkRvIG5vdCBiZSBhZnJhaWQgaWYgeW91 ciBidWcgcmVwb3J0IGJlY29tZXMgcmF0aGVyIGxlbmd0aHkuIFRoYXQgaXMg YSBmYWN0DQpvZiBsaWZlLiBJdCdzIGJldHRlciB0byByZXBvcnQgZXZlcnl0 aGluZyB0aGUgZmlyc3QgdGltZSB0aGFuIHVzIGhhdmluZyB0bw0Kc3F1ZWV6 ZSB0aGUgZmFjdHMgb3V0IG9mIHlvdS4gT24gdGhlIG90aGVyIGhhbmQsIGlm IHlvdXIgaW5wdXQgZmlsZXMgYXJlDQpodWdlLCBpdCBpcyBmYWlyIHRvIGFz ayBmaXJzdCB3aGV0aGVyIHNvbWVib2R5IGlzIGludGVyZXN0ZWQgaW4gbG9v a2luZyBpbnRvDQppdC4NCg0KRG8gbm90IHNwZW5kIGFsbCB5b3VyIHRpbWUg dG8gZmlndXJlIG91dCB3aGljaCBjaGFuZ2VzIGluIHRoZSBpbnB1dCBtYWtl IHRoZQ0KcHJvYmxlbSBnbyBhd2F5LiBUaGlzIHdpbGwgcHJvYmFibHkgbm90 IGhlbHAgc29sdmluZyBpdC4gSWYgaXQgdHVybnMgb3V0DQp0aGF0IHRoZSBi dWcgY2FuJ3QgYmUgZml4ZWQgcmlnaHQgYXdheSwgeW91IHdpbGwgc3RpbGwg aGF2ZSB0aW1lIHRvIGZpbmQgYW5kDQpzaGFyZSB5b3VyIHdvcmsgYXJvdW5k LiBBbHNvLCBvbmNlIGFnYWluLCBkbyBub3Qgd2FzdGUgeW91ciB0aW1lIGd1 ZXNzaW5nDQp3aHkgdGhlIGJ1ZyBleGlzdHMuIFdlJ2xsIGZpbmQgdGhhdCBv dXQgc29vbiBlbm91Z2guDQoNCldoZW4gd3JpdGluZyBhIGJ1ZyByZXBvcnQs IHBsZWFzZSBjaG9vc2Ugbm9uLWNvbmZ1c2luZyB0ZXJtaW5vbG9neS4gVGhl DQpzb2Z0d2FyZSBwYWNrYWdlIGFzIHN1Y2ggaXMgY2FsbGVkICJQb3N0Z3Jl U1FMIiwgc29tZXRpbWVzICJQb3N0Z3JlcyIgZm9yDQpzaG9ydC4gKFNvbWV0 aW1lcyB0aGUgYWJicmV2aWF0aW9uICJQZ3NxbCIgaXMgdXNlZCBidXQgZG9u J3QgZG8gdGhhdC4pIFdoZW4NCnlvdSBhcmUgc3BlY2lmaWNhbGx5IHRhbGtp bmcgYWJvdXQgdGhlIGJhY2tlbmQgc2VydmVyLCBtZW50aW9uIHRoYXQsIGRv bid0DQpqdXN0IHNheSAiUG9zdGdyZXMgY3Jhc2hlcyIuIFRoZSBpbnRlcmFj dGl2ZSBmcm9udGVuZCBpcyBjYWxsZWQgInBzcWwiIGFuZA0KaXMgZm9yIGFs bCBpbnRlbmRzIGFuZCBwdXJwb3NlcyBjb21wbGV0ZWx5IHNlcGFyYXRlIGZy b20gdGhlIGJhY2tlbmQuDQoNCldoZXJlIHRvIHJlcG9ydCBidWdzDQoNCklu IGdlbmVyYWwsIHNlbmQgYnVnIHJlcG9ydHMgdG8gPHBnc3FsLWJ1Z3NAcG9z dGdyZXNxbC5vcmc+LiBZb3UgYXJlIGludml0ZWQNCnRvIGZpbmQgYSBkZXNj cmlwdGl2ZSBzdWJqZWN0IGZvciB5b3VyIGVtYWlsIG1lc3NhZ2UsIHBlcmhh cHMgcGFydHMgb2YgdGhlDQplcnJvciBtZXNzYWdlLg0KDQpEbyBub3Qgc2Vu ZCBidWcgcmVwb3J0cyB0byBhbnkgb2YgdGhlIHVzZXIgbWFpbGluZyBsaXN0 cywgc3VjaCBhcyBwZ3NxbC1zcWwNCm9yIHBnc3FsLWdlbmVyYWwuIFRoZXNl IG1haWxpbmcgbGlzdHMgYXJlIGZvciBhbnN3ZXJpbmcgdXNlciBxdWVzdGlv bnMsDQp0aGVpciBzdWJzY3JpYmVycyBub3JtYWxseSBkbyBub3Qgd2lzaCB0 byByZWNlaXZlIGJ1ZyByZXBvcnRzLiBNb3JlDQppbXBvcnRhbnRseSwgdGhl eSBhcmUgdW5saWtlbHkgdG8gZml4IHRoZW0uDQoNCkFsc28sIHBsZWFzZSBk byBub3Qgc2VuZCByZXBvcnRzIHRvIDxwZ3NxbC1oYWNrZXJzQHBvc3RncmVz cWwub3JnPi4gVGhpcw0KbGlzdCBpcyBmb3IgZGlzY3Vzc2luZyB0aGUgZGV2 ZWxvcG1lbnQgb2YgUG9zdGdyZVNRTCwgaXQgd291bGQgYmUgbmljZSBpZiB3 ZQ0KY291bGQga2VlcCB0aGUgYnVnIHJlcG9ydHMgc2VwYXJhdGUuIFdlIG1p Z2h0IGNob29zZSB0YWtlIHVwIGEgZGlzY3Vzc2lvbg0KYWJvdXQgeW91ciBi dWcgcmVwb3J0IG9uIGl0LCBpZiB0aGUgYnVnIG5lZWRzIG1vcmUgcmV2aWV3 Lg0KDQpJZiB5b3UgaGF2ZSBhIHByb2JsZW0gd2l0aCB0aGUgZG9jdW1lbnRh dGlvbiwgc2VuZCBlbWFpbCB0bw0KPHBnc3FsLWRvY3NAcG9zdGdyZXNxbC5v cmc+LiBSZWZlciB0byB0aGUgZG9jdW1lbnQsIGNoYXB0ZXIsIGFuZCBzZWN0 aW9ucy4NCg0KSWYgeW91ciBidWcgaXMgYSBwb3J0YWJpbGl0eSBwcm9ibGVt IG9uIGEgbm9uLXN1cHBvcnRlZCBwbGF0Zm9ybSwgc2VuZCBtYWlsDQp0byA8 cGdzcWwtcG9ydHNAcG9zdGdyZXNxbC5vcmc+LCBzbyB3ZSAoYW5kIHlvdSkg Y2FuIHdvcmsgb24gcG9ydGluZw0KUG9zdGdyZVNRTCB0byB5b3VyIHBsYXRm b3JtLg0KDQogICAgIE5vdGU6IER1ZSB0byB0aGUgdW5mb3J0dW5hdGUgYW1v dW50IG9mIHNwYW0gZ29pbmcgYXJvdW5kLCBhbGwgb2YNCiAgICAgdGhlIGFi b3ZlIGVtYWlsIGFkZHJlc3NlcyBhcmUgY2xvc2VkIG1haWxpbmcgbGlzdHMu IFRoYXQgaXMsIHlvdQ0KICAgICBuZWVkIHRvIGJlIHN1YnNjcmliZWQgdG8g dGhlbSBpbiBvcmRlciB0byBiZSBhbGxvd2VkIHRvIHBvc3QuIElmDQogICAg IHlvdSBzaW1wbHkgd2FudCB0byBzZW5kIG1haWwgYnV0IGRvIG5vdCB3YW50 IHRvIHJlY2VpdmUgbGlzdA0KICAgICB0cmFmZmljLCB5b3UgY2FuIHN1YnNj cmliZSB0byB0aGUgc3BlY2lhbCBwZ3NxbC1sb29waG9sZSAibGlzdCIsDQog ICAgIHdoaWNoIGFsbG93cyB5b3UgdG8gcG9zdCB0byBhbGwgUG9zdGdyZVNR TCBtYWlsaW5nIGxpc3RzIHdpdGhvdXQNCiAgICAgcmVjZWl2aW5nIGFueSBt ZXNzYWdlcy4gU2VuZCBlbWFpbCB0bw0KICAgICA8cGdzcWwtbG9vcGhvbGUt cmVxdWVzdEBwb3N0Z3Jlc3FsLm9yZz4gdG8gc3Vic2NyaWJlLg0K --8323328-1743718507-952350422=:362--