Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 75f46ea

Browse files
committed
libpq docs: be clearer about conninfo's 'hostaddr'
The previous wording was a bit too terse, too vague on the subject of 'host' and 'hostaddr' in connection specifications, which has caused people to waste time trying to conform to rules because of misunderstanding the whole thing; this small change should make things clearer. Author: Robert Haas, stemming from Fabien Coelho's complaints Discussion: https://postgr.es/m/alpine.DEB.2.21.1808201323020.13832@lancre
1 parent 8a0deae commit 75f46ea

File tree

1 file changed

+5
-1
lines changed

1 file changed

+5
-1
lines changed

doc/src/sgml/libpq.sgml

+5-1
Original file line numberDiff line numberDiff line change
@@ -993,10 +993,14 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
993993
your machine supports IPv6, you can also use those addresses.
994994
TCP/IP communication is
995995
always used when a nonempty string is specified for this parameter.
996+
If this parameter is not specified, the value of <literal>host</literal>
997+
will be looked up to find the corresponding IP address &mdash; or, if
998+
<literal>host</literal> specifies an IP address, that value will be
999+
used directly.
9961000
</para>
9971001

9981002
<para>
999-
Using <literal>hostaddr</literal> instead of <literal>host</literal> allows the
1003+
Using <literal>hostaddr</literal> allows the
10001004
application to avoid a host name look-up, which might be important
10011005
in applications with time constraints. However, a host name is
10021006
required for GSSAPI or SSPI authentication

0 commit comments

Comments
 (0)