aboutsummaryrefslogtreecommitdiff
path: root/doc/src
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2003-09-29 23:40:26 +0000
committerTom Lane <tgl@sss.pgh.pa.us>2003-09-29 23:40:26 +0000
commite33f205a945e7497b9aecffffb7e3b0a199f8a29 (patch)
treecf5d530e56ed7d44b379058f479949a98050291e /doc/src
parent6b4caf53e632db88a7bae21a0494c50b54120e38 (diff)
downloadpostgresql-e33f205a945e7497b9aecffffb7e3b0a199f8a29.tar.gz
postgresql-e33f205a945e7497b9aecffffb7e3b0a199f8a29.zip
Adjust btree index build procedure so that the btree metapage looks
invalid (has the wrong magic number) until the build is entirely complete. This turns out to cost no additional writes in the normal case, since we were rewriting the metapage at the end of the process anyway. In normal scenarios there's no real gain in security, because a failed index build would roll back the transaction leaving an unused index file, but for rebuilding shared system indexes this seems to add some useful protection.
Diffstat (limited to 'doc/src')
-rw-r--r--doc/src/sgml/ref/reindex.sgml9
1 files changed, 5 insertions, 4 deletions
diff --git a/doc/src/sgml/ref/reindex.sgml b/doc/src/sgml/ref/reindex.sgml
index d945112de79..43f0368d64a 100644
--- a/doc/src/sgml/ref/reindex.sgml
+++ b/doc/src/sgml/ref/reindex.sgml
@@ -1,5 +1,5 @@
<!--
-$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.21 2003/09/24 18:54:01 tgl Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/ref/reindex.sgml,v 1.22 2003/09/29 23:40:26 tgl Exp $
PostgreSQL documentation
-->
@@ -180,9 +180,10 @@ REINDEX { DATABASE | TABLE | INDEX } <replaceable class="PARAMETER">name</replac
is crash-safe and transaction-safe. <command>REINDEX</> is not
crash-safe for shared indexes, which is why this case is disallowed
during normal operation. If a failure occurs while reindexing one
- of these catalogs in standalone mode, it is important that the failure
- be rectified and the <command>REINDEX</> operation redone
- before attempting to restart the regular server.
+ of these catalogs in standalone mode, it will not be possible to
+ restart the regular server until the problem is rectified. (The
+ typical symptom of a partially rebuilt shared index is <quote>index is not
+ a btree</> errors.)
</para>
<para>