<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Additional Supplied Modules</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REV="MADE" HREF="mailto:pgsql-docs@postgresql.org"><LINK REL="HOME" TITLE="PostgreSQL 8.4.8 Documentation" HREF="index.html"><LINK REL="UP" TITLE="Appendixes" HREF="appendixes.html"><LINK REL="PREVIOUS" TITLE="Postgres95 Release 0.01" HREF="release-0-01.html"><LINK REL="NEXT" TITLE="adminpack" HREF="adminpack.html"><LINK REL="STYLESHEET" TYPE="text/css" HREF="stylesheet.css"><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"><META NAME="creation" CONTENT="2011-04-15T03:27:09"></HEAD ><BODY CLASS="APPENDIX" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="5" ALIGN="center" VALIGN="bottom" >PostgreSQL 8.4.8 Documentation</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="release-0-01.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="release.html" >Fast Backward</A ></TD ><TD WIDTH="60%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="top" ><A HREF="external-projects.html" >Fast Forward</A ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="top" ><A HREF="adminpack.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="APPENDIX" ><H1 ><A NAME="CONTRIB" ></A >Appendix F. Additional Supplied Modules</H1 ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT >F.1. <A HREF="adminpack.html" >adminpack</A ></DT ><DT >F.2. <A HREF="auto-explain.html" >auto_explain</A ></DT ><DT >F.3. <A HREF="btree-gin.html" >btree_gin</A ></DT ><DT >F.4. <A HREF="btree-gist.html" >btree_gist</A ></DT ><DT >F.5. <A HREF="chkpass.html" >chkpass</A ></DT ><DT >F.6. <A HREF="citext.html" >citext</A ></DT ><DT >F.7. <A HREF="cube.html" >cube</A ></DT ><DT >F.8. <A HREF="dblink.html" >dblink</A ></DT ><DT >F.9. <A HREF="dict-int.html" >dict_int</A ></DT ><DT >F.10. <A HREF="dict-xsyn.html" >dict_xsyn</A ></DT ><DT >F.11. <A HREF="earthdistance.html" >earthdistance</A ></DT ><DT >F.12. <A HREF="fuzzystrmatch.html" >fuzzystrmatch</A ></DT ><DT >F.13. <A HREF="hstore.html" >hstore</A ></DT ><DT >F.14. <A HREF="intagg.html" >intagg</A ></DT ><DT >F.15. <A HREF="intarray.html" >intarray</A ></DT ><DT >F.16. <A HREF="isn.html" >isn</A ></DT ><DT >F.17. <A HREF="lo.html" >lo</A ></DT ><DT >F.18. <A HREF="ltree.html" >ltree</A ></DT ><DT >F.19. <A HREF="oid2name.html" >oid2name</A ></DT ><DT >F.20. <A HREF="pageinspect.html" >pageinspect</A ></DT ><DT >F.21. <A HREF="pgbench.html" >pgbench</A ></DT ><DT >F.22. <A HREF="pgbuffercache.html" >pg_buffercache</A ></DT ><DT >F.23. <A HREF="pgcrypto.html" >pgcrypto</A ></DT ><DT >F.24. <A HREF="pgfreespacemap.html" >pg_freespacemap</A ></DT ><DT >F.25. <A HREF="pgrowlocks.html" >pgrowlocks</A ></DT ><DT >F.26. <A HREF="pgstandby.html" >pg_standby</A ></DT ><DT >F.27. <A HREF="pgstatstatements.html" >pg_stat_statements</A ></DT ><DT >F.28. <A HREF="pgstattuple.html" >pgstattuple</A ></DT ><DT >F.29. <A HREF="pgtrgm.html" >pg_trgm</A ></DT ><DT >F.30. <A HREF="seg.html" >seg</A ></DT ><DT >F.31. <A HREF="contrib-spi.html" >spi</A ></DT ><DT >F.32. <A HREF="sslinfo.html" >sslinfo</A ></DT ><DT >F.33. <A HREF="tablefunc.html" >tablefunc</A ></DT ><DT >F.34. <A HREF="test-parser.html" >test_parser</A ></DT ><DT >F.35. <A HREF="tsearch2.html" >tsearch2</A ></DT ><DT >F.36. <A HREF="uuid-ossp.html" >uuid-ossp</A ></DT ><DT >F.37. <A HREF="vacuumlo.html" >vacuumlo</A ></DT ><DT >F.38. <A HREF="xml2.html" >xml2</A ></DT ></DL ></DIV ><P > This appendix contains information regarding the modules that can be found in the <TT CLASS="LITERAL" >contrib</TT > directory of the <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > distribution. These include 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. </P ><P > When building from the source distribution, these modules are not built automatically. You can build and install all of them by running: </P><PRE CLASS="SCREEN" ><KBD CLASS="USERINPUT" >gmake</KBD > <KBD CLASS="USERINPUT" >gmake install</KBD ></PRE ><P> in the <TT CLASS="LITERAL" >contrib</TT > directory of a configured source tree; or to build and install just one selected module, do the same in that module's subdirectory. Many of the modules have regression tests, which can be executed by running: </P><PRE CLASS="SCREEN" ><KBD CLASS="USERINPUT" >gmake installcheck</KBD ></PRE ><P> once you have a <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > server running. (Note that <TT CLASS="LITERAL" >gmake check</TT > is not supported; you must have an operational database server to perform these tests, and you must have built and installed the module(s) to be tested.) </P ><P > If you are using a pre-packaged version of <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN >, these modules are typically made available as a separate subpackage, such as <TT CLASS="LITERAL" >postgresql-contrib</TT >. </P ><P > Many modules 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 objects in the database system by running the SQL commands in the <TT CLASS="LITERAL" >.sql</TT > file supplied by the module. For example, </P><PRE CLASS="PROGRAMLISTING" >psql -d dbname -f <TT CLASS="REPLACEABLE" ><I >SHAREDIR</I ></TT >/contrib/<TT CLASS="REPLACEABLE" ><I >module</I ></TT >.sql</PRE ><P> Here, <TT CLASS="REPLACEABLE" ><I >SHAREDIR</I ></TT > means the installation's <SPAN CLASS="QUOTE" >"share"</SPAN > directory (<TT CLASS="LITERAL" >pg_config --sharedir</TT > will tell you what this is). In most cases the script must be run by a database superuser. </P ><P > You need to run the <TT CLASS="LITERAL" >.sql</TT > file in each database that you want the module's facilities to be available in. Alternatively, run it in database <TT CLASS="LITERAL" >template1</TT > so that the module will be copied into subsequently-created databases by default. </P ><P > You can modify the first command in the <TT CLASS="LITERAL" >.sql</TT > file to determine which schema within the database the module's objects will be created in. By default, they will be placed in <TT CLASS="LITERAL" >public</TT >. </P ><P > After a major-version upgrade of <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN >, run the installation script again, even though the module's objects might have been brought forward from the old installation by dump and restore. This ensures that any new functions will be available and any needed corrections will be applied. </P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="release-0-01.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="adminpack.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><SPAN CLASS="PRODUCTNAME" >Postgres95</SPAN > Release 0.01</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="appendixes.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >adminpack</TD ></TR ></TABLE ></DIV ></BODY ></HTML >