head	1.50;
access;
symbols
	REL9_0_0:1.50
	REL9_1_ALPHA1:1.50
	REL9_0_RC1:1.50
	REL9_0_BETA4:1.50
	REL9_0_STABLE:1.50.0.2
	REL9_0_BETA3:1.50
	REL9_0_BETA2:1.50
	REL7_4_29:1.33
	REL8_0_25:1.37
	REL8_1_21:1.39.2.1
	REL8_2_17:1.42.2.1
	REL8_3_11:1.45
	REL8_4_4:1.47
	REL9_0_BETA1:1.49
	REL9_0_ALPHA5_BRANCH:1.48.0.6
	REL9_0_ALPHA5:1.48
	REL7_4_28:1.33
	REL8_0_24:1.37
	REL8_1_20:1.39.2.1
	REL8_2_16:1.42.2.1
	REL8_3_10:1.45
	REL8_4_3:1.47
	REL9_0_ALPHA4:1.48
	REL9_0_ALPHA4_BRANCH:1.48.0.4
	REL8_5_ALPHA3:1.48
	REL8_5_ALPHA3_BRANCH:1.48.0.2
	REL7_4_27:1.33
	REL8_0_23:1.37
	REL8_1_19:1.39.2.1
	REL8_2_15:1.42.2.1
	REL8_3_9:1.45
	REL8_4_2:1.47
	REL8_5_ALPHA2:1.47
	REL8_5_ALPHA2_BRANCH:1.47.0.6
	REL7_4_26:1.33
	REL8_0_22:1.37
	REL8_1_18:1.39.2.1
	REL8_2_14:1.42.2.1
	REL8_3_8:1.45
	REL8_4_1:1.47
	REL8_5_ALPHA1:1.47
	REL8_5_ALPHA1_BRANCH:1.47.0.4
	REL8_4_STABLE:1.47.0.2
	REL8_4_0:1.47
	REL8_4_RC2:1.47
	REL8_4_RC1:1.47
	REL8_4_BETA2:1.47
	REL8_4_BETA1:1.47
	REL7_4_25:1.33
	REL8_0_21:1.37
	REL8_1_17:1.39.2.1
	REL8_2_13:1.42.2.1
	REL8_3_7:1.45
	REL7_4_24:1.33
	REL8_0_20:1.37
	REL8_1_16:1.39.2.1
	REL8_2_12:1.42.2.1
	REL8_3_6:1.45
	REL7_4_23:1.33
	REL8_0_19:1.37
	REL8_1_15:1.39.2.1
	REL8_2_11:1.42.2.1
	REL8_3_5:1.45
	REL7_4_22:1.33
	REL8_0_18:1.37
	REL8_1_14:1.39.2.1
	REL8_2_10:1.42.2.1
	REL8_3_4:1.45
	REL7_4_21:1.33
	REL8_0_17:1.37
	REL8_1_13:1.39.2.1
	REL8_2_9:1.42.2.1
	REL8_3_3:1.45
	REL7_4_20:1.33
	REL8_0_16:1.37
	REL8_1_12:1.39.2.1
	REL8_2_8:1.42.2.1
	REL8_3_2:1.45
	REL8_2_7:1.42.2.1
	REL8_3_1:1.45
	REL8_3_STABLE:1.45.0.2
	REL8_3_0:1.45
	REL8_3_RC2:1.45
	REL7_3_21:1.22
	REL7_4_19:1.33
	REL8_0_15:1.37
	REL8_1_11:1.39.2.1
	REL8_2_6:1.42.2.1
	REL8_3_RC1:1.45
	REL8_3_BETA4:1.44
	REL8_3_BETA3:1.44
	REL8_3_BETA2:1.44
	REL8_3_BETA1:1.44
	REL7_3_20:1.22
	REL7_4_18:1.33
	REL8_0_14:1.37
	REL8_1_10:1.39
	REL8_2_5:1.42
	REL7_3_19:1.22
	REL7_4_17:1.33
	REL8_0_13:1.37
	REL8_1_9:1.39
	REL8_2_4:1.42
	REL8_0_12:1.37
	REL8_1_8:1.39
	REL8_2_3:1.42
	REL7_3_18:1.22
	REL7_4_16:1.33
	REL8_0_11:1.37
	REL8_1_7:1.39
	REL8_2_2:1.42
	REL8_0_10:1.37
	REL8_1_6:1.39
	REL8_2_1:1.42
	REL7_4_15:1.33
	REL7_3_17:1.22
	REL8_2_STABLE:1.42.0.2
	REL8_2_0:1.42
	REL8_2_RC1:1.42
	REL8_2_BETA3:1.42
	REL8_2_BETA2:1.42
	REL8_1_5:1.39
	REL8_0_9:1.37
	REL7_4_14:1.33
	REL7_3_16:1.22
	REL8_2_BETA1:1.42
	REL7_3_15:1.22
	REL7_4_13:1.33
	REL8_0_8:1.37
	REL8_1_4:1.39
	REL7_3_14:1.22
	REL7_4_12:1.33
	REL8_0_7:1.37
	REL8_1_3:1.39
	REL7_3_13:1.22
	REL7_4_11:1.33
	REL8_0_6:1.37
	REL8_1_2:1.39
	REL7_3_12:1.22
	REL7_4_10:1.33
	REL8_0_5:1.37
	REL8_1_1:1.39
	REL8_1_STABLE:1.39.0.2
	REL8_1_0:1.39
	REL8_1_0RC1:1.39
	REL8_1_0BETA4:1.39
	REL8_1_0BETA3:1.39
	REL7_3_11:1.22
	REL7_4_9:1.33
	REL8_0_4:1.37
	REL8_1_0BETA2:1.39
	REL8_1_0BETA1:1.39
	REL7_2_8:1.15
	REL7_3_10:1.22
	REL7_4_8:1.33
	REL8_0_3:1.37
	REL8_0_2:1.37
	REL7_2_7:1.15
	REL7_3_9:1.22
	REL7_4_7:1.33
	REL8_0_1:1.37
	REL8_0_STABLE:1.37.0.4
	REL8_0_0:1.37.0.2
	REL8_0_0RC5:1.37
	REL8_0_0RC4:1.37
	REL8_0_0RC3:1.36
	REL8_0_0RC2:1.36
	REL8_0_0RC1:1.36
	REL8_0_0BETA5:1.36
	REL8_0_0BETA4:1.36
	REL7_4_6:1.33
	REL7_3_8:1.22
	REL7_2_6:1.15
	REL8_0_0BETA3:1.36
	REL8_0_0BETA2:1.36
	REL7_2_5:1.15
	REL7_4_5:1.33
	REL7_3_7:1.22
	REL7_4_4:1.33
	REL8_0_0BETA1:1.36
	REL7_4_3:1.33
	REL7_4_2:1.33
	REL7_3_6:1.22
	REL7_4_1:1.33
	REL7_3_5:1.22
	REL7_4:1.33
	REL7_4_RC2:1.33
	REL7_4_STABLE:1.33.0.2
	REL7_4_RC1:1.33
	REL7_4_BETA5:1.33
	REL7_4_BETA4:1.33
	REL7_4_BETA3:1.32
	REL7_4_BETA2:1.30
	WIN32_DEV:1.30.0.2
	REL7_4_BETA1:1.30
	REL7_3_4:1.22
	REL7_3_2:1.22
	REL7_2_4:1.15
	REL7_3_STABLE:1.22.0.2
	REL7_2_3:1.15
	REL7_2_STABLE:1.15.0.2
	REL7_2:1.15
	REL7_2_RC2:1.15
	REL7_2_RC1:1.15
	REL7_2_BETA5:1.15
	REL7_2_BETA4:1.15
	REL7_2_BETA3:1.14
	REL7_2_BETA2:1.14
	REL7_2_BETA1:1.14
	REL7_1_2:1.11
	REL7_1_STABLE:1.11.0.2
	REL7_1_BETA:1.10
	REL7_1_BETA3:1.11
	REL7_1_BETA2:1.11
	REL7_1:1.11
	REL7_0_PATCHES:1.9.0.2
	REL7_0:1.9
	REL6_5_PATCHES:1.5.0.2
	REL6_5:1.5
	REL6_4:1.3.0.2;
