OSDN Git Service

Rename standby_keep_segments to wal_keep_segments.
authorRobert Haas <rhaas@postgresql.org>
Tue, 20 Apr 2010 11:15:06 +0000 (11:15 +0000)
committerRobert Haas <rhaas@postgresql.org>
Tue, 20 Apr 2010 11:15:06 +0000 (11:15 +0000)
Also, make the name of the GUC and the name of the backing variable match.
Alnong the way, clean up a couple of slight typographical errors in the
related docs.

doc/src/sgml/config.sgml
doc/src/sgml/high-availability.sgml
src/backend/access/transam/xlog.c
src/backend/utils/misc/guc.c
src/backend/utils/misc/postgresql.conf.sample
src/include/access/xlog.h

index eb3e8ed..e1372bf 100644 (file)
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.268 2010/04/19 00:55:25 rhaas Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.269 2010/04/20 11:15:06 rhaas Exp $ -->
 
 <chapter Id="runtime-config">
   <title>Server Configuration</title>
@@ -1842,10 +1842,10 @@ SET ENABLE_SEQSCAN TO OFF;
        </listitem>
       </varlistentry>
 
-      <varlistentry id="guc-standby-keep-segments" xreflabel="standby_keep_segments">
-       <term><varname>standby_keep_segments</varname> (<type>integer</type>)</term>
+      <varlistentry id="guc-wal-keep-segments" xreflabel="wal_keep_segments">
+       <term><varname>wal_keep_segments</varname> (<type>integer</type>)</term>
        <indexterm>
-        <primary><varname>standby_keep_segments</> configuration parameter</primary>
+        <primary><varname>wal_keep_segments</> configuration parameter</primary>
        </indexterm>
        <listitem>
        <para>
@@ -1853,17 +1853,17 @@ SET ENABLE_SEQSCAN TO OFF;
         directory, in case a standby server needs to fetch them via streaming
         replication. Each segment is normally 16 megabytes. If a standby
         server connected to the primary falls behind more than
-        <varname>standby_keep_segments</> segments, the primary might remove
+        <varname>wal_keep_segments</> segments, the primary might remove
         a WAL segment still needed by the standby and the replication
         connection will be terminated.
 
         This sets only the minimum number of segments retained for standby
-        purposes, the system might need to retain more segments for WAL
-        archival or to recover from a checkpoint. If <varname>standby_keep_segments</>
+        purposes; the system might need to retain more segments for WAL
+        archival or to recover from a checkpoint. If <varname>wal_keep_segments</>
         is zero (the default), the system doesn't keep any extra segments
         for standby purposes, and the number of old WAL segments available
         for standbys is determined based only on the location of the previous
-        checkpoint and status of WAL archival.
+        checkpoint and status of WAL archiving.
         This parameter can only be set in the <filename>postgresql.conf</>
         file or on the server command line.
        </para>
index c27c190..d2a8ea7 100644 (file)
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/high-availability.sgml,v 1.60 2010/04/12 10:01:04 heikki Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/high-availability.sgml,v 1.61 2010/04/20 11:15:06 rhaas Exp $ -->
 
 <chapter id="high-availability">
  <title>High Availability, Load Balancing, and Replication</title>
@@ -737,7 +737,7 @@ trigger_file = '/path/to/trigger_file'
     falls behind too much, the primary will delete old WAL files still
     needed by the standby, and the standby will have to be manually restored
     from a base backup. You can control how long the primary retains old WAL
-    segments using the <varname>standby_keep_segments</> setting.
+    segments using the <varname>wal_keep_segments</> setting.
    </para>
 
    <para>
index 9a60cb9..f887dc2 100644 (file)
@@ -7,7 +7,7 @@
  * Portions Copyright (c) 1996-2010, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $PostgreSQL: pgsql/src/backend/access/transam/xlog.c,v 1.400 2010/04/18 18:44:53 sriggs Exp $
