From: Marko Kreen <markokr@gmail.com>
Date: Fri, 25 Mar 2011 21:49:42 +0000 (+0200)
Subject: Mention that -R requires unix_socket_dir in various places.
X-Git-Tag: pgbouncer_1_4_1_rc4~5
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=51dad28504ac87198d189da0a3dda0b09658615a;p=pgbouncer

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 8e834cd..95dcd62 100644
--- 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 3798a95..013210a 100644
--- 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 62f3e44..cc53b8c 100644
--- 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
 
 ;;;