locks; strict;
comment	@# @;


1.50
date	2010.05.17.20.50.44;	author alvherre;	state Exp;
branches;
next	1.49;

1.49
date	2010.04.03.07.23.02;	author petere;	state Exp;
branches;
next	1.48;

1.48
date	2009.10.21.20.22.38;	author tgl;	state Exp;
branches;
next	1.47;

1.47
date	2008.11.14.10.22.47;	author petere;	state Exp;
branches;
next	1.46;

1.46
date	2008.09.23.09.20.35;	author heikki;	state Exp;
branches;
next	1.45;

1.45
date	2008.01.03.21.23.15;	author tgl;	state Exp;
branches;
next	1.44;

1.44
date	2007.09.26.22.36.30;	author tgl;	state Exp;
branches;
next	1.43;

1.43
date	2007.09.11.00.06.41;	author tgl;	state Exp;
branches;
next	1.42;

1.42
date	2006.09.16.00.30.20;	author momjian;	state Exp;
branches
	1.42.2.1;
next	1.41;

1.41
date	2006.07.25.03.51.21;	author tgl;	state Exp;
branches;
next	1.40;

1.40
date	2006.06.18.15.38.36;	author petere;	state Exp;
branches;
next	1.39;

1.39
date	2005.06.14.20.42.52;	author momjian;	state Exp;
branches
	1.39.2.1;
next	1.38;

1.38
date	2005.04.08.00.59.58;	author neilc;	state Exp;
branches;
next	1.37;

1.37
date	2005.01.04.03.58.16;	author tgl;	state Exp;
branches;
next	1.36;

1.36
date	2004.08.03.20.32.32;	author tgl;	state Exp;
branches;
next	1.35;

1.35
date	2004.01.06.17.26.23;	author neilc;	state Exp;
branches;
next	1.34;

1.34
date	2003.11.29.19.51.39;	author pgsql;	state Exp;
branches;
next	1.33;

1.33
date	2003.09.22.00.16.58;	author petere;	state Exp;
branches;
next	1.32;

1.32
date	2003.09.09.18.28.53;	author tgl;	state Exp;
branches;
next	1.31;

1.31
date	2003.08.31.17.32.24;	author petere;	state Exp;
branches;
next	1.30;

1.30
date	2003.07.29.00.03.17;	author tgl;	state Exp;
branches
	1.30.2.1;
next	1.29;

1.29
date	2003.07.15.19.19.56;	author tgl;	state Exp;
branches;
next	1.28;

1.28
date	2003.06.27.19.08.37;	author tgl;	state Exp;
branches;
next	1.27;

1.27
date	2003.05.14.03.26.00;	author tgl;	state Exp;
branches;
next	1.26;

1.26
date	2003.05.04.02.23.16;	author petere;	state Exp;
branches;
next	1.25;

1.25
date	2003.04.25.19.45.08;	author tgl;	state Exp;
branches;
next	1.24;

1.24
date	2003.03.25.16.15.44;	author petere;	state Exp;
branches;
next	1.23;

1.23
date	2003.01.19.00.13.31;	author momjian;	state Exp;
branches;
next	1.22;

1.22
date	2002.10.13.16.55.05;	author tgl;	state Exp;
branches;
next	1.21;

1.21
date	2002.09.01.01.59.48;	author momjian;	state Exp;
branches;
next	1.20;

1.20
date	2002.08.04.05.46.02;	author tgl;	state Exp;
branches;
next	1.19;

1.19
date	2002.08.04.05.09.36;	author momjian;	state Exp;
branches;
next	1.18;

1.18
date	2002.08.04.03.53.11;	author momjian;	state Exp;
branches;
next	1.17;

1.17
date	2002.05.17.01.19.16;	author tgl;	state Exp;
branches;
next	1.16;

1.16
date	2002.03.06.06.48.05;	author momjian;	state Exp;
branches;
next	1.15;

1.15
date	2001.12.08.03.24.39;	author thomas;	state Exp;
branches;
next	1.14;

1.14
date	2001.09.14.08.47.00;	author ishii;	state Exp;
branches;
next	1.13;

1.13
date	2001.09.03.12.57.50;	author petere;	state Exp;
branches;
next	1.12;

1.12
date	2001.06.07.04.50.56;	author momjian;	state Exp;
branches;
next	1.11;

1.11
date	2000.12.25.23.15.26;	author petere;	state Exp;
branches;
next	1.10;

1.10
date	2000.06.18.21.24.54;	author petere;	state Exp;
branches;
next	1.9;

1.9
date	2000.04.08.02.39.02;	author tgl;	state Exp;
branches;
next	1.8;

1.8
date	2000.02.15.20.49.07;	author tgl;	state Exp;
branches;
next	1.7;

1.7
date	99.07.22.15.09.15;	author thomas;	state Exp;
branches;
next	1.6;

1.6
date	99.07.14.20.32.58;	author thomas;	state Exp;
branches;
next	1.5;

1.5
date	99.06.14.07.37.05;	author thomas;	state Exp;
branches;
next	1.4;

1.4
date	98.12.29.02.24.47;	author thomas;	state Exp;
branches;
next	1.3;

1.3
date	98.10.30.19.34.38;	author thomas;	state Exp;
branches;
next	1.2;

1.2
date	98.09.25.13.42.44;	author thomas;	state Exp;
branches;
next	1.1;

1.1
date	98.09.01.15.53.09;	author thomas;	state Exp;
branches;
next	;

1.30.2.1
date	2003.09.07.04.36.46;	author momjian;	state Exp;
branches;
next	;

1.39.2.1
date	2008.01.03.21.24.26;	author tgl;	state Exp;
branches;
next	;

1.42.2.1
date	2008.01.03.21.23.45;	author tgl;	state Exp;
branches;
next	;


desc
@@


1.50
log
@Make table in example less wide.
@
text
@<!--
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.49 2010/04/03 07:23:02 petere Exp $
PostgreSQL documentation
-->

<refentry id="SQL-SHOW">
 <refmeta>
  <refentrytitle>SHOW</refentrytitle>
  <manvolnum>7</manvolnum>
  <refmiscinfo>SQL - Language Statements</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>SHOW</refname>
  <refpurpose>show the value of a run-time parameter</refpurpose>
 </refnamediv>

 <indexterm zone="sql-show">
  <primary>SHOW</primary>
 </indexterm>

 <refsynopsisdiv>
