2010-09-20 22:08:53 +02:00
|
|
|
<!-- doc/src/sgml/filelist.sgml -->
|
2000-11-24 18:44:22 +01:00
|
|
|
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY history SYSTEM "history.sgml">
|
|
|
|
<!ENTITY info SYSTEM "info.sgml">
|
|
|
|
<!ENTITY intro SYSTEM "intro.sgml">
|
|
|
|
<!ENTITY legal SYSTEM "legal.sgml">
|
|
|
|
<!ENTITY notation SYSTEM "notation.sgml">
|
|
|
|
<!ENTITY problems SYSTEM "problems.sgml">
|
2000-11-24 18:44:22 +01:00
|
|
|
|
|
|
|
<!-- tutorial -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY advanced SYSTEM "advanced.sgml">
|
|
|
|
<!ENTITY query SYSTEM "query.sgml">
|
|
|
|
<!ENTITY start SYSTEM "start.sgml">
|
2000-11-24 18:44:22 +01:00
|
|
|
|
2001-09-03 01:27:50 +02:00
|
|
|
<!-- currently unused, but contains some interesting information -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY sql SYSTEM "sql.sgml">
|
2001-09-03 01:27:50 +02:00
|
|
|
|
2000-11-24 18:44:22 +01:00
|
|
|
<!-- user's guide -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY array SYSTEM "array.sgml">
|
|
|
|
<!ENTITY datatype SYSTEM "datatype.sgml">
|
|
|
|
<!ENTITY ddl SYSTEM "ddl.sgml">
|
|
|
|
<!ENTITY dml SYSTEM "dml.sgml">
|
|
|
|
<!ENTITY func SYSTEM "func.sgml">
|
|
|
|
<!ENTITY indices SYSTEM "indices.sgml">
|
|
|
|
<!ENTITY mvcc SYSTEM "mvcc.sgml">
|
|
|
|
<!ENTITY perform SYSTEM "perform.sgml">
|
|
|
|
<!ENTITY queries SYSTEM "queries.sgml">
|
2011-11-14 21:15:53 +01:00
|
|
|
<!ENTITY rangetypes SYSTEM "rangetypes.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY rowtypes SYSTEM "rowtypes.sgml">
|
|
|
|
<!ENTITY syntax SYSTEM "syntax.sgml">
|
|
|
|
<!ENTITY textsearch SYSTEM "textsearch.sgml">
|
|
|
|
<!ENTITY typeconv SYSTEM "typeconv.sgml">
|
2000-11-24 18:44:22 +01:00
|
|
|
|
|
|
|
<!-- administrator's guide -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY backup SYSTEM "backup.sgml">
|
|
|
|
<!ENTITY charset SYSTEM "charset.sgml">
|
|
|
|
<!ENTITY client-auth SYSTEM "client-auth.sgml">
|
|
|
|
<!ENTITY diskusage SYSTEM "diskusage.sgml">
|
|
|
|
<!ENTITY high-availability SYSTEM "high-availability.sgml">
|
|
|
|
<!ENTITY installation SYSTEM "installation.sgml">
|
|
|
|
<!ENTITY installw SYSTEM "install-windows.sgml">
|
|
|
|
<!ENTITY maintenance SYSTEM "maintenance.sgml">
|
|
|
|
<!ENTITY manage-ag SYSTEM "manage-ag.sgml">
|
|
|
|
<!ENTITY monitoring SYSTEM "monitoring.sgml">
|
|
|
|
<!ENTITY regress SYSTEM "regress.sgml">
|
|
|
|
<!ENTITY recovery-config SYSTEM "recovery-config.sgml">
|
|
|
|
<!ENTITY runtime SYSTEM "runtime.sgml">
|
|
|
|
<!ENTITY config SYSTEM "config.sgml">
|
|
|
|
<!ENTITY user-manag SYSTEM "user-manag.sgml">
|
|
|
|
<!ENTITY wal SYSTEM "wal.sgml">
|
2000-11-24 18:44:22 +01:00
|
|
|
|
|
|
|
<!-- programmer's guide -->
|
Background worker processes
Background workers are postmaster subprocesses that run arbitrary
user-specified code. They can request shared memory access as well as
backend database connections; or they can just use plain libpq frontend
database connections.
Modules listed in shared_preload_libraries can register background
workers in their _PG_init() function; this is early enough that it's not
necessary to provide an extra GUC option, because the necessary extra
resources can be allocated early on. Modules can install more than one
bgworker, if necessary.
Care is taken that these extra processes do not interfere with other
postmaster tasks: only one such process is started on each ServerLoop
iteration. This means a large number of them could be waiting to be
started up and postmaster is still able to quickly service external
connection requests. Also, shutdown sequence should not be impacted by
a worker process that's reasonably well behaved (i.e. promptly responds
to termination signals.)
The current implementation lets worker processes specify their start
time, i.e. at what point in the server startup process they are to be
started: right after postmaster start (in which case they mustn't ask
for shared memory access), when consistent state has been reached
(useful during recovery in a HOT standby server), or when recovery has
terminated (i.e. when normal backends are allowed).
In case of a bgworker crash, actions to take depend on registration
data: if shared memory was requested, then all other connections are
taken down (as well as other bgworkers), just like it were a regular
backend crashing. The bgworker itself is restarted, too, within a
configurable timeframe (which can be configured to be never).
More features to add to this framework can be imagined without much
effort, and have been discussed, but this seems good enough as a useful
unit already.
An elementary sample module is supplied.
Author: Álvaro Herrera
This patch is loosely based on prior patches submitted by KaiGai Kohei,
and unsubmitted code by Simon Riggs.
Reviewed by: KaiGai Kohei, Markus Wanner, Andres Freund,
Heikki Linnakangas, Simon Riggs, Amit Kapila
2012-12-06 18:57:52 +01:00
|
|
|
<!ENTITY bgworker SYSTEM "bgworker.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY dfunc SYSTEM "dfunc.sgml">
|
|
|
|
<!ENTITY ecpg SYSTEM "ecpg.sgml">
|
|
|
|
<!ENTITY extend SYSTEM "extend.sgml">
|
|
|
|
<!ENTITY external-projects SYSTEM "external-projects.sgml">
|
|
|
|
<!ENTITY func-ref SYSTEM "func-ref.sgml">
|
|
|
|
<!ENTITY infoschema SYSTEM "information_schema.sgml">
|
|
|
|
<!ENTITY libpq SYSTEM "libpq.sgml">
|
|
|
|
<!ENTITY lobj SYSTEM "lobj.sgml">
|
|
|
|
<!ENTITY rules SYSTEM "rules.sgml">
|
|
|
|
<!ENTITY spi SYSTEM "spi.sgml">
|
|
|
|
<!ENTITY trigger SYSTEM "trigger.sgml">
|
2012-07-18 16:16:16 +02:00
|
|
|
<!ENTITY event-trigger SYSTEM "event-trigger.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY xaggr SYSTEM "xaggr.sgml">
|
|
|
|
<!ENTITY xfunc SYSTEM "xfunc.sgml">
|
|
|
|
<!ENTITY xindex SYSTEM "xindex.sgml">
|
|
|
|
<!ENTITY xplang SYSTEM "xplang.sgml">
|
|
|
|
<!ENTITY xoper SYSTEM "xoper.sgml">
|
|
|
|
<!ENTITY xtypes SYSTEM "xtypes.sgml">
|
|
|
|
<!ENTITY plperl SYSTEM "plperl.sgml">
|
|
|
|
<!ENTITY plpython SYSTEM "plpython.sgml">
|
|
|
|
<!ENTITY plsql SYSTEM "plpgsql.sgml">
|
|
|
|
<!ENTITY pltcl SYSTEM "pltcl.sgml">
|
2000-11-24 18:44:22 +01:00
|
|
|
|
2003-10-23 00:28:10 +02:00
|
|
|
<!-- reference pages -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY % allfiles SYSTEM "ref/allfiles.sgml">
|
2003-10-23 00:28:10 +02:00
|
|
|
%allfiles;
|
|
|
|
|
2000-11-24 18:44:22 +01:00
|
|
|
<!-- developer's guide -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY arch-dev SYSTEM "arch-dev.sgml">
|
|
|
|
<!ENTITY bki SYSTEM "bki.sgml">
|
|
|
|
<!ENTITY catalogs SYSTEM "catalogs.sgml">
|
|
|
|
<!ENTITY geqo SYSTEM "geqo.sgml">
|
|
|
|
<!ENTITY gist SYSTEM "gist.sgml">
|
2011-12-17 22:41:16 +01:00
|
|
|
<!ENTITY spgist SYSTEM "spgist.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY gin SYSTEM "gin.sgml">
|
|
|
|
<!ENTITY planstats SYSTEM "planstats.sgml">
|
|
|
|
<!ENTITY indexam SYSTEM "indexam.sgml">
|
|
|
|
<!ENTITY nls SYSTEM "nls.sgml">
|
|
|
|
<!ENTITY plhandler SYSTEM "plhandler.sgml">
|
|
|
|
<!ENTITY fdwhandler SYSTEM "fdwhandler.sgml">
|
2014-03-18 18:20:01 +01:00
|
|
|
<!ENTITY logicaldecoding SYSTEM "logicaldecoding.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY protocol SYSTEM "protocol.sgml">
|
|
|
|
<!ENTITY sources SYSTEM "sources.sgml">
|
|
|
|
<!ENTITY storage SYSTEM "storage.sgml">
|
2003-10-23 00:28:10 +02:00
|
|
|
|
2007-11-11 00:30:46 +01:00
|
|
|
<!-- contrib information -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY contrib SYSTEM "contrib.sgml">
|
|
|
|
<!ENTITY adminpack SYSTEM "adminpack.sgml">
|
|
|
|
<!ENTITY auth-delay SYSTEM "auth-delay.sgml">
|
|
|
|
<!ENTITY auto-explain SYSTEM "auto-explain.sgml">
|
|
|
|
<!ENTITY btree-gin SYSTEM "btree-gin.sgml">
|
|
|
|
<!ENTITY btree-gist SYSTEM "btree-gist.sgml">
|
|
|
|
<!ENTITY chkpass SYSTEM "chkpass.sgml">
|
|
|
|
<!ENTITY citext SYSTEM "citext.sgml">
|
|
|
|
<!ENTITY cube SYSTEM "cube.sgml">
|
|
|
|
<!ENTITY dblink SYSTEM "dblink.sgml">
|
|
|
|
<!ENTITY dict-int SYSTEM "dict-int.sgml">
|
|
|
|
<!ENTITY dict-xsyn SYSTEM "dict-xsyn.sgml">
|
|
|
|
<!ENTITY dummy-seclabel SYSTEM "dummy-seclabel.sgml">
|
|
|
|
<!ENTITY earthdistance SYSTEM "earthdistance.sgml">
|
|
|
|
<!ENTITY file-fdw SYSTEM "file-fdw.sgml">
|
|
|
|
<!ENTITY fuzzystrmatch SYSTEM "fuzzystrmatch.sgml">
|
|
|
|
<!ENTITY hstore SYSTEM "hstore.sgml">
|
|
|
|
<!ENTITY intagg SYSTEM "intagg.sgml">
|
|
|
|
<!ENTITY intarray SYSTEM "intarray.sgml">
|
|
|
|
<!ENTITY isn SYSTEM "isn.sgml">
|
|
|
|
<!ENTITY lo SYSTEM "lo.sgml">
|
|
|
|
<!ENTITY ltree SYSTEM "ltree.sgml">
|
|
|
|
<!ENTITY oid2name SYSTEM "oid2name.sgml">
|
|
|
|
<!ENTITY pageinspect SYSTEM "pageinspect.sgml">
|
|
|
|
<!ENTITY passwordcheck SYSTEM "passwordcheck.sgml">
|
|
|
|
<!ENTITY pgbench SYSTEM "pgbench.sgml">
|
|
|
|
<!ENTITY pgarchivecleanup SYSTEM "pgarchivecleanup.sgml">
|
|
|
|
<!ENTITY pgbuffercache SYSTEM "pgbuffercache.sgml">
|
|
|
|
<!ENTITY pgcrypto SYSTEM "pgcrypto.sgml">
|
|
|
|
<!ENTITY pgfreespacemap SYSTEM "pgfreespacemap.sgml">
|
2013-12-20 14:08:01 +01:00
|
|
|
<!ENTITY pgprewarm SYSTEM "pgprewarm.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY pgrowlocks SYSTEM "pgrowlocks.sgml">
|
|
|
|
<!ENTITY pgstandby SYSTEM "pgstandby.sgml">
|
|
|
|
<!ENTITY pgstatstatements SYSTEM "pgstatstatements.sgml">
|
|
|
|
<!ENTITY pgstattuple SYSTEM "pgstattuple.sgml">
|
|
|
|
<!ENTITY pgtestfsync SYSTEM "pgtestfsync.sgml">
|
2012-03-27 22:14:00 +02:00
|
|
|
<!ENTITY pgtesttiming SYSTEM "pgtesttiming.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY pgtrgm SYSTEM "pgtrgm.sgml">
|
|
|
|
<!ENTITY pgupgrade SYSTEM "pgupgrade.sgml">
|
2013-02-22 20:46:24 +01:00
|
|
|
<!ENTITY pgxlogdump SYSTEM "pg_xlogdump.sgml">
|
2013-02-21 11:26:23 +01:00
|
|
|
<!ENTITY postgres-fdw SYSTEM "postgres-fdw.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY seg SYSTEM "seg.sgml">
|
|
|
|
<!ENTITY contrib-spi SYSTEM "contrib-spi.sgml">
|
|
|
|
<!ENTITY sepgsql SYSTEM "sepgsql.sgml">
|
|
|
|
<!ENTITY sslinfo SYSTEM "sslinfo.sgml">
|
|
|
|
<!ENTITY tablefunc SYSTEM "tablefunc.sgml">
|
2012-01-20 05:15:15 +01:00
|
|
|
<!ENTITY tcn SYSTEM "tcn.sgml">
|
Introduce logical decoding.
This feature, building on previous commits, allows the write-ahead log
stream to be decoded into a series of logical changes; that is,
inserts, updates, and deletes and the transactions which contain them.
It is capable of handling decoding even across changes to the schema
of the effected tables. The output format is controlled by a
so-called "output plugin"; an example is included. To make use of
this in a real replication system, the output plugin will need to be
modified to produce output in the format appropriate to that system,
and to perform filtering.
Currently, information can be extracted from the logical decoding
system only via SQL; future commits will add the ability to stream
changes via walsender.
Andres Freund, with review and other contributions from many other
people, including Álvaro Herrera, Abhijit Menon-Sen, Peter Gheogegan,
Kevin Grittner, Robert Haas, Heikki Linnakangas, Fujii Masao, Abhijit
Menon-Sen, Michael Paquier, Simon Riggs, Craig Ringer, and Steve
Singer.
2014-03-03 22:32:18 +01:00
|
|
|
<!ENTITY test-decoding SYSTEM "test-decoding.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY test-parser SYSTEM "test-parser.sgml">
|
2014-01-14 21:58:15 +01:00
|
|
|
<!ENTITY test-shm-mq SYSTEM "test-shm-mq.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY tsearch2 SYSTEM "tsearch2.sgml">
|
|
|
|
<!ENTITY unaccent SYSTEM "unaccent.sgml">
|
|
|
|
<!ENTITY uuid-ossp SYSTEM "uuid-ossp.sgml">
|
|
|
|
<!ENTITY vacuumlo SYSTEM "vacuumlo.sgml">
|
|
|
|
<!ENTITY xml2 SYSTEM "xml2.sgml">
|
2007-11-11 00:30:46 +01:00
|
|
|
|
2003-10-23 00:28:10 +02:00
|
|
|
<!-- appendixes -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY contacts SYSTEM "contacts.sgml">
|
|
|
|
<!ENTITY datetime SYSTEM "datetime.sgml">
|
|
|
|
<!ENTITY docguide SYSTEM "docguide.sgml">
|
|
|
|
<!ENTITY errcodes SYSTEM "errcodes.sgml">
|
|
|
|
<!ENTITY features SYSTEM "features.sgml">
|
|
|
|
<!ENTITY keywords SYSTEM "keywords.sgml">
|
|
|
|
<!ENTITY sourcerepo SYSTEM "sourcerepo.sgml">
|
|
|
|
|
|
|
|
<!ENTITY release SYSTEM "release.sgml">
|
2013-04-20 22:29:58 +02:00
|
|
|
<!ENTITY release-9.3 SYSTEM "release-9.3.sgml">
|
2012-05-10 04:25:43 +02:00
|
|
|
<!ENTITY release-9.2 SYSTEM "release-9.2.sgml">
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY release-9.1 SYSTEM "release-9.1.sgml">
|
|
|
|
<!ENTITY release-9.0 SYSTEM "release-9.0.sgml">
|
|
|
|
<!ENTITY release-8.4 SYSTEM "release-8.4.sgml">
|
|
|
|
<!ENTITY release-8.3 SYSTEM "release-8.3.sgml">
|
|
|
|
<!ENTITY release-8.2 SYSTEM "release-8.2.sgml">
|
|
|
|
<!ENTITY release-8.1 SYSTEM "release-8.1.sgml">
|
|
|
|
<!ENTITY release-8.0 SYSTEM "release-8.0.sgml">
|
|
|
|
<!ENTITY release-7.4 SYSTEM "release-7.4.sgml">
|
|
|
|
<!ENTITY release-old SYSTEM "release-old.sgml">
|
|
|
|
|
|
|
|
<!ENTITY acronyms SYSTEM "acronyms.sgml">
|
|
|
|
|
|
|
|
<!ENTITY features-supported SYSTEM "features-supported.sgml">
|
|
|
|
<!ENTITY features-unsupported SYSTEM "features-unsupported.sgml">
|
|
|
|
|
|
|
|
<!ENTITY errcodes-table SYSTEM "errcodes-table.sgml">
|
2011-02-04 04:32:49 +01:00
|
|
|
|
2003-10-23 00:28:10 +02:00
|
|
|
<!-- back matter -->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY biblio SYSTEM "biblio.sgml">
|
|
|
|
<!ENTITY bookindex SYSTEM "bookindex.sgml">
|
2000-11-24 18:44:22 +01:00
|
|
|
|
2001-09-21 20:37:05 +02:00
|
|
|
<!--
|
|
|
|
Some parts of the documentation are also source for some plain-text
|
|
|
|
files used during installation. To selectively ignore or include
|
|
|
|
some parts (e.g., external xref's) when generating these files we use
|
|
|
|
these parameter entities. See also standalone-install.sgml.
|
|
|
|
-->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY % standalone-ignore "INCLUDE">
|
|
|
|
<!ENTITY % standalone-include "IGNORE">
|
Rearrangement of the HTML docs build rules
Set up proper makefile dependencies in the documentation build rules,
especially around the HTML/index build. The problem we've had with all
previous solutions is that we have used the same file name, such as HTML.index
or bookindex.sgml, to mean different things at different stages of the build,
and make can't distinguish that. The solution here is that the first jade run
produces HTML.index, but does not require bookindex.sgml at all, and produces
no other html output (the latter an idea from Alvaro). The second jade run
includes bookindex.sgml, but does not recreate HTML.index. That way, when you
change an sgml file, jade is run twice and at the end all dependencies are
satisfied. Omitting the html output in the first stage also makes the full
build a lot faster.
When you run one of the print format targets, only the first jade run is run,
then the print target-specific commands. If an HTML build has completed
previously, the first jade run is skipped because the dependencies have
already been satisfied.
The draft and check targets for quick builds and syntax verification are still
there.
2009-07-15 00:16:38 +02:00
|
|
|
|
|
|
|
<!--
|
|
|
|
By default, no index is included. Use -i include-index on the command line
|
|
|
|
to include it.
|
|
|
|
-->
|
2011-04-04 22:07:53 +02:00
|
|
|
<!ENTITY % include-index "IGNORE">
|
2013-10-16 04:54:36 +02:00
|
|
|
|
|
|
|
<!--
|
|
|
|
Create empty index element for processing by XSLT stylesheet.
|
|
|
|
-->
|
|
|
|
<!ENTITY % include-xslt-index "IGNORE">
|