diff options
| author | Alvaro Herrera <alvherre@alvh.no-ip.org> | 2024-03-11 17:20:36 +0100 |
|---|---|---|
| committer | Alvaro Herrera <alvherre@alvh.no-ip.org> | 2024-03-11 17:20:36 +0100 |
| commit | 095493a3771a99d0e4c906ad1cc33791efaa7248 (patch) | |
| tree | de19161509dc75a01902132e82b56cd7b7a2fed9 /src | |
| parent | 648928c79bed975a89fa2e4ef8bc0bade8e0e0d8 (diff) | |
| download | postgresql-095493a3771a99d0e4c906ad1cc33791efaa7248.tar.gz postgresql-095493a3771a99d0e4c906ad1cc33791efaa7248.zip | |
Add missing connection statuses to docs
The list of connection statuses that PQstatus might return during an
asynchronous connection attempt was outdated:
1. CONNECTION_SETENV is never returned anymore and is only part of the
enum for backwards compatibility, so remove it from the docs.
2. CONNECTION_CHECK_STANDBY and CONNECTION_GSS_STARTUP were not listed,
so add them.
CONNECTION_NEEDED and CONNECTION_CHECK_TARGET are not listed in the docs
on purpose, since these are internal states that can never be observed
by a caller of PQstatus.
Author: Jelte Fennema-Nio <postgres@jeltef.nl>
Discussion: https://postgr.es/m/CAGECzQRb21spiiykQ48rzz8w+Hcykz+mB2_hxR65D9Qk6nnw=w@mail.gmail.com
Diffstat (limited to 'src')
| -rw-r--r-- | src/interfaces/libpq/libpq-fe.h | 5 |
1 files changed, 3 insertions, 2 deletions
diff --git a/src/interfaces/libpq/libpq-fe.h b/src/interfaces/libpq/libpq-fe.h index defc415fa3f..2c06044a75e 100644 --- a/src/interfaces/libpq/libpq-fe.h +++ b/src/interfaces/libpq/libpq-fe.h @@ -73,11 +73,12 @@ typedef enum * backend startup. */ CONNECTION_SETENV, /* This state is no longer used. */ CONNECTION_SSL_STARTUP, /* Negotiating SSL. */ - CONNECTION_NEEDED, /* Internal state: connect() needed */ + CONNECTION_NEEDED, /* Internal state: connect() needed. */ CONNECTION_CHECK_WRITABLE, /* Checking if session is read-write. */ CONNECTION_CONSUME, /* Consuming any extra messages. */ CONNECTION_GSS_STARTUP, /* Negotiating GSSAPI. */ - CONNECTION_CHECK_TARGET, /* Checking target server properties. */ + CONNECTION_CHECK_TARGET, /* Internal state: checking target server + * properties. */ CONNECTION_CHECK_STANDBY /* Checking if server is in standby mode. */ } ConnStatusType; |