postgresql/contrib
Tom Lane fa5e44017a Adjust the API for aggregate function calls so that a C-coded function
can tell whether it is being used as an aggregate or not.  This allows
such a function to avoid re-pallocing a pass-by-reference transition
value; normally it would be unsafe for a function to scribble on an input,
but in the aggregate case it's safe to reuse the old transition value.
Make int8inc() do this.  This gets a useful improvement in the speed of
COUNT(*), at least on narrow tables (it seems to be swamped by I/O when
the table rows are wide).  Per a discussion in early December with
Neil Conway.  I also fixed int_aggregate.c to check this, thereby
turning it into something approaching a supportable technique instead
of being a crude hack.
2005-03-12 20:25:06 +00:00
..
adddepend make sure the $Id tags are converted to $PostgreSQL as well ... 2003-11-29 22:41:33 +00:00
array Minor wording improvements. 2003-09-13 17:33:46 +00:00
btree_gist Simplify/clean up code for varlena types 2005-03-01 15:40:04 +00:00
chkpass Make sure contrib C functions are marked strict where needed. 2005-01-29 22:35:02 +00:00
cube Add comparison file for exp-three-digits formatting. 2004-10-24 22:11:37 +00:00
dbase Adjust comments previously moved to column 1 by pgident. 2004-10-07 15:21:58 +00:00
dblink Some more missed copyright notices. Many of these look like they 2005-01-01 20:44:34 +00:00
dbmirror Contrib build fixes: 2004-11-04 06:09:26 +00:00
dbsize Add routines to dbsize to return the index size and total relation size. 2005-02-26 23:31:15 +00:00
earthdistance Refer to ll_to_earth() function by its actual name. 2004-10-04 22:52:47 +00:00
findoidjoins Update copyrights that were missed. 2005-01-01 05:43:09 +00:00
fulltextindex > Please find enclose a submission to fix these problems. 2004-08-20 20:13:10 +00:00
fuzzystrmatch The attached patch implements the soundex difference function which 2005-01-26 08:04:04 +00:00
intagg Adjust the API for aggregate function calls so that a C-coded function 2005-03-12 20:25:06 +00:00
intarray Add intset() to README 2005-01-27 14:14:01 +00:00
ipc_check start of an admin tool for FreeBSD to help configure shared memory for 2001-02-27 15:37:39 +00:00
isbn_issn Make sure contrib C functions are marked strict where needed. 2005-01-29 22:35:02 +00:00
lo Make sure contrib C functions are marked strict where needed. 2005-01-29 22:35:02 +00:00
ltree Standardize on using the Min, Max, and Abs macros that are in our c.h file, 2004-10-21 19:28:36 +00:00
mSQL-interface Consistently use geteuid() not getuid(); there were a few places deviating 2005-01-08 22:51:15 +00:00
mac make sure the $Id tags are converted to $PostgreSQL as well ... 2003-11-29 22:41:33 +00:00
miscutil Make sure contrib C functions are marked strict where needed. 2005-01-29 22:35:02 +00:00
mysql Fix build break, per report from Kris Jurka. Rename README to README.mysql, 2004-11-04 09:12:35 +00:00
noupdate > Please find enclose a submission to fix these problems. 2004-08-20 20:13:10 +00:00
oid2name Fix a potential free() of string literal in oid2name, per report from 2004-12-02 06:14:50 +00:00
oracle Triggers should return TRIGGER not OPAQUE. Looks like this script got 2004-12-30 00:30:40 +00:00
pg_autovacuum Adjust Windows autovacuum service to retry for up to 5 minutes waiting 2005-01-26 22:25:13 +00:00
pg_buffercache Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 15:36:24 +00:00
pg_dumplo Make pg_dumplo schema-aware. Karel Zak 2004-11-28 23:49:49 +00:00
pg_trgm This adds mention of my latest tweak to the tsearch2/pg_trgm 2004-11-27 00:01:02 +00:00
pg_upgrade $Header: -> $PostgreSQL Changes ... 2003-11-29 19:52:15 +00:00
pgbench This patch makes some cleanups to contrib/ to silence some sparse 2004-11-09 06:09:40 +00:00
pgcrypto Some builds (depends on crypto engine support?) of OpenSSL 2005-03-12 06:53:54 +00:00
pgstattuple Repair possible failure to update hint bits back to disk, per 2004-10-15 22:40:29 +00:00
reindexdb Repair quoting sloppiness, lack of schema awareness in reindexdb. 2003-05-19 01:00:12 +00:00
rtree_gist Trivial fixes for English grammar in contrib/btree_gist and contrib/rtree_gist 2004-11-01 11:11:13 +00:00
seg Add comparison file for exp-three-digits formatting. 2004-10-24 21:54:57 +00:00
spi Miscellaneous Cygwin build fixes from Reini Urban. 2004-11-17 17:46:24 +00:00
start-scripts Adjust postmaster to recognize that a lockfile containing its parent's PID 2004-10-01 18:30:25 +00:00
string Standardize on using the Min, Max, and Abs macros that are in our c.h file, 2004-10-21 19:28:36 +00:00
tablefunc Some more missed copyright notices. Many of these look like they 2005-01-01 20:44:34 +00:00
tips > Please find enclose a submission to fix these problems. 2004-08-20 20:13:10 +00:00
tools Another round of those unportable config/build changes :-/ 2000-07-09 13:14:19 +00:00
tsearch This patch makes some cleanups to contrib/ to silence some sparse 2004-11-09 06:09:40 +00:00
tsearch2 Prevent rank change in case of duplicate search terms 2005-03-05 15:48:32 +00:00
userlock Make sure contrib C functions are marked strict where needed. 2005-01-29 22:35:02 +00:00
vacuumlo Tag appropriate files for rc3 2004-12-31 22:04:05 +00:00
xml Contrib build fixes: 2004-11-04 06:09:26 +00:00
xml2 Update version restriction on xml2. 2005-01-22 22:14:14 +00:00
Makefile Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 15:36:24 +00:00
README Add pg_buffercache contrib module, from Mark Kirkwood. 2005-03-12 15:36:24 +00:00
contrib-global.mk PostgreSQL extension makefile framework ("pgxs"), by Fabien Coelho, with 2004-07-30 12:26:40 +00:00