+ * $PostgreSQL: pgsql/src/backend/access/transam/xlog.c,v 1.401 2010/04/20 11:15:06 rhaas Exp $
  *
  *-------------------------------------------------------------------------
  */
@@ -66,7 +66,7 @@
 
 /* User-settable parameters */
 int                    CheckPointSegments = 3;
-int                    StandbySegments = 0;
+int                    wal_keep_segments = 0;
 int                    XLOGbuffers = 8;
 int                    XLogArchiveTimeout = 0;
 bool           XLogArchiveMode = false;
@@ -7285,10 +7285,10 @@ CreateCheckPoint(int flags)
        {
                /*
                 * Calculate the last segment that we need to retain because of
-                * standby_keep_segments, by subtracting StandbySegments from the
+                * wal_keep_segments, by subtracting wal_keep_segments from the
                 * new checkpoint location.
                 */
-               if (StandbySegments > 0)
+               if (wal_keep_segments > 0)
                {
                        uint32          log;
                        uint32          seg;
@@ -7297,8 +7297,8 @@ CreateCheckPoint(int flags)
 
                        XLByteToSeg(recptr, log, seg);
 
-                       d_seg = StandbySegments % XLogSegsPerFile;
-                       d_log = StandbySegments / XLogSegsPerFile;
+                       d_seg = wal_keep_segments % XLogSegsPerFile;
+                       d_log = wal_keep_segments / XLogSegsPerFile;
                        if (seg < d_seg)
                        {
                                d_log += 1;
index 04ee99a..15ca9c1 100644 (file)
@@ -10,7 +10,7 @@
  * Written by Peter Eisentraut <peter_e@gmx.net>.
  *
  * IDENTIFICATION
- *       $PostgreSQL: pgsql/src/backend/utils/misc/guc.c,v 1.548 2010/04/19 00:55:25 rhaas Exp $
+ *       $PostgreSQL: pgsql/src/backend/utils/misc/guc.c,v 1.549 2010/04/20 11:15:06 rhaas Exp $
  *
  *--------------------------------------------------------------------
  */
@@ -1656,11 +1656,11 @@ static struct config_int ConfigureNamesInt[] =
        },
 
        {
-               {"standby_keep_segments", PGC_SIGHUP, WAL_CHECKPOINTS,
+               {"wal_keep_segments", PGC_SIGHUP, WAL_CHECKPOINTS,
                        gettext_noop("Sets the number of WAL files held for standby servers"),
                        NULL
                },
-               &StandbySegments,
+               &wal_keep_segments,
                0, 0, INT_MAX, NULL, NULL
        },
 
index c3f985a..92763eb 100644 (file)
 
 #max_wal_senders = 0           # max number of walsender processes
 #wal_sender_delay = 200ms      # 1-10000 milliseconds
-#standby_keep_segments = 0     # in logfile segments, 16MB each; 0 disables
+#wal_keep_segments = 0         # in logfile segments, 16MB each; 0 disables
 
 
 #------------------------------------------------------------------------------
index c29c982..4812997 100644 (file)
@@ -6,7 +6,7 @@
  * Portions Copyright (c) 1996-2010, PostgreSQL Global Development Group
  * Portions Copyright (c) 1994, Regents of the University of California
  *
- * $PostgreSQL: pgsql/src/include/access/xlog.h,v 1.108 2010/04/18 18:17:12 sriggs Exp $
+ * $PostgreSQL: pgsql/src/include/access/xlog.h,v 1.109 2010/04/20 11:15:06 rhaas Exp $
  */
 #ifndef XLOG_H
 #define XLOG_H
@@ -187,7 +187,7 @@ extern XLogRecPtr XactLastRecEnd;
 
 /* these variables are GUC parameters related to XLOG */
 extern int     CheckPointSegments;
-extern int     StandbySegments;
+extern int     wal_keep_segments;
 extern int     XLOGbuffers;
 extern bool XLogArchiveMode;
 extern char *XLogArchiveCommand;