]> granicus.if.org Git - pgbouncer/commitdiff
doc: Document reconnect behavior on reload and DNS change
authorPeter Eisentraut <peter@eisentraut.org>
Wed, 25 Jul 2018 07:33:37 +0000 (09:33 +0200)
committerPeter Eisentraut <peter@eisentraut.org>
Wed, 25 Jul 2018 07:33:37 +0000 (09:33 +0200)
This is long-standing behavior, just make the documentation about it
more explicit.

doc/config.rst
doc/usage.rst

index 9f898df4dc06622f40dfd55d113ecafd36f56931..c6064db240370232967bb7004eb963df8c38b2b8 100644 (file)
@@ -848,7 +848,10 @@ host
 ----
 
 Host name or IP address to connect to.  Host names are resolved
-on connect time, the result is cached per ``dns_max_ttl`` parameter.
+at connect time, the result is cached per ``dns_max_ttl`` parameter.
+When a host name's resolution changes, existing server connections are
+automatically closed when they are released (according to the pooling
+mode), and new server connections immediately use the new resolution.
 If DNS returns several results, they are used in round-robin
 manner.
 
index b2018422e9d836c5d3c5f8a98d6d1a486c421a4d..a41197f9edda57f965f03b5e7ba667ff1fd8944c 100644 (file)
@@ -613,6 +613,13 @@ RELOAD;
 The PgBouncer process will reload its configuration file and update
 changeable settings.
 
+PgBouncer notices when a configuration file reload changes the
+connection parameters of a database definition.  An existing server
+connection to the old destination will be closed when the server
+connection is next released (according to the pooling mode), and new
+server connections will immediately use the updated connection
+parameters.
+
 Other commands
 ~~~~~~~~~~~~~~