README

The PostgreSQL contrib tree
---------------------------

This subtree contains porting tools, analysis utilities, and plug-in
features that are not part of the core PostgreSQL system, mainly because
they address a limited audience or are too experimental to be part of
the main source tree.  This does not preclude their usefulness.

Each subdirectory contains a README file with information about the
module.  Most items can be built with `gmake all' and installed with
`gmake install' in the usual fashion, after you have run the `configure'
script in the top-level directory.  Some directories supply new
user-defined functions, operators, or types.  In these cases, after you have
installed the files you need to register the new entities in the database
system by running the commands in the supplied .sql file.  For example,

	$ psql -d dbname -f module.sql

See the PostgreSQL documentation for more information about this
procedure.


Index:
------

adddepend -
	Add object dependency information to pre-7.3 objects.
	by Rod Taylor <rbt@rbt.ca>

array -
	Array iterator functions (now obsolete due to backend improvements)
	by Massimo Dal Zotto <dz@cs.unitn.it>

btree_gist -
	Support for emulating BTREE indexing in GiST
	by Oleg Bartunov <oleg@sai.msu.su> and Teodor Sigaev <teodor@sigaev.ru>

chkpass -
	An auto-encrypted password datatype
	by D'Arcy J.M. Cain <darcy@druid.net>

cube -
	Multidimensional-cube datatype (GiST indexing example)
	by Gene Selkov, Jr. <selkovjr@mcs.anl.gov>

dbase -
	Converts from dbase/xbase to PostgreSQL
	by Maarten.Boekhold <Maarten.Boekhold@reuters.com>,
	   Frank Koormann <fkoorman@usf.uni-osnabrueck.de>,
	   Ivan Baldo <lubaldo@adinet.com.uy>

dblink -
	Allows remote query execution
	by Joe Conway <mail@joeconway.com>

dbmirror -
	Replication server
	by Steven Singer <ssinger@navtechinc.com>

dbsize -
	Reports database and table disk space
	by Peter Eisentraut <peter_e@gmx.net>

earthdistance -
	Operator for computing earth distance for two points
	by Hal Snyder <hal@vailsys.com>

findoidjoins -
	Finds the joins used by oid columns by examining the actual
	values in the oid columns and row oids.
	by Bruce Momjian <pgman@candle.pha.pa.us>

fulltextindex -
	Full text indexing using triggers
	by Maarten Boekhold <maartenb@dutepp0.et.tudelft.nl>

fuzzystrmatch -
	Levenshtein, metaphone, and soundex fuzzy string matching
	by Joe Conway <mail@joeconway.com>, Joel Burton <jburton@scw.org>

intagg -
	Integer aggregator
	by mlw <markw@mohawksoft.com>

