<!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/pg_controldata.sgml,v 1.4 2002/08/17 05:07:18 tgl Exp $
PostgreSQL documentation
-->

<refentry id="APP-PGCONTROLDATA">
 <refmeta>
  <refentrytitle id="APP-PGCONTROLDATA-TITLE"><application>pg_controldata</application></refentrytitle>
  <manvolnum>1</manvolnum>
  <refmiscinfo>Application</refmiscinfo>
 </refmeta>

 <refnamediv>
  <refname>pg_controldata</refname>
  <refpurpose>display server-wide control information</refpurpose>
 </refnamediv>

 <refsynopsisdiv>
  <cmdsynopsis>
   <command>pg_controldata</command>
   <arg><replaceable class="parameter">datadir</replaceable></arg>
  </cmdsynopsis>
 </refsynopsisdiv>

 <refsect1 id="R1-APP-PGCONTROLDATA-1">
  <title>Description</title>
  <para>
   <command>pg_controldata</command> returns information initialized during
   <application>initdb</>, such as the catalog version and server locale.
   It also shows information about write-ahead logging and checkpoint 
   processing.  This information is server-wide, and not specific to any one
   database.
  </para>

  <para>
   This utility may only be run by the user who installed the server because
   it requires read access to the <literal>datadir</>.
   You can specify the data directory on the command line, or use 
   the environment variable <envar>PGDATA</>.
  </para>
 </refsect1>

 <refsect1>
  <title>Environment</title>

  <variablelist>
   <varlistentry>
    <term><envar>PGDATA</envar></term>

    <listitem>
     <para>
      Default data directory location
     </para>
    </listitem>
   </varlistentry>

  </variablelist>
 </refsect1>
</refentry>

<!-- 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:
-->
