I386LINUX/util/I386LINUX/man/man7/show.7

   1 .\\" auto-generated by docbook2man-spec $Revision: 1.25 $
   2 .TH "SHOW" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
   3 .SH NAME
   4 SHOW \- show the value of a run-time parameter
   5
   6 .SH SYNOPSIS
   7 .sp
   8 .nf
   9 SHOW \fIname\fR
  10 SHOW ALL
  11 .sp
  12 .fi
  13 .SH "DESCRIPTION"
  14 .PP
  15 \fBSHOW\fR will display the current setting of
  16 run-time parameters. These variables can be set using the
  17 \fBSET\fR statement, by editing the
  18 \fIpostgresql.conf\fR configuration file, through
  19 the \fBPGOPTIONS\fR environmental variable (when using
  20 \fBlibpq\fR or a \fBlibpq\fR-based
  21 application), or through command-line flags when starting the
  22 \fBpostmaster\fR. See the section called ``Run-time Configuration'' in the documentation for details.
  23 .SH "PARAMETERS"
  24 .TP
  25 \fB\fIname\fB\fR
  26 The name of a run-time parameter. Available parameters are
  27 documented in the section called ``Run-time Configuration'' in the documentation and on the SET [\fBset\fR(7)] reference page. In
  28 addition, there are a few parameters that can be shown but not
  29 set:
  30 .RS
  31 .TP
  32 \fBSERVER_VERSION\fR
  33 Shows the server's version number.
  34 .TP
  35 \fBSERVER_ENCODING\fR
  36 Shows the server-side character set encoding. At present,
  37 this parameter can be shown but not set, because the
  38 encoding is determined at database creation time.
  39 .TP
  40 \fBLC_COLLATE\fR
  41 Shows the database's locale setting for collation (text
  42 ordering). At present, this parameter can be shown but not
  43 set, because the setting is determined at
  44 \fBinitdb\fR time.
  45 .TP
  46 \fBLC_CTYPE\fR
  47 Shows the database's locale setting for character
  48 classification. At present, this parameter can be shown but
  49 not set, because the setting is determined at
  50 \fBinitdb\fR time.
  51 .TP
  52 \fBIS_SUPERUSER\fR
  53 True if the current session authorization identifier has
  54 superuser privileges.
  55 .RE
  56 .PP
  57 .TP
  58 \fBALL\fR
  59 Show the values of all configurations parameters.
  60 .SH "NOTES"
  61 .PP
  62 The function \fBcurrent_setting\fR produces
  63 equivalent output. See the section called ``Miscellaneous Functions'' in the documentation.
  64 .SH "EXAMPLES"
  65 .PP
  66 Show the current setting of the parameter DateStyle:
  67 .sp
  68 .nf
  69 SHOW DateStyle;
  70  DateStyle
  71 -----------
  72  ISO, MDY
  73 (1 row)
  74 .sp
  75 .fi
  76 .PP
  77 Show the current setting of the parameter geqo:
  78 .sp
  79 .nf
  80 SHOW geqo;
  81  geqo
  82 ------
  83  on
  84 (1 row)
  85 .sp
  86 .fi
  87 .PP
  88 Show all settings:
  89 .sp
  90 .nf
  91 SHOW ALL;
  92              name              |                setting
  93 -------------------------------+---------------------------------------
  94  australian_timezones          | off
  95  authentication_timeout        | 60
  96  checkpoint_segments           | 3
  97     .
  98     .
  99     .
 100  wal_debug                     | 0
 101  wal_sync_method               | fdatasync
 102 (94 rows)
 103 .sp
 104 .fi
 105 .SH "COMPATIBILITY"
 106 .PP
 107 The \fBSHOW\fR command is a
 108 PostgreSQL extension.
 109 .SH "SEE ALSO"
 110 SET [\fBset\fR(7)]
 111