intarray -
	Index support for arrays of int4, using GiST
	by Teodor Sigaev <teodor@sigaev.ru> and Oleg Bartunov <oleg@sai.msu.su>

ipc_check -
	Simple test script to help in configuring IPC.
	FreeBSD only, for now.

isbn_issn -
	PostgreSQL type extensions for ISBN (books) and ISSN (serials)
	by Garrett A. Wollman <wollman@khavrinen.lcs.mit.edu>

lo -
	Large Object maintenance
	by Peter Mount <peter@retep.org.uk> 

ltree -
	Tree-like data structures
	by Teodor Sigaev <teodor@sigaev.ru> and Oleg Bartunov <oleg@sai.msu.su>

mSQL-interface -
	mSQL API translation library
	by Aldrin Leal <aldrin@americasnet.com>

mac -
	Support functions for MAC address types
	by Lawrence E. Rosenman <ler@lerctr.org>

miscutil -
	PostgreSQL assert checking and various utility functions
	by Massimo Dal Zotto <dz@cs.unitn.it>

mysql -
	Utility to convert MySQL schema dumps to SQL92 and PostgreSQL
	by Thomas Lockhart <lockhart@alumni.caltech.edu>
	   Max Rudensky <fonin@ziet.zhitomir.ua>
	   Valentine Danilchuk <valdan@ziet.zhitomir.ua>

noupdate -
	Trigger to prevent updates on single columns

oid2name - 
	Maps numeric files to table names
	by B Palmer <bpalmer@crimelabs.net>

oracle -
	Converts Oracle database schema to PostgreSQL
	by Gilles Darold <gilles@darold.net>

pg_autovacuum -
	Automatically performs vacuum
	by Matthew T. O'Connor <matthew@zeut.net>

pg_buffercache -
	Real time queries on the shared buffer cache
	by Mark Kirkwood <markir@paradise.net.nz>

pg_dumplo -
	Dump large objects
	by Karel Zak <zakkr@zf.jcu.cz>

pg_trgm -
	Functions for determining the similarity of text based on trigram
	matching.
	by Oleg Bartunov <oleg@sai.msu.su> and Teodor Sigaev <teodor@sigaev.ru>

pg_upgrade -
	Upgrade from previous PostgreSQL version without pg_dump/reload
	by Bruce Momjian <pgman@candle.pha.pa.us>

pgbench -
	TPC-B like benchmarking tool
	by Tatsuo Ishii <t-ishii@sra.co.jp>

pgcrypto -
	Cryptographic functions
	by Marko Kreen <marko@l-t.ee>

pgstattuple -
	A function to return statistics about "dead" tuples and free
	space within a table
	by Tatsuo Ishii <t-ishii@sra.co.jp>

reindexdb - 
	Reindexes a database
	by Shaun Thomas <sthomas@townnews.com>

rtree_gist -
	Support for emulating RTREE indexing in GiST
	by Oleg Bartunov <oleg@sai.msu.su> and Teodor Sigaev <teodor@sigaev.ru>

seg -
	Confidence-interval datatype (GiST indexing example)
	by Gene Selkov, Jr. <selkovjr@mcs.anl.gov>

spi -
	Various trigger functions, examples for using SPI.

start-scripts - 
	Scripts for starting the server at boot time.
	
string -
	C-like input/output conversion routines for strings
	by Massimo Dal Zotto <dz@cs.unitn.it>

tablefunc -
	Examples of functions returning tables
	by Joe Conway <mail@joeconway.com>

tips/apache_logging -
	Getting Apache to log to PostgreSQL
	by Terry Mackintosh <terry@terrym.com>

tools -
	Assorted developer tools
	by Massimo Dal Zotto <dz@cs.unitn.it>

tsearch -
	Full-text-index support using GiST (obsolete version)
	by Teodor Sigaev <teodor@sigaev.ru> and Oleg Bartunov
	<oleg@sai.msu.su>.

tsearch2 -
	Full-text-index support using GiST
	by Teodor Sigaev <teodor@sigaev.ru> and Oleg Bartunov
	<oleg@sai.msu.su>.

userlock -
	User locks
	by Massimo Dal Zotto <dz@cs.unitn.it>

vacuumlo -
	Remove orphaned large objects
	by Peter T Mount <peter@retep.org.uk>

xml -
	Storing XML in PostgreSQL (obsolete version)
	by John Gray <jgray@azuli.co.uk>

xml2 -
	Storing XML in PostgreSQL
	by John Gray <jgray@azuli.co.uk>