Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1tFqX9-00GgBx-5L for pgsql-docs@arkaria.postgresql.org; Tue, 26 Nov 2024 08:02:55 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1tFqX7-005KLD-TB for pgsql-docs@arkaria.postgresql.org; Tue, 26 Nov 2024 08:02:53 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1tFbh4-00GFTr-H1 for pgsql-docs@lists.postgresql.org; Mon, 25 Nov 2024 16:12:10 +0000 Received: from mahout.postgresql.org ([2001:4800:3e1:1::227]) by magus.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1tFbh0-003nJx-Vm for pgsql-docs@lists.postgresql.org; Mon, 25 Nov 2024 16:12:09 +0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=postgresql.org; s=20171124; h=Message-ID:Date:Reply-To:Cc:From:To:Subject: MIME-Version:Content-Type:Sender:Content-Transfer-Encoding:Content-ID: Content-Description:In-Reply-To:References; bh=EFvu8fnCnLW17cWtypcoMkfzJqV2UhMSvmlovdnxLJc=; b=3PMUOceeLQDeBVqEY6+pQP8f+m dz/jCZrEbjdUuqOvtxYMbn0TH6NlUQ0txnohDzQas/imPRquLg8H1YQsAlKiETbX87yHrf/cxbEhd weNc00B7gdQ5DSw7JjThaL/LKxOgPeQQjzPoaPpI74VPesfuzJLu068a5oU5qUH18EQLLeaMgtPgh ydY5uKVT8A+dAt9XbQ/tJtvpqxCvKLmR/ARyiXUF16lvAPmSFqZ/THD9aLLRIUKGLuLTeDZWGyDq5 CUU/Etn2T30x/rvz5V2u/rKuVp5K4ExuU3x3n2GuI3I83Xs4TUHqBwMtX3wietDhzLmCv+XCYnJph 8BGXwYOw==; Received: from wrigleys.postgresql.org ([2a02:16a8:dc51::60]) by mahout.postgresql.org with esmtps (TLS1.3) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1tFbgz-00BdrX-4d for pgsql-docs@lists.postgresql.org; Mon, 25 Nov 2024 16:12:05 +0000 Received: from localhost ([127.0.0.1] helo=wrigleys.postgresql.org) by wrigleys.postgresql.org with esmtp (Exim 4.94.2) (envelope-from ) id 1tFbgx-000nnQ-Cw for pgsql-docs@lists.postgresql.org; Mon, 25 Nov 2024 16:12:03 +0000 Content-Type: multipart/mixed; boundary="===============8756746481293257845==" MIME-Version: 1.0 Subject: Creation of extensions and Backend C/C++ functions. To: pgsql-docs@lists.postgresql.org From: PG Doc comments form Cc: tconorkerrigan@gmail.com Reply-To: tconorkerrigan@gmail.com, pgsql-docs@lists.postgresql.org Date: Mon, 25 Nov 2024 16:11:38 +0000 Message-ID: <173255109822.2092749.3336245972313402414@wrigleys.postgresql.org> X-Auto-Response-Suppress: All Auto-Submitted: auto-generated List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --===============8756746481293257845== Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 VGhlIGZvbGxvd2luZyBkb2N1bWVudGF0aW9uIGNvbW1lbnQgaGFzIGJlZW4gbG9nZ2VkIG9uIHRo ZSB3ZWJzaXRlOgoKUGFnZTogaHR0cHM6Ly93d3cucG9zdGdyZXNxbC5vcmcvZG9jcy8xNy94ZnVu Yy1jLmh0bWwKRGVzY3JpcHRpb246CgpJIGNhbiBhbmQgaGF2ZSBpbXBsZW1lbnRlZCB0cmlpdmlh bCBDL0MrKyBmdW5jdGlvbnMgdG8gY29tcGlsZSBhbmQgbGluayB0bwpQb3N0Z3Jlcy4gQW4gZXhh bXBsZSBmb2xsb3dzOi0gDQoNCiNpbmNsdWRlICJwb3N0Z3Jlcy5oIg0KI2luY2x1ZGUgImZtZ3Iu aCINCg0KI2lmZGVmIFBHX01PRFVMRV9NQUdJQw0KUEdfTU9EVUxFX01BR0lDOw0KI2VuZGlmDQoN Ci8qIEZ1bmN0aW9uIGRlY2xhcmF0aW9uICovDQpQR19GVU5DVElPTl9JTkZPX1YxKGFsd2F5c190 cnVlKTsNCg0KLyogVGhlIGZ1bmN0aW9uIGFsd2F5c1RydWUoKSAtIHJldHVybnMgdHJ1ZSAqLw0K RGF0dW0NCmFsd2F5c190cnVlKFBHX0ZVTkNUSU9OX0FSR1MpDQp7DQogICAgUEdfUkVUVVJOX0JP T0wodHJ1ZSk7DQp9DQoNCg0KUEdfRlVOQ1RJT05fSU5GT19WMShpc19XSU4zMik7DQpEYXR1bQ0K aXNfV0lOMzIoUEdfRlVOQ1RJT05fQVJHUykNCnsNCiAgICBib29sIHJlc3VsdCA9IGZhbHNlOw0K I2lmZGVmIFdJTjMyDQogICAgcmVzdWx0ID0gdHJ1ZTsNCiNlbmRpZg0KICAgIFBHX1JFVFVSTl9C T09MKHJlc3VsdCk7DQp9DQpUaGlzIGNvbXBpbGVzIGFuZCBpcyBsaW5rZWQgYXMgZm9sbG93czot DQpjYyAtZlBJQyAtSUM6L21zeXM2NC9taW5ndzY0L2luY2x1ZGUvUE9TVEdSfjEvc2VydmVyIC1z aGFyZWQgLW8gZXh0LmRsbCAqLmMKLUkvbWluZ3c2NC9pbmNsdWRlL1BPU1RHUn4xDQpjcCBleHQu ZGxsICBDOi9tc3lzNjQvbWluZ3c2NC9saWIvUE9TVEdSfjEvLiAgICAgDQooZnJvbSAgcGdfY29u ZmlnIC0tcGtnbGliZGlyDQpDOi9tc3lzNjQvbWluZ3c2NC9saWIvUE9TVEdSfjEpIA0KSSB1c2Ug cGdBZG1pbiB0byBjcmVhdGUgb3IgcmVwbGFjZSBmdW5jdGlvbnMgLi4uLiBUaGV5IHdvcmsgY29y cmVjdGx5LiANCg0KVGhlIHByb2JsZW0gSSBoYXZlIGFyaXNlcyB3aGVuIEkgdHJ5IHRvIGFkZCBh IG5vbiB0cml2aWFsIGZ1bmN0aW9uIGZvciBteQphcHAuIFRoZSBmdW5jdGlvbiBpcyA6LQ0KICAg UEdfRlVOQ1RJT05fSU5GT19WMShzZXRfYmFsYW5jZV93aXRoX2lkKTsNCiAgICBEYXR1bSBzZXRf YmFsYW5jZV93aXRoX2lkKFBHX0ZVTkNUSU9OX0FSR1MpIHsNCiAgICAgICAgaW50MzIgICBhcmcw ID0gUEdfR0VUQVJHX0lOVDMyKDApOw0KICAgICAgICBib29sIGFyZzEgPSBQR19HRVRBUkdfQk9P TCgxKTsNCiAgICAgICAgYm9vbCByZXN1bHQgPSBzZXRfYmFsYW5jZV93aXRoX2lkX2NwcCAoYXJn MCwgYXJnMSwgMC4wMGYpOw0KICAgICAgICBQR19SRVRVUk5fQk9PTChyZXN1bHQpOw0KICAgIH0N CiAgICBUaGUgZnVuY3Rpb24gc2V0X2JhbGFuY2Vfd2l0aF9pZF9jcHAgaXMgZGVmaW5lZCBpbiBh IHdyYXBwZXIgdGh1czotIA0KI2luY2x1ZGUgIkxlZGdlck9yQWNjb3VudC5oIg0KI2luY2x1ZGUg IkxlZGdlck9yQWNjb3VudFdyYXBwZXIuaCINCg0KI2luY2x1ZGUgPGlvc3RyZWFtPg0KDQovLyBE ZWZpbmUgdGhlIEMtY29tcGF0aWJsZSB3cmFwcGVyIGZ1bmN0aW9ucw0KLy8gSW1wbGVtZW50IHRo ZSBDLWNvbXBhdGlibGUgd3JhcHBlciBmdW5jdGlvbnMNCi8vZXh0ZXJuICJDIiB7DQoNCiAgIA0K ICAgIC8vIERlZmluZSB0aGUgQysrIHdyYXBwZXIgZnVuY3Rpb24gZm9yIFBvc3RncmVTUUwNCiAg ICBib29sIHNldF9iYWxhbmNlX3dpdGhfaWRfY3BwKGludCBpZCwgYm9vbCBkZWJpdCwgZG91Ymxl IGJhbGFuY2UpIHsNCiAgICAgICAgZG91YmxlIG5ld19iYWxhbmNlID0gMC4wMGY7DQogICAgICAg IHRyeSB7DQogICAgICAgICAgICAvLyBDcmVhdGUgYW4gaW5zdGFuY2Ugb2YgdGhlIExlZGdlck9y QWNjb3VudCBjbGFzcw0KICAgICAgICAgICAgTGVkZ2VyT3JBY2NvdW50IGxlZGdlcihpZCk7DQog ICAgICAgICAgICBUcmFuc2FjdGlvblR5cGUgdHJhbnNhY3Rpb25UeXBlID0gZGViaXQ/IERFQklU OiBDUkVESVQ7DQoNCiAgICAgICAgICAgIC8vIENhbGwgdGhlIHNldEJhbGFuY2UgbWV0aG9kIG9u IHRoZSBjbGFzcw0KICAgICAgICAgICAgbmV3X2JhbGFuY2UgPSBsZWRnZXIuc2V0QmFsYW5jZShi YWxhbmNlLCB0cmFuc2FjdGlvblR5cGUpOw0KICAgICAgICB9IGNhdGNoIChjb25zdCBzdGQ6OmV4 Y2VwdGlvbiYgZSkgew0KICAgICAgICAgICAgc3RkOjpjZXJyIDw8ICJzZXRfYmFsYW5jZV93aXRo X2lkX2NwcCAtPiAiIDw8IGUud2hhdCgpIDw8CnN0ZDo6ZW5kbDsNCiAgICAgICAgfQ0KDQogICAg ICAgIC8vIFJldHVybiB0cnVlIGlmIGJhbGFuY2UgaXMgc2V0IHN1Y2Nlc3NmdWxseQ0KICAgICAg ICByZXR1cm4gKG5ld19iYWxhbmNlID49IDAuMDBmKTsgDQogICAgfSAgICANCk5vdyBJIGNhbiBj b21waWxlIHRoZSBmdW5jdGlvbiBpbnRvIGEgc2hhcmVkIGxpYnJhcnkgYnV0IHdoZW4gSSB0cnkg dG8gbG9hZAppdCwgcG9zdGdyZXMgY2Fubm90IGRvIHNvLiBwZ0FkbWluOi0+DQpERUJVRzogIFN0 YXJ0VHJhbnNhY3Rpb24oMSkgbmFtZTogdW5uYW1lZDsgYmxvY2tTdGF0ZTogREVGQVVMVDsgc3Rh dGU6CklOUFJPR1JFU1MsIHhpZC9zdWJpZC9jaWQ6IDAvMS8wDQpMT0c6ICBzdGF0ZW1lbnQ6IExP QUQgJ215X2V4dGVuc2lvbic7DQoNCkRFQlVHOiAgZmluZF9pbl9keW5hbWljX2xpYnBhdGg6IHRy eWluZyAiQzovUHJvZ3JhbQpGaWxlcy9Qb3N0Z3JlU1FMLzE3L2xpYi9teV9leHRlbnNpb24iDQpE RUJVRzogIG1hcHBlZCB3aW4zMiBlcnJvciBjb2RlIDIgdG8gMg0KREVCVUc6ICBtYXBwZWQgd2lu MzIgZXJyb3IgY29kZSAyIHRvIDINCkRFQlVHOiAgZmluZF9pbl9keW5hbWljX2xpYnBhdGg6IHRy eWluZwoiQzovbXN5czY0L21pbmd3NjQvbGliL1BPU1RHUn4xL215X2V4dGVuc2lvbiINCkRFQlVH OiAgbWFwcGVkIHdpbjMyIGVycm9yIGNvZGUgMiB0byAyDQpERUJVRzogIG1hcHBlZCB3aW4zMiBl cnJvciBjb2RlIDIgdG8gMg0KREVCVUc6ICBmaW5kX2luX2R5bmFtaWNfbGlicGF0aDogdHJ5aW5n CiJDOi9teXN5czY0L21pbmd3NjQvbGliL215X2V4dGVuc2lvbiINCkRFQlVHOiAgbWFwcGVkIHdp bjMyIGVycm9yIGNvZGUgMyB0byAyDQpERUJVRzogIG1hcHBlZCB3aW4zMiBlcnJvciBjb2RlIDMg dG8gMg0KREVCVUc6ICBmaW5kX2luX2R5bmFtaWNfbGlicGF0aDogdHJ5aW5nICJDOi9Qcm9ncmFt CkZpbGVzL1Bvc3RncmVTUUwvMTcvbGliL215X2V4dGVuc2lvbi5kbGwiDQpERUJVRzogIG1hcHBl ZCB3aW4zMiBlcnJvciBjb2RlIDIgdG8gMg0KREVCVUc6ICBtYXBwZWQgd2luMzIgZXJyb3IgY29k ZSAyIHRvIDINCkRFQlVHOiAgZmluZF9pbl9keW5hbWljX2xpYnBhdGg6IHRyeWluZwoiQzovbXN5 czY0L21pbmd3NjQvbGliL1BPU1RHUn4xL215X2V4dGVuc2lvbi5kbGwiDQoNCkVSUk9SOiAgY291 bGQgbm90IGxvYWQgbGlicmFyeQoiQzovbXN5czY0L21pbmd3NjQvbGliL1BPU1RHUn4xL215X2V4 dGVuc2lvbi5kbGwiOiBUaGUgc3BlY2lmaWVkIG1vZHVsZQpjb3VsZCBub3QgYmUgZm91bmQuIA0K DQpTUUwgc3RhdGU6IDU4UDAxDQpBbmQgaW4gcGdBZG1pbiA6LSANCi0tIExvYWQgdGhlIHNoYXJl ZCBsaWJyYXJ5IGlmIG5vdCBhbHJlYWR5IGxvYWRlZA0KQ1JFQVRFIEZVTkNUSU9OIHNldF9iYWxh bmNlX3dpdGhfaWQoaW50LCBkb3VibGUgcHJlY2lzaW9uLCBib29sZWFuKQ0KUkVUVVJOUyBib29s ZWFuDQpBUyAnbXlfZXh0ZW5zaW9uJywgJ3NldF9iYWxhbmNlX3dpdGhfaWQnDQpMQU5HVUFHRSBj IFNUUklDVDsNCg0KYW5kIGlkZW50aWNhbGx5LCBwZ0FkbWluIC0+DQpERUJVRzogIFN0YXJ0VHJh bnNhY3Rpb24oMSkgbmFtZTogdW5uYW1lZDsgYmxvY2tTdGF0ZTogREVGQVVMVDsgc3RhdGU6CklO UFJPR1JFU1MsIHhpZC9zdWJpZC9jaWQ6IDAvMS8wDQpMT0c6ICBzdGF0ZW1lbnQ6IC0tIExvYWQg dGhlIHNoYXJlZCBsaWJyYXJ5IGlmIG5vdCBhbHJlYWR5IGxvYWRlZA0KQ1JFQVRFIEZVTkNUSU9O IHNldF9iYWxhbmNlX3dpdGhfaWQoaW50LCBkb3VibGUgcHJlY2lzaW9uLCBib29sZWFuKQ0KUkVU VVJOUyBib29sZWFuDQpBUyAnbXlfZXh0ZW5zaW9uJywgJ3NldF9iYWxhbmNlX3dpdGhfaWQnDQpM QU5HVUFHRSBjIFNUUklDVDsNCkRFQlVHOiAgZmluZF9pbl9keW5hbWljX2xpYnBhdGg6IHRyeWlu ZyAiQzovUHJvZ3JhbQpGaWxlcy9Qb3N0Z3JlU1FMLzE3L2xpYi9teV9leHRlbnNpb24iDQpERUJV RzogIG1hcHBlZCB3aW4zMiBlcnJvciBjb2RlIDIgdG8gMg0KREVCVUc6ICBtYXBwZWQgd2luMzIg ZXJyb3IgY29kZSAyIHRvIDINCkRFQlVHOiAgZmluZF9pbl9keW5hbWljX2xpYnBhdGg6IHRyeWlu ZwoiQzovbXN5czY0L21pbmd3NjQvbGliL1BPU1RHUn4xL215X2V4dGVuc2lvbiINCkRFQlVHOiAg bWFwcGVkIHdpbjMyIGVycm9yIGNvZGUgMiB0byAyDQpERUJVRzogIG1hcHBlZCB3aW4zMiBlcnJv ciBjb2RlIDIgdG8gMg0KREVCVUc6ICBmaW5kX2luX2R5bmFtaWNfbGlicGF0aDogdHJ5aW5nCiJD Oi9teXN5czY0L21pbmd3NjQvbGliL215X2V4dGVuc2lvbiINCkRFQlVHOiAgbWFwcGVkIHdpbjMy IGVycm9yIGNvZGUgMyB0byAyDQpERUJVRzogIG1hcHBlZCB3aW4zMiBlcnJvciBjb2RlIDMgdG8g Mg0KREVCVUc6ICBmaW5kX2luX2R5bmFtaWNfbGlicGF0aDogdHJ5aW5nICJDOi9Qcm9ncmFtCkZp bGVzL1Bvc3RncmVTUUwvMTcvbGliL215X2V4dGVuc2lvbi5kbGwiDQpERUJVRzogIG1hcHBlZCB3 aW4zMiBlcnJvciBjb2RlIDIgdG8gMg0KREVCVUc6ICBtYXBwZWQgd2luMzIgZXJyb3IgY29kZSAy IHRvIDINCkRFQlVHOiAgZmluZF9pbl9keW5hbWljX2xpYnBhdGg6IHRyeWluZwoiQzovbXN5czY0 L21pbmd3NjQvbGliL1BPU1RHUn4xL215X2V4dGVuc2lvbi5kbGwiDQoNCkVSUk9SOiAgY291bGQg bm90IGxvYWQgbGlicmFyeQoiQzovbXN5czY0L21pbmd3NjQvbGliL1BPU1RHUn4xL215X2V4dGVu c2lvbi5kbGwiOiBUaGUgc3BlY2lmaWVkIG1vZHVsZQpjb3VsZCBub3QgYmUgZm91bmQuIA0KU1FM IHN0YXRlOiA1OFAwMQ0KDQpteV9leHRlbnNpb24gaXMgaW4gdGhlIGxhdHRlciBkaXIuDQoNCkNh biB5b3Ugb2ZmZXIgYW55IGFkdmljZSBvciBoZWxwIHRvIGZpeCB0aGlzIGlzc3VlPw0KVGhhbmsg eW91IGluIGFkdmFuY2UsDQpDb25vcgo= --===============8756746481293257845==--