<synopsis>
SHOW <replaceable class="PARAMETER">name</replaceable>
SHOW ALL
</synopsis>
 </refsynopsisdiv>

 <refsect1>
  <title>Description</title>

  <para>
   <command>SHOW</command> will display the current setting of
   run-time parameters. These variables can be set using the
   <command>SET</command> statement, by editing the
   <filename>postgresql.conf</filename> configuration file, through
   the <envar>PGOPTIONS</envar> environmental variable (when using
   <application>libpq</> or a <application>libpq</>-based
   application), or through command-line flags when starting the
   <command>postgres</command> server.  See <xref
   linkend="runtime-config"> for details.
  </para>
 </refsect1>

 <refsect1>
  <title>Parameters</title>

  <variablelist>
   <varlistentry>
    <term><replaceable class="PARAMETER">name</replaceable></term>
    <listitem>
     <para>
      The name of a run-time parameter.  Available parameters are
      documented in <xref linkend="runtime-config"> and on the <xref
      linkend="SQL-SET"> reference page.  In
      addition, there are a few parameters that can be shown but not
      set:

      <variablelist>
       <varlistentry>
        <term><literal>SERVER_VERSION</literal></term>
        <listitem>
         <para>
          Shows the server's version number.
         </para>
        </listitem>
       </varlistentry>

       <varlistentry>
        <term><literal>SERVER_ENCODING</literal></term>
        <listitem>
         <para>
          Shows the server-side character set encoding.  At present,
          this parameter can be shown but not set, because the
          encoding is determined at database creation time.
         </para>
        </listitem>
       </varlistentry>

       <varlistentry>
        <term><literal>LC_COLLATE</literal></term>
        <listitem>
         <para>
          Shows the database's locale setting for collation (text
          ordering).  At present, this parameter can be shown but not
          set, because the setting is determined at database creation
          time.
         </para>
        </listitem>
       </varlistentry>

       <varlistentry>
        <term><literal>LC_CTYPE</literal></term>
        <listitem>
         <para>
          Shows the database's locale setting for character
          classification.  At present, this parameter can be shown but
          not set, because the setting is determined at database creation
          time.
         </para>
        </listitem>
       </varlistentry>

       <varlistentry>
        <term><literal>IS_SUPERUSER</literal></term>
        <listitem>
         <para>
          True if the current role has superuser privileges.
         </para>
        </listitem>
       </varlistentry>
      </variablelist>
     </para>
    </listitem>
   </varlistentry>

   <varlistentry>
    <term><literal>ALL</literal></term>
    <listitem>
     <para>
      Show the values of all configuration parameters, with descriptions.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1>
  <title>Notes</title>

  <para>
   The function <function>current_setting</function> produces
   equivalent output; see <xref linkend="functions-admin">.
   Also, the
   <link linkend="view-pg-settings"><structname>pg_settings</structname></link>
   system view produces the same information.

  </para>
 </refsect1>

 <refsect1>
  <title>Examples</title>

  <para>
   Show the current setting of the parameter <varname>DateStyle</varname>:

<programlisting>
SHOW DateStyle;
 DateStyle
-----------
 ISO, MDY
(1 row)
</programlisting>
  </para>

  <para>
   Show the current setting of the parameter <varname>geqo</varname>:
<programlisting>
SHOW geqo;
 geqo
------
 on
(1 row)
</programlisting>
  </para>

  <para>
   Show all settings:
<programlisting>
SHOW ALL;
            name         | setting |                description                                                          
-------------------------+---------+-------------------------------------------------
 allow_system_table_mods | off     | Allows modifications of the structure of ...
    .
    .
    .
 xmloption               | content | Sets whether XML data in implicit parsing ...
 zero_damaged_pages      | off     | Continues processing past damaged page headers.
(196 rows)
</programlisting>
  </para>
 </refsect1>

 <refsect1>
  <title>Compatibility</title>

  <para>
   The <command>SHOW</command> command is a
   <productname>PostgreSQL</productname> extension.
  </para>
 </refsect1>

 <refsect1>
  <title>See Also</title>

  <simplelist type="inline">
   <member><xref linkend="SQL-SET"></member>
   <member><xref linkend="SQL-RESET"></member>
  </simplelist>
 </refsect1>

</refentry>
@


1.49
log
@Remove unnecessary xref endterm attributes and title ids

The endterm attribute is mainly useful when the toolchain does not support
automatic link target text generation for a particular situation.  In  the
past, this was required by the man page tools for all reference page links,
but that is no longer the case, and it now actually gets in the way of
proper automatic link text generation.  The only remaining use cases are
currently xrefs to refsects.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.48 2009/10/21 20:22:38 tgl Exp $
d171 3
a173 3
              name               |                     setting                     |                                                          description                                                          
---------------------------------+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------
 allow_system_table_mods         | off                                             | Allows modifications of the structure of system tables.
d177 2
a178 2
 xmloption                       | content                                         | Sets whether XML data in implicit parsing and serialization operations is to be considered as documents or content fragments.
 zero_damaged_pages              | off                                             | Continues processing past damaged page headers.
@


1.48
log
@Remove add_missing_from GUC and associated parser support for "implicit RTEs".
Per recent discussion, add_missing_from has been deprecated for long enough to
consider removing, and it's getting in the way of planned parser refactoring.
The system now always behaves as though add_missing_from were OFF.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.47 2008/11/14 10:22:47 petere Exp $
d8 1
a8 1
  <refentrytitle id="SQL-SHOW-TITLE">SHOW</refentrytitle>
d55 1
a55 1
      linkend="SQL-SET" endterm="SQL-SET-title"> reference page.  In
d197 2
a198 2
   <member><xref linkend="SQL-SET" endterm="SQL-SET-title"></member>
   <member><xref linkend="SQL-RESET" endterm="SQL-RESET-title"></member>
@


1.47
log
@Set SQL man pages to be section 7 by default, and only transform them to
another section if required by the platform (instead of the old way of
building them in section "l" and always transforming them to the
platform-specific section).

This speeds up the installation on common platforms, and it avoids some
funny business with the man page tools and build process.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.46 2008/09/23 09:20:35 heikki Exp $
d171 3
a173 4
              name              |            setting             |                                         description                                          
--------------------------------+--------------------------------+----------------------------------------------------------------------------------------------
 add_missing_from               | off                            | Automatically adds missing table references to FROM clauses.
 allow_system_table_mods        | off                            | Allows modifications of the structure of system tables.
d177 3
a179 3
 work_mem                       | 1024                           | Sets the maximum memory to be used for query workspaces.
 zero_damaged_pages             | off                            | Continues processing past damaged page headers.
(146 rows)
@


1.46
log
@Make LC_COLLATE and LC_CTYPE database-level settings. Collation and
ctype are now more like encoding, stored in new datcollate and datctype
columns in pg_database.

This is a stripped-down version of Radek Strnad's patch, with further
changes by me.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.45 2008/01/03 21:23:15 tgl Exp $
d9 1
@


1.45
log
@Make standard maintenance operations (including VACUUM, ANALYZE, REINDEX,
and CLUSTER) execute as the table owner rather than the calling user, using
the same privilege-switching mechanism already used for SECURITY DEFINER
functions.  The purpose of this change is to ensure that user-defined
functions used in index definitions cannot acquire the privileges of a
superuser account that is performing routine maintenance.  While a function
used in an index is supposed to be IMMUTABLE and thus not able to do anything
very interesting, there are several easy ways around that restriction; and
even if we could plug them all, there would remain a risk of reading sensitive
information and broadcasting it through a covert channel such as CPU usage.

To prevent bypassing this security measure, execution of SET SESSION
AUTHORIZATION and SET ROLE is now forbidden within a SECURITY DEFINER context.

Thanks to Itagaki Takahiro for reporting this vulnerability.

Security: CVE-2007-6600
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.44 2007/09/26 22:36:30 tgl Exp $
d85 2
a86 2
          set, because the setting is determined at
          <command>initdb</> time.
d97 2
a98 2
          not set, because the setting is determined at
          <command>initdb</> time.
@


1.44
log
@Minor improvements in backup and recovery:

- create a separate archive_mode GUC, on which archive_command is dependent

- %r option in recovery.conf sends last restartpoint to recovery command

- %r used in pg_standby, updated README

- minor other code cleanup in pg_standby

- doc on Warm Standby now mentions pg_standby and %r

- log_restartpoints recovery option emits LOG message at each restartpoint

- end of recovery now displays last transaction end time, as requested
  by Warren Little; also shown at each restartpoint

- restart archiver if needed to carry away WAL files at shutdown

Simon Riggs
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.43 2007/09/11 00:06:41 tgl Exp $
d107 1
a107 2
          True if the current session authorization identifier has
          superuser privileges.
@


1.43
log
@Arrange for SET LOCAL's effects to persist until the end of the current top
transaction, unless rolled back or overridden by a SET clause for the same
variable attached to a surrounding function call.  Per discussion, these
seem the best semantics.  Note that this is an INCOMPATIBLE CHANGE: in 8.0
through 8.2, SET LOCAL's effects disappeared at subtransaction commit
(leading to behavior that made little sense at the SQL level).

I took advantage of the opportunity to rewrite and simplify the GUC variable
save/restore logic a little bit.  The old idea of a "tentative" value is gone;
it was a hangover from before we had a stack.  Also, we no longer need a stack
entry for every nesting level, but only for those in which a variable's value
actually changed.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.42 2006/09/16 00:30:20 momjian Exp $
d174 1
a174 1
 archive_command                | unset                          | WAL archiving command.
@


1.42
log
@Remove emacs info from footer of SGML files.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.41 2006/07/25 03:51:21 tgl Exp $
d39 1
a39 1
   <command>postgres</command>.  See <xref
d133 5
a137 1
   equivalent output. See <xref linkend="functions-admin">.
@


1.42.2.1
log
@Make standard maintenance operations (including VACUUM, ANALYZE, REINDEX,
and CLUSTER) execute as the table owner rather than the calling user, using
the same privilege-switching mechanism already used for SECURITY DEFINER
functions.  The purpose of this change is to ensure that user-defined
functions used in index definitions cannot acquire the privileges of a
superuser account that is performing routine maintenance.  While a function
used in an index is supposed to be IMMUTABLE and thus not able to do anything
very interesting, there are several easy ways around that restriction; and
even if we could plug them all, there would remain a risk of reading sensitive
information and broadcasting it through a covert channel such as CPU usage.

To prevent bypassing this security measure, execution of SET SESSION
AUTHORIZATION and SET ROLE is now forbidden within a SECURITY DEFINER context.

Thanks to Itagaki Takahiro for reporting this vulnerability.

Security: CVE-2007-6600
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.42 2006/09/16 00:30:20 momjian Exp $
d107 2
a108 1
          True if the current role has superuser privileges.
@


1.41
log
@Remove hard-wired lists of timezone abbreviations in favor of providing
configuration files that can be altered by a DBA.  The australian_timezones
GUC setting disappears, replaced by a timezone_abbreviations setting (set this
to 'Australia' to get the effect of australian_timezones).  The list of zone
names defined by default has undergone a bit of cleanup, too.  Documentation
still needs some work --- in particular, should we fix Table B-4, or just get
rid of it?  Joachim Wieland, with some editorializing by moi.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.40 2006/06/18 15:38:36 petere Exp $
a199 17

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->
@


1.40
log
@Merge postmaster and postgres command into just postgres.  postmaster
symlink is kept for now for compatibility.  To call single-user mode, use
postgres --single.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.39 2005/06/14 20:42:52 momjian Exp $
a170 1
 australian_timezones           | off                            | Interprets ACST, CST, EST, and SAT as Australian time zones.
@


1.39
log
@Have SHOW ALL include variable descriptions.

Matthias Schmidt
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.38 2005/04/08 00:59:58 neilc Exp $
d39 1
a39 1
   <command>postmaster</command>.  See <xref
@


1.39.2.1
log
@Make standard maintenance operations (including VACUUM, ANALYZE, REINDEX,
and CLUSTER) execute as the table owner rather than the calling user, using
the same privilege-switching mechanism already used for SECURITY DEFINER
functions.  The purpose of this change is to ensure that user-defined
functions used in index definitions cannot acquire the privileges of a
superuser account that is performing routine maintenance.  While a function
used in an index is supposed to be IMMUTABLE and thus not able to do anything
very interesting, there are several easy ways around that restriction; and
even if we could plug them all, there would remain a risk of reading sensitive
information and broadcasting it through a covert channel such as CPU usage.

To prevent bypassing this security measure, execution of SET SESSION
AUTHORIZATION and SET ROLE is now forbidden within a SECURITY DEFINER context.

Thanks to Itagaki Takahiro for reporting this vulnerability.

Security: CVE-2007-6600
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.39 2005/06/14 20:42:52 momjian Exp $
d107 2
a108 1
          True if the current role has superuser privileges.
@


1.38
log
@Change the default setting of "add_missing_from" to false. This has been
the long-term plan for this behavior for quite some time, but it is only
possible now that DELETE has a USING clause so that the user can join
other tables in a DELETE statement without relying on this behavior.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.37 2005/01/04 03:58:16 tgl Exp $
d121 1
a121 1
      Show the values of all configuration parameters.
d167 5
a171 5
              name              |                     setting
--------------------------------+----------------------------------------------
 add_missing_from               | off
 archive_command                | unset
 australian_timezones           | off
d175 3
a177 3
 work_mem                       | 1024
 zero_damaged_pages             | off
(140 rows)
@


1.37
log
@More minor updates and copy-editing.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql/doc/src/sgml/ref/show.sgml,v 1.36 2004/08/03 20:32:32 tgl Exp $
d169 1
a169 1
 add_missing_from               | on
@


1.36
log
@Add functions pg_start_backup, pg_stop_backup to create backup label
and history files as per recent discussion.  While at it, remove
pg_terminate_backend, since we have decided we do not have time during
this release cycle to address the reliability concerns it creates.
Split the 'Miscellaneous Functions' documentation section into
'System Information Functions' and 'System Administration Functions',
which hopefully will draw the eyes of those looking for such things.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql-server/doc/src/sgml/ref/show.sgml,v 1.35 2004/01/06 17:26:23 neilc Exp $
d108 1
a108 1
	  superuser privileges.
d121 1
a121 1
      Show the values of all configurations parameters.
d167 5
a171 5
             name              |                setting
-------------------------------+---------------------------------------
 australian_timezones          | off
 authentication_timeout        | 60
 checkpoint_segments           | 3
d175 3
a177 3
 wal_debug                     | off
 wal_sync_method               | fdatasync
(94 rows)
d196 1
@


1.35
log
@Make the 'wal_debug' GUC variable a boolean (rather than an integer), and
hide it behind #ifdef WAL_DEBUG blocks.
@
text
@d2 1
a2 1
$PostgreSQL: pgsql-server/doc/src/sgml/ref/show.sgml,v 1.34 2003/11/29 19:51:39 pgsql Exp $
d133 1
a133 1
   equivalent output. See <xref linkend="functions-misc">.
@


1.34
log
@
$Header: -> $PostgreSQL Changes ...
@
text
@d2 1
a2 1
$PostgreSQL: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.33 2003/09/22 00:16:58 petere Exp $
d175 1
a175 1
 wal_debug                     | 0
@


1.33
log
@Make the SQL command synopses appear less random.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.32 2003/09/09 18:28:53 tgl Exp $
@


1.32
log
@Remove a bunch of content-free Diagnostics sections, as per previous
discussion.  (Still have some work to do editing the remainder.)
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.31 2003/08/31 17:32:24 petere Exp $
a23 2
</synopsis>
<synopsis>
@


