Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
P
Postgres FD Implementation
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
Abuhujair Javed
Postgres FD Implementation
Commits
03c25dd9
Commit
03c25dd9
authored
Feb 02, 2011
by
Bruce Momjian
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Mark all GUC variables with <varname> markup, rather than <literal>.
parent
2b6e2dee
Changes
7
Hide whitespace changes
Inline
Side-by-side
Showing
7 changed files
with
60 additions
and
60 deletions
+60
-60
doc/src/sgml/datetime.sgml
doc/src/sgml/datetime.sgml
+3
-3
doc/src/sgml/libpq.sgml
doc/src/sgml/libpq.sgml
+23
-23
doc/src/sgml/maintenance.sgml
doc/src/sgml/maintenance.sgml
+7
-7
doc/src/sgml/pgarchivecleanup.sgml
doc/src/sgml/pgarchivecleanup.sgml
+1
-1
doc/src/sgml/pgstandby.sgml
doc/src/sgml/pgstandby.sgml
+6
-6
doc/src/sgml/protocol.sgml
doc/src/sgml/protocol.sgml
+19
-19
doc/src/sgml/ref/pg_dump.sgml
doc/src/sgml/ref/pg_dump.sgml
+1
-1
No files found.
doc/src/sgml/datetime.sgml
View file @
03c25dd9
...
@@ -360,10 +360,10 @@
...
@@ -360,10 +360,10 @@
</para>
</para>
<para>
<para>
<
literal
>timezone_abbreviations</> can be set to any file name
<
varname
>timezone_abbreviations</> can be set to any file name
found in <filename>.../share/timezonesets/</>, if the file's name
found in <filename>.../share/timezonesets/</>, if the file's name
is entirely alphabetic. (The prohibition against non-alphabetic
is entirely alphabetic. (The prohibition against non-alphabetic
characters in <
literal
>timezone_abbreviations</> prevents reading
characters in <
varname
>timezone_abbreviations</> prevents reading
files outside the intended directory, as well as reading editor
files outside the intended directory, as well as reading editor
backup files and other extraneous files.)
backup files and other extraneous files.)
</para>
</para>
...
@@ -420,7 +420,7 @@
...
@@ -420,7 +420,7 @@
according to the <literal>zoneinfo</> timezone database. The zone name
according to the <literal>zoneinfo</> timezone database. The zone name
definitions found in these files can be copied and pasted into a custom
definitions found in these files can be copied and pasted into a custom
configuration file as needed. Note that these files cannot be directly
configuration file as needed. Note that these files cannot be directly
referenced as <
literal
>timezone_abbreviations</> settings, because of
referenced as <
varname
>timezone_abbreviations</> settings, because of
the dot embedded in their names.
the dot embedded in their names.
</para>
</para>
...
...
doc/src/sgml/libpq.sgml
View file @
03c25dd9
...
@@ -1418,46 +1418,46 @@ const char *PQparameterStatus(const PGconn *conn, const char *paramName);
...
@@ -1418,46 +1418,46 @@ const char *PQparameterStatus(const PGconn *conn, const char *paramName);
<para>
<para>
Parameters reported as of the current release include
Parameters reported as of the current release include
<
literal
>server_version</>,
<
varname
>server_version</>,
<
literal
>server_encoding</>,
<
varname
>server_encoding</>,
<
literal
>client_encoding</>,
<
varname
>client_encoding</>,
<
literal
>application_name</>,
<
varname
>application_name</>,
<
literal
>is_superuser</>,
<
varname
>is_superuser</>,
<
literal
>session_authorization</>,
<
varname
>session_authorization</>,
<
literal
>DateStyle</>,
<
varname
>DateStyle</>,
<
literal
>IntervalStyle</>,
<
varname
>IntervalStyle</>,
<
literal
>TimeZone</>,
<
varname
>TimeZone</>,
<
literal
>integer_datetimes</>, and
<
varname
>integer_datetimes</>, and
<
literal
>standard_conforming_strings</>.
<
varname
>standard_conforming_strings</>.
(<
literal>server_encoding</>, <literal
>TimeZone</>, and
(<
varname>server_encoding</>, <varname
>TimeZone</>, and
<
literal
>integer_datetimes</> were not reported by releases before 8.0;
<
varname
>integer_datetimes</> were not reported by releases before 8.0;
<
literal
>standard_conforming_strings</> was not reported by releases
<
varname
>standard_conforming_strings</> was not reported by releases
before 8.1;
before 8.1;
<
literal
>IntervalStyle</> was not reported by releases before 8.4;
<
varname
>IntervalStyle</> was not reported by releases before 8.4;
<
literal
>application_name</> was not reported by releases before 9.0.)
<
varname
>application_name</> was not reported by releases before 9.0.)
Note that
Note that
<
literal
>server_version</>,
<
varname
>server_version</>,
<
literal
>server_encoding</> and
<
varname
>server_encoding</> and
<
literal
>integer_datetimes</>
<
varname
>integer_datetimes</>
cannot change after startup.
cannot change after startup.
</para>
</para>
<para>
<para>
Pre-3.0-protocol servers do not report parameter settings, but
Pre-3.0-protocol servers do not report parameter settings, but
<application>libpq</> includes logic to obtain values for
<application>libpq</> includes logic to obtain values for
<
literal>server_version</> and <literal
>client_encoding</> anyway.
<
varname>server_version</> and <varname
>client_encoding</> anyway.
Applications are encouraged to use <function>PQparameterStatus</>
Applications are encouraged to use <function>PQparameterStatus</>
rather than <foreignphrase>ad hoc</> code to determine these values.
rather than <foreignphrase>ad hoc</> code to determine these values.
(Beware however that on a pre-3.0 connection, changing
(Beware however that on a pre-3.0 connection, changing
<
literal
>client_encoding</> via <command>SET</> after connection
<
varname
>client_encoding</> via <command>SET</> after connection
startup will not be reflected by <function>PQparameterStatus</>.)
startup will not be reflected by <function>PQparameterStatus</>.)
For <
literal
>server_version</>, see also
For <
varname
>server_version</>, see also
<function>PQserverVersion</>, which returns the information in a
<function>PQserverVersion</>, which returns the information in a
numeric form that is much easier to compare against.
numeric form that is much easier to compare against.
</para>
</para>
<para>
<para>
If no value for <
literal
>standard_conforming_strings</> is reported,
If no value for <
varname
>standard_conforming_strings</> is reported,
applications can assume it is <literal>off</>, that is, backslashes
applications can assume it is <literal>off</>, that is, backslashes
are treated as escapes in string literals. Also, the presence of
are treated as escapes in string literals. Also, the presence of
this parameter can be taken as an indication that the escape string
this parameter can be taken as an indication that the escape string
...
...
doc/src/sgml/maintenance.sgml
View file @
03c25dd9
...
@@ -670,13 +670,13 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
...
@@ -670,13 +670,13 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
autovacuum will only touch the table if it must do so
autovacuum will only touch the table if it must do so
to prevent transaction ID wraparound.
to prevent transaction ID wraparound.
Another two parameters,
Another two parameters,
<
literal>autovacuum_vacuum_cost_delay</literal
> and
<
varname>autovacuum_vacuum_cost_delay</
> and
<
literal>autovacuum_vacuum_cost_limit</literal
>, are used to set
<
varname>autovacuum_vacuum_cost_limit</
>, are used to set
table-specific values for the cost-based vacuum delay feature
table-specific values for the cost-based vacuum delay feature
(see <xref linkend="runtime-config-resource-vacuum-cost">).
(see <xref linkend="runtime-config-resource-vacuum-cost">).
<
literal>autovacuum_freeze_min_age</literal
>,
<
varname>autovacuum_freeze_min_age</
>,
<
literal>autovacuum_freeze_max_age</literal
> and
<
varname>autovacuum_freeze_max_age</
> and
<
literal>autovacuum_freeze_table_age</literal
> are used to set
<
varname>autovacuum_freeze_table_age</
> are used to set
values for <xref linkend="guc-vacuum-freeze-min-age">,
values for <xref linkend="guc-vacuum-freeze-min-age">,
<xref linkend="guc-autovacuum-freeze-max-age"> and
<xref linkend="guc-autovacuum-freeze-max-age"> and
<xref linkend="guc-vacuum-freeze-table-age"> respectively.
<xref linkend="guc-vacuum-freeze-table-age"> respectively.
...
@@ -764,7 +764,7 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
...
@@ -764,7 +764,7 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
A better approach is to send the server's
A better approach is to send the server's
<systemitem>stderr</> output to some type of log rotation program.
<systemitem>stderr</> output to some type of log rotation program.
There is a built-in log rotation facility, which you can use by
There is a built-in log rotation facility, which you can use by
setting the configuration parameter <
literal
>logging_collector</> to
setting the configuration parameter <
varname
>logging_collector</> to
<literal>true</> in <filename>postgresql.conf</>. The control
<literal>true</> in <filename>postgresql.conf</>. The control
parameters for this program are described in <xref
parameters for this program are described in <xref
linkend="runtime-config-logging-where">. You can also use this approach
linkend="runtime-config-logging-where">. You can also use this approach
...
@@ -794,7 +794,7 @@ pg_ctl start | rotatelogs /var/log/pgsql_log 86400
...
@@ -794,7 +794,7 @@ pg_ctl start | rotatelogs /var/log/pgsql_log 86400
Another production-grade approach to managing log output is to
Another production-grade approach to managing log output is to
send it to <application>syslog</> and let
send it to <application>syslog</> and let
<application>syslog</> deal with file rotation. To do this, set the
<application>syslog</> deal with file rotation. To do this, set the
configuration parameter <
literal
>log_destination</> to <literal>syslog</>
configuration parameter <
varname
>log_destination</> to <literal>syslog</>
(to log to <application>syslog</> only) in
(to log to <application>syslog</> only) in
<filename>postgresql.conf</>. Then you can send a <literal>SIGHUP</literal>
<filename>postgresql.conf</>. Then you can send a <literal>SIGHUP</literal>
signal to the <application>syslog</> daemon whenever you want to force it
signal to the <application>syslog</> daemon whenever you want to force it
...
...
doc/src/sgml/pgarchivecleanup.sgml
View file @
03c25dd9
...
@@ -111,7 +111,7 @@ pg_archivecleanup: removing file "archive/00000001000000370000000E"
...
@@ -111,7 +111,7 @@ pg_archivecleanup: removing file "archive/00000001000000370000000E"
archive_cleanup_command = 'pg_archivecleanup -d /mnt/standby/archive %r 2>>cleanup.log'
archive_cleanup_command = 'pg_archivecleanup -d /mnt/standby/archive %r 2>>cleanup.log'
</programlisting>
</programlisting>
where the archive directory is physically located on the standby server,
where the archive directory is physically located on the standby server,
so that the <
literal
>archive_command</> is accessing it across NFS,
so that the <
varname
>archive_command</> is accessing it across NFS,
but the files are local to the standby.
but the files are local to the standby.
This will:
This will:
</para>
</para>
...
...
doc/src/sgml/pgstandby.sgml
View file @
03c25dd9
...
@@ -15,7 +15,7 @@
...
@@ -15,7 +15,7 @@
<para>
<para>
<application>pg_standby</> is designed to be a waiting
<application>pg_standby</> is designed to be a waiting
<
literal>restore_command</literal
>, which is needed to turn a standard
<
varname>restore_command</
>, which is needed to turn a standard
archive recovery into a warm standby operation. Other
archive recovery into a warm standby operation. Other
configuration is required as well, all of which is described in the main
configuration is required as well, all of which is described in the main
server manual (see <xref linkend="warm-standby">).
server manual (see <xref linkend="warm-standby">).
...
@@ -61,7 +61,7 @@ restore_command = 'pg_standby <replaceable>archiveDir</> %f %p %r'
...
@@ -61,7 +61,7 @@ restore_command = 'pg_standby <replaceable>archiveDir</> %f %p %r'
<synopsis>
<synopsis>
pg_standby <optional> <replaceable>option</> ... </optional> <replaceable>archivelocation</> <replaceable>nextwalfile</> <replaceable>xlogfilepath</> <optional> <replaceable>restartwalfile</> </optional>
pg_standby <optional> <replaceable>option</> ... </optional> <replaceable>archivelocation</> <replaceable>nextwalfile</> <replaceable>xlogfilepath</> <optional> <replaceable>restartwalfile</> </optional>
</synopsis>
</synopsis>
When used within <
literal>restore_command</literal
>, the <literal>%f</> and
When used within <
varname>restore_command</
>, the <literal>%f</> and
<literal>%p</> macros should be specified for <replaceable>nextwalfile</>
<literal>%p</> macros should be specified for <replaceable>nextwalfile</>
and <replaceable>xlogfilepath</> respectively, to provide the actual file
and <replaceable>xlogfilepath</> respectively, to provide the actual file
and path required for the restore.
and path required for the restore.
...
@@ -241,7 +241,7 @@ restore_command = 'pg_standby -d -s 2 -t /tmp/pgsql.trigger.5442 .../archive %f
...
@@ -241,7 +241,7 @@ restore_command = 'pg_standby -d -s 2 -t /tmp/pgsql.trigger.5442 .../archive %f
recovery_end_command = 'rm -f /tmp/pgsql.trigger.5442'
recovery_end_command = 'rm -f /tmp/pgsql.trigger.5442'
</programlisting>
</programlisting>
where the archive directory is physically located on the standby server,
where the archive directory is physically located on the standby server,
so that the <
literal
>archive_command</> is accessing it across NFS,
so that the <
varname
>archive_command</> is accessing it across NFS,
but the files are local to the standby (enabling use of <literal>ln</>).
but the files are local to the standby (enabling use of <literal>ln</>).
This will:
This will:
<itemizedlist>
<itemizedlist>
...
@@ -285,8 +285,8 @@ restore_command = 'pg_standby -d -s 5 -t C:\pgsql.trigger.5442 ...\archive %f %p
...
@@ -285,8 +285,8 @@ restore_command = 'pg_standby -d -s 5 -t C:\pgsql.trigger.5442 ...\archive %f %p
recovery_end_command = 'del C:\pgsql.trigger.5442'
recovery_end_command = 'del C:\pgsql.trigger.5442'
</programlisting>
</programlisting>
Note that backslashes need to be doubled in the
Note that backslashes need to be doubled in the
<
literal
>archive_command</>, but <emphasis>not</emphasis> in the
<
varname
>archive_command</>, but <emphasis>not</emphasis> in the
<
literal>restore_command</> or <literal
>recovery_end_command</>.
<
varname>restore_command</> or <varname
>recovery_end_command</>.
This will:
This will:
<itemizedlist>
<itemizedlist>
<listitem>
<listitem>
...
@@ -357,7 +357,7 @@ recovery_end_command = 'del C:\pgsql.trigger.5442'
...
@@ -357,7 +357,7 @@ recovery_end_command = 'del C:\pgsql.trigger.5442'
</para>
</para>
<para>
<para>
<productname>PostgreSQL</> 8.4 provides the
<productname>PostgreSQL</> 8.4 provides the
<
literal>recovery_end_command</literal
> option. Without this option
<
varname>recovery_end_command</
> option. Without this option
a leftover trigger file can be hazardous.
a leftover trigger file can be hazardous.
</para>
</para>
</sect2>
</sect2>
...
...
doc/src/sgml/protocol.sgml
View file @
03c25dd9
...
@@ -1092,27 +1092,27 @@
...
@@ -1092,27 +1092,27 @@
<para>
<para>
At present there is a hard-wired set of parameters for which
At present there is a hard-wired set of parameters for which
ParameterStatus will be generated: they are
ParameterStatus will be generated: they are
<
literal
>server_version</>,
<
varname
>server_version</>,
<
literal
>server_encoding</>,
<
varname
>server_encoding</>,
<
literal
>client_encoding</>,
<
varname
>client_encoding</>,
<
literal
>application_name</>,
<
varname
>application_name</>,
<
literal
>is_superuser</>,
<
varname
>is_superuser</>,
<
literal
>session_authorization</>,
<
varname
>session_authorization</>,
<
literal
>DateStyle</>,
<
varname
>DateStyle</>,
<
literal
>IntervalStyle</>,
<
varname
>IntervalStyle</>,
<
literal
>TimeZone</>,
<
varname
>TimeZone</>,
<
literal
>integer_datetimes</>, and
<
varname
>integer_datetimes</>, and
<
literal
>standard_conforming_strings</>.
<
varname
>standard_conforming_strings</>.
(<
literal>server_encoding</>, <literal
>TimeZone</>, and
(<
varname>server_encoding</>, <varname
>TimeZone</>, and
<
literal
>integer_datetimes</> were not reported by releases before 8.0;
<
varname
>integer_datetimes</> were not reported by releases before 8.0;
<
literal
>standard_conforming_strings</> was not reported by releases
<
varname
>standard_conforming_strings</> was not reported by releases
before 8.1;
before 8.1;
<
literal
>IntervalStyle</> was not reported by releases before 8.4;
<
varname
>IntervalStyle</> was not reported by releases before 8.4;
<
literal
>application_name</> was not reported by releases before 9.0.)
<
varname
>application_name</> was not reported by releases before 9.0.)
Note that
Note that
<
literal
>server_version</>,
<
varname
>server_version</>,
<
literal
>server_encoding</> and
<
varname
>server_encoding</> and
<
literal
>integer_datetimes</>
<
varname
>integer_datetimes</>
are pseudo-parameters that cannot change after startup.
are pseudo-parameters that cannot change after startup.
This set might change in the future, or even become configurable.
This set might change in the future, or even become configurable.
Accordingly, a frontend should simply ignore ParameterStatus for
Accordingly, a frontend should simply ignore ParameterStatus for
...
...
doc/src/sgml/ref/pg_dump.sgml
View file @
03c25dd9
...
@@ -864,7 +864,7 @@ PostgreSQL documentation
...
@@ -864,7 +864,7 @@ PostgreSQL documentation
<para>
<para>
The database activity of <application>pg_dump</application> is
The database activity of <application>pg_dump</application> is
normally collected by the statistics collector. If this is
normally collected by the statistics collector. If this is
undesirable, you can set parameter <
literal>track_counts</literal
>
undesirable, you can set parameter <
varname>track_counts</
>
to false via <envar>PGOPTIONS</envar> or the <literal>ALTER
to false via <envar>PGOPTIONS</envar> or the <literal>ALTER
USER</literal> command.
USER</literal> command.
</para>
</para>
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment