granicus.if.org Git - postgresql/blob - doc/src/sgml/ref/reset.sgml

   1 <!--
   2 $Header: /cvsroot/pgsql/doc/src/sgml/ref/reset.sgml,v 1.24 2003/09/22 00:16:58 petere Exp $
   3 PostgreSQL documentation
   4 -->
   5
   6 <refentry id="SQL-RESET">
   7  <refmeta>
   8   <refentrytitle id="SQL-RESET-TITLE">RESET</refentrytitle>
   9   <refmiscinfo>SQL - Language Statements</refmiscinfo>
  10  </refmeta>
  11
  12  <refnamediv>
  13   <refname>RESET</refname>
  14   <refpurpose>restore the value of a run-time parameter to the default value</refpurpose>
  15  </refnamediv>
  16
  17  <indexterm zone="sql-reset">
  18   <primary>RESET</primary>
  19  </indexterm>
  20
  21  <refsynopsisdiv>
  22 <synopsis>
  23 RESET <replaceable class="PARAMETER">name</replaceable>
  24 RESET ALL
  25 </synopsis>
  26  </refsynopsisdiv>
  27
  28  <refsect1>
  29   <title>Description</title>
  30
  31   <para>
  32    <command>RESET</command> restores run-time parameters to their
  33    default values.  <command>RESET</command> is an alternative
  34    spelling for
  35 <synopsis>
  36 SET <replaceable class="parameter">parameter</replaceable> TO DEFAULT
  37 </synopsis>
  38    Refer to <xref linkend="sql-set" endterm="sql-set-title"> for
  39    details.
  40   </para>
  41
  42   <para>
  43    The default value is defined as the value that the parameter would
  44    have had, had no <command>SET</> ever been issued for it in the
  45    current session.  The actual source of this value might be a
  46    compiled-in default, the configuration file, command-line options,
  47    or per-database or per-user default settings.  See <xref
  48    linkend="runtime-config"> for details.
  49   </para>
  50
  51   <para>
  52    See the <command>SET</> reference page for details on the
  53    transaction behavior of <command>RESET</>.
  54   </para>
  55  </refsect1>
  56
  57  <refsect1>
  58   <title>Parameters</title>
  59
  60   <variablelist>
  61    <varlistentry>
  62     <term><replaceable class="PARAMETER">name</replaceable></term>
  63     <listitem>
  64      <para>
  65       The name of a run-time parameter. See <xref linkend="sql-set"
  66       endterm="sql-set-title"> for a list.
  67      </para>
  68     </listitem>
  69    </varlistentry>
  70
  71    <varlistentry>
  72     <term><literal>ALL</literal></term>
  73     <listitem>
  74      <para>
  75       Resets all settable run-time parameters to default values.
  76      </para>
  77     </listitem>
  78    </varlistentry>
  79   </variablelist>
  80  </refsect1>
  81
  82  <refsect1>
  83   <title>Examples</title>
  84
  85   <para>
  86    Set <varname>DATESTYLE</> to its default value:
  87 <screen>
  88 RESET datestyle;
  89 </screen>
  90   </para>
  91
  92   <para>
  93    Set <varname>GEQO</> to its default value:
  94 <screen>
  95 RESET geqo;
  96 </screen>
  97   </para>
  98  </refsect1>
  99
 100  <refsect1>
 101   <title>Compatibility</title>
 102
 103   <para>
 104    <command>RESET</command> is a <productname>PostgreSQL</productname> extension.
 105   </para>
 106  </refsect1>
 107 </refentry>
 108
 109 <!-- Keep this comment at the end of the file
 110 Local variables:
 111 mode: sgml
 112 sgml-omittag:nil
 113 sgml-shorttag:t
 114 sgml-minimize-attributes:nil
 115 sgml-always-quote-attributes:t
 116 sgml-indent-step:1
 117 sgml-indent-data:t
 118 sgml-parent-document:nil
 119 sgml-default-dtd-file:"../reference.ced"
 120 sgml-exposed-tags:nil
 121 sgml-local-catalogs:"/usr/lib/sgml/catalog"
 122 sgml-local-ecat-files:nil
 123 End:
 124 -->