1.31
log
@Add/edit index entries.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.30 2003/07/29 00:03:17 tgl Exp $
a123 16
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </refsect1>

 <refsect1>
  <title>Diagnostics</title>

  <variablelist>
   <varlistentry>
    <term><computeroutput>ERROR: Option '<replaceable>name</replaceable>' is not recognized</computeroutput></term>
    <listitem>
     <para>
      Message returned if <replaceable>name</replaceable> does not
      stand for a known parameter.
@


1.30
log
@Apply (a somewhat revised version of) Greg Mullane's patch to eliminate
heuristic determination of day vs month in date/time input.  Add the
ability to specify that input is interpreted as yy-mm-dd order (which
formerly worked, but only for yy greater than 31).  DateStyle's input
component now has the preferred spellings DMY, MDY, or YMD; the older
keywords European and US are now aliases for the first two of these.
Per recent discussions on pgsql-general.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.29 2003/07/15 19:19:56 tgl Exp $
d16 4
@


1.30.2.1
log
@Update this branch to match CVS head, includes WIN32 improvements.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.31 2003/08/31 17:32:24 petere Exp $
a15 4

 <indexterm zone="sql-show">
  <primary>SHOW</primary>
 </indexterm>
@


1.29
log
@Cause SHOW DATESTYLE to produce a string that will be accepted by SET
DATESTYLE, for instance 'SQL, European' instead of
'SQL with European conventions'.  Per gripe a month or two back from
Barry Lind.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.28 2003/06/27 19:08:37 tgl Exp $
d161 1
a161 1
 ISO, US
@


1.28
log
@Add is_superuser parameter reporting, soon to be used by psql.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.27 2003/05/14 03:26:00 tgl Exp $
d159 3
a161 3
               DateStyle
---------------------------------------
 ISO with US (NonEuropean) conventions
@


1.27
log
@Backend support for autocommit removed, per recent discussions.  The
only remnant of this failed experiment is that the server will take
SET AUTOCOMMIT TO ON.  Still TODO: provide some client-side autocommit
logic in libpq.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.26 2003/05/04 02:23:16 petere Exp $
d97 10
@


1.26
log
@Last round of reference page editing.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.25 2003/04/25 19:45:08 tgl Exp $
a38 6
  </para>

  <para>
   Even with <varname>autocommit</> set to <literal>off</>, <command>SHOW</>
   does not start a new transaction block. See the
   <varname>autocommit</> section in <xref linkend="runtime-config"> for details.
@


1.25
log
@In the continuing saga of FE/BE protocol revisions, add reporting of
initial values and runtime changes in selected parameters.  This gets
rid of the need for an initial 'select pg_client_encoding()' query in
libpq, bringing us back to one message transmitted in each direction
for a standard connection startup.  To allow server version to be sent
using the same GUC mechanism that handles other parameters, invent the
concept of a never-settable GUC parameter: you can 'show server_version'
but it's not settable by any GUC input source.  Create 'lc_collate' and
'lc_ctype' never-settable parameters so that people can find out these
settings without need for pg_controldata.  (These side ideas were all
discussed some time ago in pgsql-hackers, but not yet implemented.)
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.24 2003/03/25 16:15:44 petere Exp $
d11 1
d16 1
d18 1
a18 1
  <synopsis>
d20 2
a21 2
  </synopsis>
  <synopsis>
d23 1
a23 29
  </synopsis>

  <refsect2 id="R2-SQL-SHOW-1">
   <title>Inputs</title>

   <para>
    <variablelist>
     <varlistentry>
      <term><replaceable class="PARAMETER">name</replaceable></term>
      <listitem>
       <para>
        The name of a run-time parameter. See
	<xref linkend="sql-set" endterm="sql-set-title">
        for a list.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term>ALL</term>
      <listitem>
       <para>
        Show all current session parameters.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect2>

d26 1
a26 1
 <refsect1 id="R1-SQL-SHOW-1">
d28 1
d33 6
a38 5
   <filename>postgresql.conf</filename> configuration file, through the
   <envar>PGOPTIONS</envar> environmental variable (when using libpq
   or a libpq-based application), or through
   command-line flags when starting the
   <application>postmaster</application>.
d46 1
d48 2
a49 52
  <para>
   Available parameters are documented in
   <xref linkend="runtime-config"> and on the
   <xref linkend="SQL-SET" endterm="SQL-SET-title"> reference page.
   In addition, there are a few parameters that can be shown but not set:

   <variablelist>

    <varlistentry>
     <term>SERVER_VERSION</term>
     <listitem>
      <para>
       Shows the server's version number.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>SERVER_ENCODING</term>
     <listitem>
      <para>
       Shows the server-side multibyte encoding.  At present, this
       parameter can be shown but not set, because the encoding is
       determined at database creation time.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>LC_COLLATE</term>
     <listitem>
      <para>
       Shows the database's locale setting for collation (text ordering).
       At present, this parameter can be shown but not set, because the
       setting is determined at <application>initdb</> time.
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>LC_CTYPE</term>
     <listitem>
      <para>
       Shows the database's locale setting for character set considerations.
       At present, this parameter can be shown but not set, because the
       setting is determined at <application>initdb</> time.
      </para>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>
d51 69
a119 4
  <para>
   Use <xref linkend="SQL-SET" endterm="SQL-SET-title"> to set the value
   of settable parameters.
  </para>
d125 11
a135 14
   <para>
    <variablelist>
     <varlistentry>
      <term><computeroutput>ERROR: Option '<replaceable>name</replaceable>'
	  is not recognized</computeroutput></term>
      <listitem>
       <para>
	Message returned if <replaceable>name</replaceable> does
	not stand for a known parameter.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
d147 1
a147 1
 <refsect1 id="R1-SQL-SHOW-2">
d149 1
d151 1
a151 1
   Show the current <varname>DateStyle</varname> setting:
d163 1
a163 2
   Show whether the genetic query optimizer is enabled by displaying
   the <varname>geqo</varname> setting:
d165 1
a165 1
SHOW GEQO;
a189 1

d192 1
a192 1
 <refsect1 id="R1-SQL-SHOW-3">
d200 9
@


1.24
log
@Merge documentation into one book.  (Build with "make html".)  Replace
vague cross-references with real links.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.23 2003/01/19 00:13:31 momjian Exp $
d55 2
a56 2
   <command>SHOW</command> will display the current setting of a
   run-time parameter. These variables can be set using the
d58 4
a61 3
   <filename>postgresql.conf</filename>, through the
   <envar>PGOPTIONS</envar> environmental variable, or through a
   command-line flag when starting the
d70 58
d141 1
a141 1
	not stand for an existing parameter.
@


1.23
log
@This patch includes a lot of minor cleanups to the SGML documentation,
including:

- replacing all the appropriate usages of <citetitle>PostgreSQL
...</citetitle> with &cite-user;, &cite-admin;, and so on

- fix an omission in the EXECUTE documentation

- add some more text to the EXPLAIN documentation

- improve the PL/PgSQL RETURN NEXT documentation (more work to do here)

- minor markup fixes


Neil Conway
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.22 2002/10/13 16:55:05 tgl Exp $
d67 1
a67 1
   <varname>autocommit</> section of the &cite-admin; for details.
d90 9
a150 10
  </para>
 </refsect1>

 <refsect1>
  <title>See Also</title>

  <para>
    The function <function>current_setting</function> produces equivalent
    output. See <citetitle>Miscellaneous Functions</citetitle> in the
    &cite-user;.
@


1.22
log
@Make SET really not start a transaction.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.21 2002/09/01 01:59:48 momjian Exp $
d65 1
a65 1
   Even with <literal>autocommit</> set to <literal>off</>, <command>SHOW</>
