.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PG_AUTOCTL SHOW STANDBY-NAMES" "1" "Nov 06, 2022" "2.0" "pg_auto_failover"
.SH NAME
pg_autoctl show standby-names \- pg_autoctl show standby-names
.sp
pg_autoctl show standby\-names \- Prints synchronous_standby_names for a given group
.SH SYNOPSIS
.sp
This command prints the current value for synchronous_standby_names for the
primary Postgres server of the target group (default \fB0\fP) in the target
formation (default \fBdefault\fP), as computed by the monitor:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
usage: pg_autoctl show standby\-names  [ \-\-pgdata ] \-\-formation \-\-group

  \-\-pgdata      path to data directory
  \-\-monitor     pg_auto_failover Monitor Postgres URL
  \-\-formation   formation to query, defaults to \(aqdefault\(aq
  \-\-group       group to query formation, defaults to all
  \-\-json        output data in the JSON format
.ft P
.fi
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-\-pgdata
Location of the Postgres node being managed locally. Defaults to the
environment variable \fBPGDATA\fP\&. Use \fB\-\-monitor\fP to connect to a monitor
from anywhere, rather than the monitor URI used by a local Postgres node
managed with \fBpg_autoctl\fP\&.
.TP
.B  \-\-monitor
Postgres URI used to connect to the monitor. Must use the \fBautoctl_node\fP
username and target the \fBpg_auto_failover\fP database name. It is possible
to show the Postgres URI from the monitor node using the command
\fI\%pg_autoctl show uri\fP\&.
.sp
Defaults to the value of the environment variable \fBPG_AUTOCTL_MONITOR\fP\&.
.TP
.B  \-\-formation
Show the current \fBsynchronous_standby_names\fP value for the given
formation. Defaults to the \fBdefault\fP formation.
.TP
.B  \-\-group
Show the current \fBsynchronous_standby_names\fP value for the given group
in the given formation. Defaults to group \fB0\fP\&.
.TP
.B  \-\-json
Output a JSON formatted data instead of a table formatted list.
.UNINDENT
.SH ENVIRONMENT
.sp
PGDATA
.INDENT 0.0
.INDENT 3.5
Postgres directory location. Can be used instead of the \fB\-\-pgdata\fP
option.
.UNINDENT
.UNINDENT
.sp
PG_AUTOCTL_MONITOR
.INDENT 0.0
.INDENT 3.5
Postgres URI to connect to the monitor node, can be used instead of the
\fB\-\-monitor\fP option.
.UNINDENT
.UNINDENT
.sp
XDG_CONFIG_HOME
.INDENT 0.0
.INDENT 3.5
The pg_autoctl command stores its configuration files in the standard
place XDG_CONFIG_HOME. See the \fI\%XDG Base Directory Specification\fP\&.
.UNINDENT
.UNINDENT
.sp
XDG_DATA_HOME
.INDENT 0.0
.INDENT 3.5
The pg_autoctl command stores its internal states files in the standard
place XDG_DATA_HOME, which defaults to \fB~/.local/share\fP\&. See the \fI\%XDG
Base Directory Specification\fP\&.
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ pg_autoctl show standby\-names
\(aqANY 1 (pgautofailover_standby_2, pgautofailover_standby_3)\(aq

$ pg_autoctl show standby\-names \-\-json
{
    "formation": "default",
    "group": 0,
    "synchronous_standby_names": "ANY 1 (pgautofailover_standby_2, pgautofailover_standby_3)"
}
.ft P
.fi
.UNINDENT
.UNINDENT
.SH AUTHOR
Microsoft
.SH COPYRIGHT
Copyright (c) Microsoft Corporation. All rights reserved.
.\" Generated by docutils manpage writer.
.