Re: Obsolete description in pg_ctl-ref.sgml - Mailing list pgsql-docs

From Fujii Masao
Subject Re: Obsolete description in pg_ctl-ref.sgml
Date
Msg-id AANLkTimTnqw8aBTZC5=zfQ8t=YM+S40TTru2BP4dKD1H@mail.gmail.com
Whole thread Raw
In response to Re: Obsolete description in pg_ctl-ref.sgml  (Robert Haas <robertmhaas@gmail.com>)
Responses Re: Obsolete description in pg_ctl-ref.sgml
List pgsql-docs
On Wed, Dec 15, 2010 at 6:35 AM, Robert Haas <robertmhaas@gmail.com> wrote:
>> At least the reference to section 31.14 is needless since password
>> authentication doesn't affect the pg_ctl -w for now. But, on the second
>> thought, it can still fail because of miss-configuration of connection
>> variable, for example PGHOST.
>
> I thought PQping() was supposed to handle that correctly.  There are
> four return values: PQPING_OK, PQPING_REJECT, PQPING_NO_RESPONSE,
> PQPING_NO_ATTEMPT.  I believe the last is intended to cover blatant
> misconfiguration.

True. But even though the server is running normally, the misconfiguration
might still make PQping return PQPING_NO_ATTEMPT and make pg_ctl -w
fail to wait for complete startup. Currently misconfiguration of password
authentication doesn't interfere with pg_ctl -w, so we can remove the
reference to that. But other misconfigurations can be still harm, so I thought
the sentence still needs to be in the document.

Regards,

--
Fujii Masao
NIPPON TELEGRAPH AND TELEPHONE CORPORATION
NTT Open Source Software Center

pgsql-docs by date:

Previous
From: Robert Haas
Date:
Subject: Re: Is timestamptz alias documented?
Next
From: Robert Haas
Date:
Subject: Re: Obsolete description in pg_ctl-ref.sgml