d67 1
a67 2
   <literal>autocommit</> section of the <citetitle>Administrator's
   Guide</citetitle> for details.
d93 1
a93 1
   Show the current <literal>DateStyle</literal> setting:
d105 2
a106 1
   Show the current genetic optimizer (<literal>geqo</literal>) setting:
d151 1
a151 1
    <citetitle>PostgreSQL User's Guide</citetitle>.
@


1.21
log
@Remove mention of wal_files in a SHOW example.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.20 2002/08/04 05:46:02 tgl Exp $
d62 7
@


1.20
log
@Fix broken markup.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.19 2002/08/04 05:09:36 momjian Exp $
a121 1
 wal_files                     | 0
@


1.19
log
@This patch fixes a probably harmless write of uninitialized memory in
the statistics collector and makes a number of corrections to the
documentation for SET, SHOW, and COPY.

Neil Conway
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.18 2002/08/04 03:53:11 momjian Exp $
a100 1
<screen>
d111 1
a111 1
<screen>
d125 1
a125 1
</screen>
@


1.18
log
@Here is a doc patch for the SHOW X changes and new config-settings
functions. If there are no objections, please apply.

Joe Conway
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql-server/doc/src/sgml/ref/show.sgml,v 1.17 2002/05/17 01:19:16 tgl Exp $
d57 5
a61 1
   <command>SET</command> statement or are determined at session start.
d71 2
a72 1
      <term><computeroutput>ERROR:  not a valid option name: <replaceable>name</replaceable></computeroutput></term>
d75 1
a75 1
	Message returned if <replaceable>variable</replaceable> does
d89 1
a89 1
<screen>
d95 1
a95 1
</screen>
d100 1
d107 1
a107 1
</screen>
@


1.17
log
@Merge the last few variable.c configuration variables into the generic
GUC support.  It's now possible to set datestyle, timezone, and
client_encoding from postgresql.conf and per-database or per-user
settings.  Also, implement rollback of SET commands that occur in a
transaction that later fails.  Create a SET LOCAL var = value syntax
that sets the variable only for the duration of the current transaction.
All per previous discussions in pghackers.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.16 2002/03/06 06:48:05 momjian Exp $
d86 4
a89 1
INFO:  DateStyle is ISO with US (NonEuropean) conventions
d97 4
a100 1
INFO:  geqo is on
d103 20
d131 10
@


1.16
log
@Update reference pages for new INFO, NOTICE, WARNING elog() levels.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.15 2001/12/08 03:24:39 thomas Exp $
d57 1
a57 1
   <command>SET</command> statement or are determined at server start.
a71 19
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><computeroutput>ERROR:  permission denied</computeroutput></term>
      <listitem>
       <para>
        You must be a superuser to be allowed to see certain settings.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry>
      <term><computeroutput>WARNING:  Time zone is unknown</computeroutput></term>
      <listitem>
       <para>
	If the <envar>TZ</envar> or <envar>PGTZ</envar> environment
	variable is not set.
@


1.15
log
@Use PostgreSQL consistantly throughout docs. Before, usage was split evenly
 between Postgres and PostgreSQL.
@
text
@d2 1
a2 1
$Header: /cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.14 2001/09/14 08:47:00 ishii Exp $
d86 1
a86 1
      <term><computeroutput>NOTICE:  Time zone is unknown</computeroutput></term>
d105 1
a105 1
NOTICE:  DateStyle is ISO with US (NonEuropean) conventions
d113 1
a113 1
NOTICE:  geqo is on
@


1.14
log
@Fix show message

    Tatsuo Ishii
@
text
@d2 2
a3 2
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.13 2001/09/03 12:57:50 petere Exp $
Postgres documentation
d123 1
a123 1
   <productname>Postgres</productname> extension.
@


1.13
log
@Put some kind of grammatical uniformity in the <refpurpose> lines.
@
text
@d2 1
a2 1
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.12 2001/06/07 04:50:56 momjian Exp $
d113 1
a113 1
NOTICE:  geqo = true
@


1.12
log
@reset all: command line and .conf options change defaults
on RESET ALL those are restored.

show all: GUC + non-GUC.

SHOW ALL, RESET ALL

Marko Kreen
@
text
@d2 1
a2 1
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.11 2000/12/25 23:15:26 petere Exp $
d13 1
a13 1
  <refpurpose>Shows run-time parameters</refpurpose>
@


1.11
log
@Refine some things to create better looking man pages.
@
text
@d2 1
a2 1
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.10 2000/06/18 21:24:54 petere Exp $
d19 3
d35 8
@


1.10
log
@Separated set constraints and set transaction reference pages, revised set
reference page to new configuration system. Big update to administrator's
guide, chapters Runtime environment, Client authentication, and User
management, the latter two were part of the old Security chapter.
@
text
@d2 1
a2 1
$Header: /home/projects/pgsql/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.9 2000/04/08 02:39:02 tgl Exp $
d30 1
a30 1
	<xref linkend="sql-set-title" endterm="sql-set-title">
@


1.9
log
@Fix cross-references, update examples, copy-edit.
@
text
@d2 1
a2 1
$Header: /usr/local/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.8 2000/02/15 20:49:07 tgl Exp $
d8 1
a8 3
  <refentrytitle id="SQL-SHOW-TITLE">
   SHOW
  </refentrytitle>
d12 2
a13 6
  <refname>
   SHOW
  </refname>
  <refpurpose>
   Shows run-time parameters for session
  </refpurpose>
a15 3
  <refsynopsisdivinfo>
   <date>1999-07-20</date>
  </refsynopsisdivinfo>
d17 1
a17 1
SHOW <replaceable class="PARAMETER">keyword</replaceable>
d21 1
a21 6
   <refsect2info>
    <date>1998-09-24</date>
   </refsect2info>
   <title>
    Inputs
   </title>
d26 1
a26 1
      <term><replaceable class="PARAMETER">keyword</replaceable></term>
d29 1
a29 1
	Refer to
d31 1
a31 1
	for more information on available variables.
d39 13
a51 7
  <refsect2 id="R2-SQL-SHOW-2">
   <refsect2info>
    <date>1998-09-24</date>
   </refsect2info>
   <title>
    Outputs
   </title>
d56 1
a56 3
      <term><computeroutput>
NOTICE: <replaceable class="PARAMETER">variable</replaceable> is <replaceable>value</replaceable>
       </computeroutput></term>
d59 2
a60 1
	Message returned if successful.
d64 1
d66 1
a66 3
      <term><computeroutput>
NOTICE:  Unrecognized variable <replaceable>value</replaceable>
       </computeroutput></term>
d69 1
a69 1
	Message returned if <returnvalue>variable</returnvalue> does not exist.
d75 1
a75 3
      <term><computeroutput>
NOTICE:  Time zone is unknown
       </computeroutput></term>
a84 36
  </refsect2>
 </refsynopsisdiv>

 <refsect1 id="R1-SQL-SHOW-1">
  <refsect1info>
   <date>1998-09-24</date>
  </refsect1info>
  <title>
   Description
  </title>
  <para>
   <command>SHOW</command> will display the current setting of a
   run-time parameter during a session.
  </para>
  <para>
   These variables can be set using the <command>SET</command> statement,
   and
   can be restored to the default values using the <command>RESET</command>
   statement.
   Parameters and values are case-insensitive.
  </para>

  <refsect2 id="R2-SQL-SHOW-3">
   <refsect2info>
    <date>1998-09-24</date>
   </refsect2info>
   <title>
    Notes
   </title>
   <para>
    See also
    <xref linkend="sql-set-title" endterm="sql-set-title"> and
    <xref linkend="sql-reset-title" endterm="sql-reset-title">
    to manipulate variable values.
   </para>
  </refsect2>
