postgresql/contrib
Tom Lane b3817f5f77 Improve hash_create()'s API for some added robustness.
Invent a new flag bit HASH_STRINGS to specify C-string hashing, which
was formerly the default; and add assertions insisting that exactly
one of the bits HASH_STRINGS, HASH_BLOBS, and HASH_FUNCTION be set.
This is in hopes of preventing recurrences of the type of oversight
fixed in commit a1b8aa1e4 (i.e., mistakenly omitting HASH_BLOBS).

Also, when HASH_STRINGS is specified, insist that the keysize be
more than 8 bytes.  This is a heuristic, but it should catch
accidental use of HASH_STRINGS for integer or pointer keys.
(Nearly all existing use-cases set the keysize to NAMEDATALEN or
more, so there's little reason to think this restriction should
be problematic.)

Tweak hash_create() to insist that the HASH_ELEM flag be set, and
remove the defaults it had for keysize and entrysize.  Since those
defaults were undocumented and basically useless, no callers
omitted HASH_ELEM anyway.

Also, remove memset's zeroing the HASHCTL parameter struct from
those callers that had one.  This has never been really necessary,
and while it wasn't a bad coding convention it was confusing that
some callers did it and some did not.  We might as well save a few
cycles by standardizing on "not".

Also improve the documentation for hash_create().

In passing, improve reinit.c's usage of a hash table by storing
the key as a binary Oid rather than a string; and, since that's
a temporary hash table, allocate it in CurrentMemoryContext for
neatness.

Discussion: https://postgr.es/m/590625.1607878171@sss.pgh.pa.us
2020-12-15 11:38:53 -05:00
..
adminpack Read until EOF vice stat-reported size in read_binary_file 2020-07-04 06:26:53 -04:00
amcheck Fix some typos 2020-11-14 11:43:10 +09:00
auth_delay
auto_explain
bloom Invent "amadjustmembers" AM method for validating opclass members. 2020-08-01 17:12:47 -04:00
bool_plperl
btree_gin
btree_gist Expose internal function for converting int64 to numeric 2020-09-09 20:16:28 +02:00
citext Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
cube Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
dblink Improve hash_create()'s API for some added robustness. 2020-12-15 11:38:53 -05:00
dict_int
dict_xsyn
earthdistance Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
file_fdw Remove leftover comments, left behind by removal of WITH OIDS. 2020-11-30 10:26:43 +02:00
fuzzystrmatch
hstore Allow subscripting of hstore values. 2020-12-11 18:58:21 -05:00
hstore_plperl Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
hstore_plpython
intagg Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
intarray Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
isn
jsonb_plperl Expose internal function for converting int64 to numeric 2020-09-09 20:16:28 +02:00
jsonb_plpython Support infinity and -infinity in the numeric data type. 2020-07-22 19:19:44 -04:00
lo
ltree Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
ltree_plpython
oid2name Remove arbitrary restrictions on password length. 2020-09-03 20:09:18 -04:00
old_snapshot Add new 'old_snapshot' contrib module. 2020-09-24 13:55:47 -04:00
pageinspect Remove unused parameter 2020-09-04 08:08:23 +02:00
passwordcheck passwordcheck: Log cracklib diagnostics 2020-08-28 08:18:24 +02:00
pg_buffercache
pg_freespacemap
pg_prewarm Fix and simplify some usages of TimestampDifference(). 2020-11-10 22:51:54 -05:00
pg_standby
pg_stat_statements Improve hash_create()'s API for some added robustness. 2020-12-15 11:38:53 -05:00
pg_surgery pg_surgery: Try to stabilize regression tests. 2020-09-18 13:26:48 -04:00
pg_trgm Handle equality operator in contrib/pg_trgm 2020-11-15 08:52:35 +03:00
pg_visibility snapshot scalability: Don't compute global horizons while building snapshots. 2020-08-12 16:03:49 -07:00
pgcrypto Improve some code around cryptohash functions 2020-12-14 12:38:13 +09:00
pgrowlocks
pgstattuple Redefine pg_class.reltuples to be -1 before the first VACUUM or ANALYZE. 2020-08-30 12:21:51 -04:00
postgres_fdw Improve hash_create()'s API for some added robustness. 2020-12-15 11:38:53 -05:00
seg Make contrib modules' installation scripts more secure. 2020-08-10 10:44:42 -04:00
sepgsql Fix expected output: the order of agg permission checks changed. 2020-11-24 12:50:16 +02:00
spi
sslinfo Use be_tls_* API for SSL information in sslinfo 2020-11-03 09:47:36 +01:00
start-scripts
tablefunc Improve hash_create()'s API for some added robustness. 2020-12-15 11:38:53 -05:00
tcn
test_decoding Fix 'skip-empty-xacts' option in test_decoding for streaming mode. 2020-11-17 12:14:53 +05:30
tsm_system_rows
tsm_system_time
unaccent
uuid-ossp Improve some code around cryptohash functions 2020-12-14 12:38:13 +09:00
vacuumlo Remove arbitrary restrictions on password length. 2020-09-03 20:09:18 -04:00
xml2
contrib-global.mk
Makefile Add new 'old_snapshot' contrib module. 2020-09-24 13:55:47 -04: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.

When building from the source distribution, these modules are not
built automatically, unless you build the "world" target.  You can
also build and install them all by running "make all" and "make
install" in this directory; or to build and install just one selected
module, do the same in that module's subdirectory.

Some directories supply new user-defined functions, operators, or
types.  To make use of one of these modules, after you have installed
the code you need to register the new SQL objects in the database
system by executing a CREATE EXTENSION command.  In a fresh database,
you can simply do

    CREATE EXTENSION module_name;

See the PostgreSQL documentation for more information about this
procedure.