Mention that -R requires unix_socket_dir in various places.

Requested by Hubert Depesz Lubaczewski.

diff --git a/doc/config.txt b/doc/config.txt
index 8e834cda19a34d6edcc80a3cd729df96d9710eda..95dcd6256425ac0266d2ce7f934284629ad1c033 100644 (file)
--- a/doc/config.txt
+++ b/doc/config.txt
@@ -57,6 +57,7 @@ Default: 6432
 
 Specifies location for Unix sockets. Applies to both listening socket and
 server connections. If set to an empty string, Unix sockets are disabled.
+Required for online reboot (-R) to work.
 Note: Not supported on Windows machines.
 
 Default: +/tmp+

diff --git a/doc/usage.txt b/doc/usage.txt
index 3798a95bd3aca9f6e76105af3f866d16c510e214..013210a11c00ec12e26078f1fcabec531589f46c 100644 (file)
--- a/doc/usage.txt
+++ b/doc/usage.txt
@@ -113,7 +113,8 @@ Basic setup and usage as following.
       Do an online restart. That means connecting to the running process, 
       loading the open sockets from it, and then using them.  If there 
       is no active process, boot normally.
-      Note: Does not work on Windows machines.
+      Note: Works only if OS supports Unix sockets and the `unix_socket_dir`
+      is not disabled in config.  Does not work on Windows machines.
 
 -u user::
       Switch to the given user on startup.

diff --git a/etc/pgbouncer.ini b/etc/pgbouncer.ini
index 62f3e44dcf5e9bd15b33178ae72eafca38043d57..cc53b8c66f6c719028da33d26b7fd69e84187c7a 100644 (file)
--- a/etc/pgbouncer.ini
+++ b/etc/pgbouncer.ini
@@ -37,6 +37,7 @@ pidfile = pgbouncer.pid
 ; ip address or * which means all ip-s
 listen_addr = 127.0.0.1
 listen_port = 6432
+; unix socket is also used for -R
 unix_socket_dir = /tmp
 
 ;;;