d88 1
a88 3
  <title>
   Usage
  </title>
d92 1
a92 1
   <programlisting>
d95 1
a95 1
   </programlisting>
d100 1
a100 1
   <programlisting>
d102 2
a103 2
NOTICE:  GEQO is ON beginning with 11 relations
   </programlisting>
d108 6
a113 15
  <title>
   Compatibility
  </title>

  <refsect2 id="R2-SQL-SHOW-4">
   <refsect2info>
    <date>1998-09-24</date>
   </refsect2info>
   <title>
    SQL92
   </title>
   <para>
    There is no <command>SHOW</command> defined in <acronym>SQL92</acronym>.
   </para>
  </refsect2>
@


1.8
log
@New cost model for planning, incorporating a penalty for random page
accesses versus sequential accesses, a (very crude) estimate of the
effects of caching on random page accesses, and cost to evaluate WHERE-
clause expressions.  Export critical parameters for this model as SET
variables.  Also, create SET variables for the planner's enable flags
(enable_seqscan, enable_indexscan, etc) so that these can be controlled
more conveniently than via PGOPTIONS.

Planner now estimates both startup cost (cost before retrieving
first tuple) and total cost of each path, so it can optimize queries
with LIMIT on a reasonable basis by interpolating between these costs.
Same facility is a win for EXISTS(...) subqueries and some other cases.

Redesign pathkey representation to achieve a major speedup in planning
(I saw as much as 5X on a 10-way join); also minor changes in planner
to reduce memory consumption by recycling discarded Path nodes and
not constructing unnecessary lists.

Minor cleanups to display more-plausible costs in some cases in
EXPLAIN output.

Initdb forced by change in interface to index cost estimation
functions.
@
text
@d2 1
a2 1
$Header: /usr/local/cvsroot/pgsql/doc/src/sgml/ref/show.sgml,v 1.7 1999/07/22 15:09:15 thomas Exp $
d43 3
a45 2
	Refer to <command>SET</command> for more information on available
	arguments.
a65 1
SHOW VARIABLE
d79 1
a79 1
	Message returned if <returnvalue>value</returnvalue> does not exist.
a86 1
SHOW VARIABLE
d127 4
a130 6
    <command>SHOW</command> is a <productname>Postgres</productname>
    language extension.
   </para>
   <para>
    Refer to  <command>SET</command>/<command>RESET</command> 
    to set/reset variable values.
d144 1
a144 1
NOTICE:DateStyle is Postgres with US (NonEuropean) conventions
d152 1
a152 1
NOTICE:GEQO is ON
@


1.7
log
@Complete merge of all old man page information.
ecpg reference page still needs formatting.
@
text
@d2 1
a2 1
$Header$
d109 2
a110 3
   <command>SHOW</command> will display the current
   configuration parameters for
   variable during a session.
d113 4
a116 3
   The session can be configured using <command>SET</command> statement,
   and values
   can be restored to the defaults using <command>RESET</command> statement.
d128 1
a128 1
    The <command>SHOW</command> is a <productname>Postgres</productname>
a133 1
    See also  <command>SET TIME ZONE</command>.
@


1.6
log
@Complete first pass at markup adjustments for docbook2man man pages.
Add some internal cross references to select.sgml.
@
text
@d1 5
d8 1
a8 1
  <refentrytitle>
d23 1
a23 1
   <date>1998-09-24</date>
a164 2
  <para>
  </para>
@


1.5
log
@Minor updates for release.
Split reference pages for CREATE TABLE AS and SELECT INTO to allow psgml
 (the emacs parser) to handle parsing.
@
text
@d21 1
a21 1
SHOW <replaceable class="PARAMETER">variable</replaceable>
d31 1
a32 1

d35 1
a35 3
      <term>
       <replaceable class="PARAMETER">variable</replaceable>
      </term>
d39 1
a39 1
	variables.
d54 1
a55 1

d58 4
a61 5
      <term>
       <returnvalue>NOTICE: <replaceable
	 class="PARAMETER">">variab</replaceable>E> is <replaceable>value</replaceable></returnvalue>
       SHOW VARIABLE
      </term>
d64 1
a64 1
	Message returned if successfully.
d69 3
a71 3
      <term>
       <returnvalue>NOTICE:  Unrecognized variable <replaceable>value</replaceable></returnvalue>
      </term>
d78 1
a78 1
     
d80 4
a83 4
      <term>
       NOTICE:  Time zone is unknown
       SHOW VARIABLE
      </term>
d86 2
a87 1
	If the TZ environment variable is not set.
d139 2
a141 1
-- show DateStyle;
d144 2
d147 3
a149 1
-- show Geqo;
d189 1
a189 1
sgml-local-catalogs:"/usr/lib/sgml/CATALOG"
@


1.4
log
@Clean up to ensure tag completion as required by the newest versions
 of Norm's Modular Style Sheets and jade/docbook.
From Vince Vielhaber <vev@@michvhf.com>.
@
text
@d1 189
a189 171
<REFENTRY ID="SQL-SHOW">
<REFMETA>
<REFENTRYTITLE>
SHOW
</REFENTRYTITLE>
<REFMISCINFO>SQL - Language Statements</REFMISCINFO>
</REFMETA>
<REFNAMEDIV>
<REFNAME>
SHOW
</REFNAME>
<REFPURPOSE>
Shows run-time parameters for session
</REFPURPOSE>
  </refnamediv>
