postgresql/contrib
Tom Lane cd55aa2e00 Fix two new-in-9.0 bugs in hstore.
There was an incorrect Assert in hstoreValidOldFormat(), which would cause
immediate core dumps when attempting to work with pre-9.0 hstore data,
but of course only in an assert-enabled build.

Also, ghstore_decompress() incorrectly applied DatumGetHStoreP() to a datum
that wasn't actually an hstore, but rather a ghstore (ie, a gist signature
bitstring).  That used to be harmless, but could now result in misbehavior
if the hstore format conversion code happened to trigger.  In reality,
since ghstore is not marked toastable (and doesn't need to be), this
function is useless anyway; we can lobotomize it down to returning the
passed-in pointer.

Both bugs found by Andrew Gierth, though this isn't exactly his proposed
patch.
2010-09-16 02:54:01 +00:00
..
adminpack Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
auto_explain pgindent run for 9.0 2010-02-26 02:01:40 +00:00
btree_gin Remove all the special-case code for INT64_IS_BUSTED, per decision that 2010-01-07 04:53:35 +00:00
btree_gist Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
chkpass Remove wildly obsolete type attribute externallength from chkpass 2010-07-28 20:34:34 +00:00
citext Ooops, missed that a couple of contrib modules have calls to byteacmp. 2009-08-04 18:49:50 +00:00
cube Fix various instances of "the the". 2010-04-23 23:21:44 +00:00
dblink pgindent run for 9.0, second run 2010-07-06 19:19:02 +00:00
dict_int Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
dict_xsyn pgindent run for 9.0 2010-02-26 02:01:40 +00:00
earthdistance Fix a few single-file (MODULES, not MODULE_big) contrib makefiles that were 2010-07-05 23:15:56 +00:00
fuzzystrmatch Teach levenshtein() about multi-byte characters. 2010-08-02 23:20:23 +00:00
hstore Fix two new-in-9.0 bugs in hstore. 2010-09-16 02:54:01 +00:00
intagg Rewrite intagg/Makefile from scratch, to avoid copyright mention. 2010-02-05 03:06:30 +00:00
intarray Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
isn pgindent run for 9.0 2010-02-26 02:01:40 +00:00
lo Additional fixes for large object access control. 2009-12-14 00:39:11 +00:00
ltree Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
oid2name Add PGFILEDESC description to Makefiles for all /contrib executables. 2010-05-12 11:33:10 +00:00
pageinspect Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
passwordcheck pgindent run for 9.0 2010-02-26 02:01:40 +00:00
pg_archivecleanup Make pg_archivecleanup log messages more consistent. 2010-08-23 02:56:24 +00:00
pg_buffercache 8.4 pgindent run, with new combined Linux/FreeBSD/MinGW typedef list 2009-06-11 14:49:15 +00:00
pg_freespacemap 8.4 pgindent run, with new combined Linux/FreeBSD/MinGW typedef list 2009-06-11 14:49:15 +00:00
pg_standby Fix typos in comments, spotted by Josh Kupershmidt. 2010-05-15 09:31:57 +00:00
pg_stat_statements Modify ShmemInitStruct and ShmemInitHash to throw errors internally, 2010-04-28 16:54:16 +00:00
pg_trgm Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
pg_upgrade Modify pg_upgrade to set/restore all environment variables related to 2010-09-07 14:10:30 +00:00
pg_upgrade_support pgindent run for 9.0, second run 2010-07-06 19:19:02 +00:00
pgbench Get rid of a bunch of dubious error handling code in pgbench by just erroring 2010-08-12 21:10:59 +00:00
pgcrypto Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
pgrowlocks 8.4 pgindent run, with new combined Linux/FreeBSD/MinGW typedef list 2009-06-11 14:49:15 +00:00
pgstattuple Ensure that contrib/pgstattuple functions respond to cancel interrupts 2010-04-02 16:16:51 +00:00
seg Derived files that are shipped in the distribution used to be built in the 2009-08-28 20:26:19 +00:00
spi Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
sslinfo Add ssl_cipher() and ssl_version() functions to contrib/sslinfo. 2010-07-27 23:43:42 +00:00
start-scripts Modify freebsd start script to just exit 0 with message. 2010-02-23 22:17:25 +00:00
tablefunc Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
test_parser Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
tsearch2 Remove extra newlines at end and beginning of files, add missing newlines 2010-08-19 05:57:36 +00:00
unaccent Standardize get_whatever_oid functions for other object types. 2010-08-05 15:25:36 +00:00
uuid-ossp Update copyright for the year 2010. 2010-01-02 16:58:17 +00:00
vacuumlo Add PGFILEDESC description to Makefiles for all /contrib executables. 2010-05-12 11:33:10 +00:00
xml2 Add xml_is_well_formed, xml_is_well_formed_document, xml_is_well_formed_content 2010-08-13 18:36:26 +00:00
Makefile New contrib module for use as an archive_cleanup_command, or as a 2010-06-14 16:17:56 +00:00
README Hook pg_upgrade into the contrib makefile structure so it gets built 2010-05-12 16:50:58 +00:00
contrib-global.mk Some marginal tweaks to make 'make installcheck' mostly work when 2005-09-27 17:43:31 +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.

User documentation for each module appears in the main SGML documentation.

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:
------

adminpack -
	File and log manipulation routines, used by pgAdmin
	by Dave Page <dpage@vale-housing.co.uk>

auto_explain -
	Log EXPLAIN output for long-running queries
	by Takahiro Itagaki <itagaki.takahiro@oss.ntt.co.jp>

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

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>

citext -
	A case-insensitive character string datatype
	by David E. Wheeler <david@kineticode.com>

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

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

dict_int -
	Text search dictionary template for integers
	by Sergey Karpov <karpov@sao.ru>

dict_xsyn -
	Text search dictionary template for extended synonym processing
	by Sergey Karpov <karpov@sao.ru>

earthdistance -
	Functions for computing distances between two points on Earth
        by Bruno Wolff III <bruno@wolff.to> and Hal Snyder <hal@vailsys.com>

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

hstore -
	Module for storing (key, value) pairs
	by Oleg Bartunov <oleg@sai.msu.su> and Teodor Sigaev <teodor@sigaev.ru>

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>

isn -
	PostgreSQL type extensions for ISBN, ISSN, ISMN, EAN13 product numbers
	by Germ<72>n M<>ndez Bravo (Kronuz) <kronuz@hotmail.com>

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>

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

pageinspect -
	Allows inspection of database pages
	Heikki Linnakangas <heikki@enterprisedb.com>

passwordcheck -
	Simple password strength checker
	Laurenz Albe <laurenz.albe@wien.gv.at>

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

pg_freespacemap -
	Displays the contents of the free space map (FSM)
	by Mark Kirkwood <markir@paradise.net.nz>

pg_standby -
	Sample archive_command for warm standby operation
	by Simon Riggs <simon@2ndquadrant.com>

pg_stat_statements -
	Track statement execution times across a whole database cluster
	by Takahiro Itagaki <itagaki.takahiro@oss.ntt.co.jp>

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 -
	Support for in-place upgrade between major releases of PostgreSQL
	Bruce Momjian <bruce@momjian.us> and others

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

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

pgrowlocks -
	A function to return row locking information
	by Tatsuo Ishii <ishii@sraoss.co.jp>

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

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

spi -
	Various trigger functions, examples for using SPI.

sslinfo -
	Functions to get information about SSL certificates
	by Victor Wagner <vitus@cryptocom.ru>

start-scripts - 
	Scripts for starting the server at boot time on various platforms.

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

test_parser -
	Sample text search parser
	by Sergey Karpov <karpov@sao.ru>

tsearch2 -
	Compatibility package for the pre-8.3 implementation of text search.
	Pavel Stehule <pavel.stehule@gmail.com>, based on code originally by
	Teodor Sigaev <teodor@sigaev.ru> and Oleg Bartunov <oleg@sai.msu.su>.

unaccent -
	Unaccent dictionary for text search
	Teodor Sigaev <teodor@sigaev.ru> and Oleg Bartunov <oleg@sai.msu.su>.

uuid-ossp -
	UUID generation functions
	by Peter Eisentraut <peter_e@gmx.net>

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

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