<!--
$Header: /home/postgres/cvs_root/pgsql-r-v7.2/doc/src/sgml/ref/current_user.sgml,v 1.1.1.1 2002/02/07 17:50:39 bpalmer Exp $
PostgreSQL documentation
-->

<REFENTRY ID="SQL-CURRENT-USER">
 <REFMETA>
  <REFENTRYTITLE>
   SQL_CURRENT_USER
  </REFENTRYTITLE>
  <REFMISCINFO>SQL - Functions</REFMISCINFO>
 </REFMETA>
 <REFNAMEDIV>
  <REFNAME>
   CURRENT_USER
  </REFNAME>
  <REFPURPOSE>
   Returns the current user name
  </REFPURPOSE>
 <REFSYNOPSISDIV>
  <REFSYNOPSISDIVINFO>
   <DATE>1998-04-15</DATE>
  </REFSYNOPSISDIVINFO>
  <SYNOPSIS>
   CURRENT_USER 
  </SYNOPSIS>
  
  <REFSECT2 ID="R2-SQL-CURRENT-USER-1">
   <REFSECT2INFO>
    <DATE>1998-04-15</DATE>
   </REFSECT2INFO>
   <TITLE>
    Inputs
   </TITLE>
   <PARA>

None.
  </REFSECT2>
  
  <REFSECT2 ID="R2-SQL-CURRENT-USER-2">
   <REFSECT2INFO>
    <DATE>1998-04-15</DATE>
   </REFSECT2INFO>
   <TITLE>
    Outputs
   </TITLE>
   <PARA>

       <VARIABLELIST>
	<VARLISTENTRY>
	 <TERM>
	  <replaceable>username</replaceable>
	 </TERM>
	 <LISTITEM>
	  <PARA>
The name of the current user.

   </VARIABLELIST>
  </REFSECT2>
 </REFSYNOPSISDIV>
 
 <REFSECT1 ID="R1-SQL-CURRENT-USER-1">
  <REFSECT1INFO>
   <DATE>1998-04-15</DATE>
  </REFSECT1INFO>
  <TITLE>
   Description
  </TITLE>
  <PARA>
   The niladic CURRENT_USER function returns a string of type "name"
   whose value represents a user name identification.
  </PARA>
  
  <REFSECT2 ID="R2-SQL-CURRENT-USER-3">
   <REFSECT2INFO>
    <DATE>1998-04-15</DATE>
   </REFSECT2INFO>
   <TITLE>
    Notes
   </TITLE>
   <PARA>
    Data type "name" is a non-standard 31-character type for storing
    system identifiers.
   </PARA>
  </REFSECT2>
  
 <REFSECT1 ID="R1-SQL-CURRENT-USER-2">
  <TITLE>
   Usage
  </TITLE>
  <PARA>
   Display CURRENT_USER
  </PARA>
  <ProgramListing>
   SELECT CURRENT_USER AS who_am_i;

   who_am_i
   ------------
   jose
  </ProgramListing>
 </REFSECT1>
 
 <REFSECT1 ID="R1-SQL-CURRENT-USER-3">
  <TITLE>
   Compatibility
  </TITLE>
  <PARA>
  </PARA>
  
  <REFSECT2 ID="R2-SQL-CURRENT-USER-4">
   <REFSECT2INFO>
    <DATE>1998-04-15</DATE>
   </REFSECT2INFO>
   <TITLE>
    SQL92
   </TITLE>
   <PARA>
   SQL92 specifies some additional niladic USER functions:
   </PARA>
   <variablelist>
    <varlistentry>
     <term>CURRENT_USER / USER</term>
     <listitem>
      <para>  
       USER is a synonym for CURRENT_USER. 
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term>SESSION_USER</term>
     <listitem>
      <para>
       The SESSION_USER function returns the SQL-session user name.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term>SYSTEM_USER</term>
     <listitem>
      <para>
       The SYSTEM_USER function returns the database's initial default user.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
   <para>
    A niladic USER function returns a SQL_TEXT character string whose
    value represents a user name.
   </para>
  </refsect2>
 </refsect1>
</REFENTRY>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
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:
-->