<REFSYNOPSISDIV>
<REFSYNOPSISDIVINFO>
<DATE>1998-09-24</DATE>
</REFSYNOPSISDIVINFO>
<SYNOPSIS>
SHOW <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE>
</SYNOPSIS>

	<REFSECT2 ID="R2-SQL-SHOW-1">
	  <REFSECT2INFO>
		<DATE>1998-09-24</DATE>
	  </REFSECT2INFO>
	  <TITLE>
		Inputs
	  </TITLE>
	  <PARA>
		
		<VARIABLELIST>
		  <VARLISTENTRY>
			<TERM>
			  <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE>
			</TERM>
			<LISTITEM>
			  <PARA>
				Refer to <command>SET</command> for more information on available
				variables.
			  </para>
			</listitem>
		  </VARLISTENTRY>
		</VARIABLELIST>
	  </para>
	</REFSECT2>

	<REFSECT2 ID="R2-SQL-SHOW-2">
	  <REFSECT2INFO>
		<DATE>1998-09-24</DATE>
	  </REFSECT2INFO>
	  <TITLE>
		Outputs
	  </TITLE>
	  <PARA>
		
		<VARIABLELIST>
		  <VARLISTENTRY>
			<TERM>
			  <returnvalue>NOTICE: <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE> is <replaceable>value</replaceable></ReturnValue>
			  SHOW VARIABLE
			</TERM>
			<LISTITEM>
			  <PARA>
				Message returned if successfully.
			  </para>
			</listitem>
		  </varlistentry>
		  <VARLISTENTRY>
			<TERM>
			  <returnvalue>NOTICE:  Unrecognized variable <replaceable>value</replaceable></ReturnValue>
			</TERM>
			<LISTITEM>
			  <PARA>
				Message returned if <ReturnValue>value</ReturnValue> does not exist.
			  </PARA>
			</LISTITEM>
		  </VARLISTENTRY>
		  
		  <VARLISTENTRY>
			<TERM>
			  NOTICE:  Time zone is unknown
			  SHOW VARIABLE
			</TERM>
			<LISTITEM>
			  <PARA>
				If the TZ environment variable is not set.
			  </para>
			</listitem>
		  </varlistentry>
		</VARIABLELIST>
	  </para>
	</REFSECT2>
  </REFSYNOPSISDIV>

  <REFSECT1 ID="R1-SQL-SHOW-1">
	<REFSECT1INFO>
	  <DATE>1998-09-24</DATE>
	</REFSECT1INFO>
	<TITLE>
	  Description
	</TITLE>
	<PARA>
	  <command>SHOW</command> will display the current
	  configuration parameters for
	  variable during a session.
	</para>
	<para>
	  The session can be configured using <command>SET</command> statement,
	  and values
	  can be restored to the defaults using <command>RESET</command> statement.
	  Parameters and values are case-insensitive.
	</para>

	<REFSECT2 ID="R2-SQL-SHOW-3">
	  <REFSECT2INFO>
		<DATE>1998-09-24</DATE>
	  </REFSECT2INFO>
	  <TITLE>
		Notes
	  </TITLE>
	  <PARA>
		The <command>SHOW</command> is a <productname>Postgres</productname>
		language extension.
	  </para>
	  <para>
		Refer to  <command>SET</command>/<command>RESET</command> 
		to set/reset variable values.
		See also  <command>SET TIME ZONE</command>.
	  </para>
	</REFSECT2>
  </REFSECT1>

  <REFSECT1 ID="R1-SQL-SHOW-2">
	<TITLE>
	  Usage
	</TITLE>
	<PARA>
	  <ProgramListing>
		-- show DateStyle;
		SHOW DateStyle;
		NOTICE:DateStyle is Postgres with US (NonEuropean) conventions
		
		-- show Geqo;
		SHOW GEQO;
		NOTICE:GEQO is ON
	  </ProgramListing>
	</para>
  </REFSECT1>

  <REFSECT1 ID="R1-SQL-SHOW-3">
	<TITLE>
	  Compatibility
	</TITLE>
	<PARA>
	</PARA>
	
	<REFSECT2 ID="R2-SQL-SHOW-4">
	  <REFSECT2INFO>
		<DATE>1998-09-24</DATE>
	  </REFSECT2INFO>
	  <TITLE>
		SQL92
	  </TITLE>
	  <PARA>
		There is no <command>SET</command> defined in <acronym>SQL92</acronym>.
	  </para>
	</refsect2>
  </refsect1>
</REFENTRY>
@


1.3
log
@Minor cleanup in markup, especially in the Output section.
@
text
@d15 1
d24 147
a170 140
<REFSECT2 ID="R2-SQL-SHOW-1">
<REFSECT2INFO>
<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
Inputs
</TITLE>
<PARA>

<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>
          Refer to <command>SET</command> for more information on available
          variables.
</VARLISTENTRY>
</VARIABLELIST>
        
</REFSECT2>

<REFSECT2 ID="R2-SQL-SHOW-2">
<REFSECT2INFO>
<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
Outputs
</TITLE>
<PARA>

<VARIABLELIST>
<VARLISTENTRY>
<TERM>
<returnvalue>NOTICE: <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE> is <replaceable>value</replaceable></ReturnValue>
SHOW VARIABLE
</TERM>
<LISTITEM>
<PARA>
          Message returned if successfully.
</listitem>

<VARLISTENTRY>
<TERM>
<returnvalue>NOTICE:  Unrecognized variable <replaceable>value</replaceable></ReturnValue>
</TERM>
<LISTITEM>
<PARA>
Message returned if <ReturnValue>value</ReturnValue> does not exist.
</PARA>
</LISTITEM>
</VARLISTENTRY>

<VARLISTENTRY>
<TERM>
NOTICE:  Time zone is unknown
SHOW VARIABLE
</TERM>
<LISTITEM>
<PARA>
   If the TZ environment variable is not set.

</VARIABLELIST>

</REFSECT2>
</REFSYNOPSISDIV>

<REFSECT1 ID="R1-SQL-SHOW-1">
<REFSECT1INFO>
<DATE>1998-09-24</DATE>
</REFSECT1INFO>
<TITLE>
Description
</TITLE>
<PARA>
   <command>SHOW</command> will display the current
 configuration parameters for
   variable during a session.

<para>
   The session can be configured using <command>SET</command> statement,
 and values
   can be restored to the defaults using <command>RESET</command> statement.
   Parameters and values are case-insensitive.

<REFSECT2 ID="R2-SQL-SHOW-3">
<REFSECT2INFO>
<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
Notes
</TITLE>
<PARA>
   The <command>SHOW</command> is a <productname>Postgres</productname>
 language extension.

<para>
   Refer to  <command>SET</command>/<command>RESET</command> 
 to set/reset variable values.
   See also  <command>SET TIME ZONE</command>.

</REFSECT2>
</REFSECT1>

<REFSECT1 ID="R1-SQL-SHOW-2">
<TITLE>
Usage
</TITLE>
<PARA>
<ProgramListing>
-- show DateStyle;
SHOW DateStyle;
NOTICE:DateStyle is Postgres with US (NonEuropean) conventions

-- show Geqo;
SHOW GEQO;
NOTICE:GEQO is ON
</ProgramListing>

</REFSECT1>

<REFSECT1 ID="R1-SQL-SHOW-3">
<TITLE>
Compatibility
</TITLE>
<PARA>
</PARA>

<REFSECT2 ID="R2-SQL-SHOW-4">
<REFSECT2INFO>
<DATE>1998-09-24</DATE>
</REFSECT2INFO>
<TITLE>
SQL92
</TITLE>
<PARA>
    There is no <command>SET</command> defined in <acronym>SQL92</acronym>.
</refsect2>
</refsect1>
@


1.2
log
@Cleanup markup and minor editing to prepare for first release.
@
text
@a57 8
<REPLACEABLE>status</REPLACEABLE>
</TERM>
<LISTITEM>
<PARA>

<VARIABLELIST>
<VARLISTENTRY>
<TERM>
a85 1
</VARIABLELIST>
@


1.1
log
@Add new files from Oliver and Thomas.
@
text
@d17 1
a17 1
<DATE>1998-08-31</DATE>
d25 1
a25 1
<DATE>1998-08-31</DATE>
d31 1
a31 1
</PARA>
d39 1
a39 1
          Refer to the SET statement for more information on available
d48 1
a48 1
<DATE>1998-08-31</DATE>
d54 9
a62 1
</PARA>
d66 1
a66 1
NOTICE: <REPLACEABLE CLASS="PARAMETER">variable</REPLACEABLE> is <ReturnValue>value</ReturnValue>
d73 1
d76 2
a77 1
NOTICE:  Unrecognized variable <ReturnValue>value</ReturnValue>
d84 10
d95 2
d102 1
a102 1
<DATE>1998-08-31</DATE>
d108 2
a109 1
   SHOW will display the current configuration parameters for
d113 3
a115 2
   The session can be configured using SET statement, and values
   can be restored to the defaults using RESET statement.
d120 1
a120 1
<DATE>1998-08-31</DATE>
d126 1
a126 1
   The SHOW statement is a <productname>Postgres</productname>
d130 3
a132 2
   Refer to the SET/RESET statements to set/reset variable values.
   See also the SET TIME ZONE statement.
a133 3
<para>
   If the TZ environment variable is not set the SHOW TIME ZONE statement
   gives the message: Time zone is unknown
d143 7
a149 7
   -- show DateStyle;
   SHOW DateStyle;
   NOTICE:DateStyle is Postgres with US (NonEuropean) conventions

   -- show Geqo;
   SHOW GEQO;
   NOTICE:GEQO is ON
d163 1
a163 1
<DATE>1998-08-31</DATE>
d169 1
a169 1
    There is no SET statement defined in <acronym>SQL92</acronym>.
@
