postgres/contrib
Tom Lane cd00406774 Replace time_t with pg_time_t (same values, but always int64) in on-disk
data structures and backend internal APIs.  This solves problems we've seen
recently with inconsistent layout of pg_control between machines that have
32-bit time_t and those that have already migrated to 64-bit time_t.  Also,
we can get out from under the problem that Windows' Unix-API emulation is not
consistent about the width of time_t.

There are a few remaining places where local time_t variables are used to hold
the current or recent result of time(NULL).  I didn't bother changing these
since they do not affect any cross-module APIs and surely all platforms will
have 64-bit time_t before overflow becomes an actual risk.  time_t should
be avoided for anything visible to extension modules, however.
2008-02-17 02:09:32 +00:00
..
adminpack Update copyrights in source tree to 2008. 2008-01-01 19:46:01 +00:00
btree_gist Fix a few contrib regression test scripts that hadn't gotten the word 2007-11-13 06:29:04 +00:00
chkpass Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
cube pgindent run for 8.3. 2007-11-15 21:14:46 +00:00
dblink Use an indexscan not a heapscan to search pg_index in get_pkey_attnames. 2008-01-14 02:49:47 +00:00
dict_int Fix some missed copyright updates. 2008-01-01 20:31:21 +00:00
dict_xsyn Fix some missed copyright updates. 2008-01-01 20:31:21 +00:00
earthdistance Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
fuzzystrmatch Update copyrights in source tree to 2008. 2008-01-01 19:46:01 +00:00
hstore Run pgindent on remaining files now that LOOPBYTE is a usable macro. 2007-11-16 01:12:24 +00:00
intagg Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
intarray Run pgindent on remaining files now that LOOPBYTE is a usable macro. 2007-11-16 01:12:24 +00:00
isn Update copyrights in source tree to 2008. 2008-01-01 19:46:01 +00:00
lo Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
ltree Run pgindent on remaining files now that LOOPBYTE is a usable macro. 2007-11-16 01:12:24 +00:00
oid2name Remove the -P options of oid2name and pgbench, as they are security 2007-12-11 02:31:49 +00:00
pageinspect Fix some missed copyright updates. 2008-01-01 20:31:21 +00:00
pg_buffercache pgindent run for 8.3. 2007-11-15 21:14:46 +00:00
pg_freespacemap Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
pg_standby pgindent run for 8.3. 2007-11-15 21:14:46 +00:00
pg_trgm Fix completely-bogus volatility markings on pg_trgm functions. 2007-12-09 02:22:46 +00:00
pgbench Remove the -P options of oid2name and pgbench, as they are security 2007-12-11 02:31:49 +00:00
pgcrypto Replace time_t with pg_time_t (same values, but always int64) in on-disk 2008-02-17 02:09:32 +00:00
pgrowlocks Avoid incrementing the CommandCounter when CommandCounterIncrement is called 2007-11-30 21:22:54 +00:00
pgstattuple Fix pgstat_heap() to not be broken by syncscans starting from a block 2008-01-14 02:53:31 +00:00
seg Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
spi Remove contrib/spi/preprocessor, which has been uninteresting ever 2007-12-03 19:20:40 +00:00
sslinfo Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
start-scripts Remove inappropriate cd commands, per David Wheeler. Also make 2008-01-16 21:00:25 +00:00
tablefunc Update copyrights in source tree to 2008. 2008-01-01 19:46:01 +00:00
test_parser Fix some missed copyright updates. 2008-01-01 20:31:21 +00:00
tsearch2 Update copyrights in source tree to 2008. 2008-01-01 19:46:01 +00:00
uuid-ossp Fix some missed copyright updates. 2008-01-01 20:31:21 +00:00
vacuumlo Update copyrights in source tree to 2008. 2008-01-01 19:46:01 +00:00
xml2 Add CVS version labels to all install/uninstall scripts. 2007-11-13 04:24:29 +00:00
Makefile Re-add contrib/tsearch2 to the set of buildable contrib modules. 2007-11-13 21:04:45 +00:00
README Correct misattribution of earthdistance module --- according to its 2007-12-04 23:45:01 +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>

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>

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>

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

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

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>