diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 2de21903a1..243d019868 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -751,6 +751,8 @@ include_dir 'conf.d'
only TCP/IP sockets can be used to connect to the server.
The default value is normally
/tmp, but that can be changed at build time.
+ On Windows, the default is empty, which means no Unix-domain socket is
+ created by default.
This parameter can only be set at server start.
@@ -762,11 +764,6 @@ include_dir 'conf.d'
created in each of the unix_socket_directories directories.
Neither file should ever be removed manually.
-
-
- This parameter is irrelevant on Windows, which does not have
- Unix-domain sockets.
-
@@ -789,8 +786,8 @@ include_dir 'conf.d'
- This parameter is irrelevant on Windows, which does not have
- Unix-domain sockets.
+ This parameter is not supported on Windows. Any setting will be
+ ignored.
@@ -836,8 +833,6 @@ include_dir 'conf.d'
10, that ignore socket permissions entirely. There, one can achieve a
similar effect by pointing unix_socket_directories to a
directory having search permission limited to the desired audience.
- This parameter is also irrelevant on Windows, which does not have
- Unix-domain sockets.
diff --git a/doc/src/sgml/libpq.sgml b/doc/src/sgml/libpq.sgml
index 9a24c19ccb..c2b3cdabad 100644
--- a/doc/src/sgml/libpq.sgml
+++ b/doc/src/sgml/libpq.sgml
@@ -959,8 +959,9 @@ postgresql://[2001:db8::1234]/database
The host component is interpreted as described for the parameter . In particular, a Unix-domain socket
- connection is chosen if the host part is either empty or starts with a
- slash, otherwise a TCP/IP connection is initiated. Note, however, that the
+ connection is chosen if the host part is either empty or looks like an
+ absolute path name,
+ otherwise a TCP/IP connection is initiated. Note, however, that the
slash is a reserved character in the hierarchical part of the URI. So, to
specify a non-standard Unix-domain socket directory, either omit the host
specification in the URI and specify the host as a parameter, or
@@ -1035,16 +1036,19 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
host
- Name of host to connect to.host name
- If a host name begins with a slash, it specifies Unix-domain
- communication rather than TCP/IP communication; the value is the
- name of the directory in which the socket file is stored.
- The default behavior when host is
- not specified, or is empty, is to connect to a Unix-domain
+ Name of host to connect to.host
+ name If a host name looks like an absolute path
+ name, it specifies Unix-domain communication rather than TCP/IP
+ communication; the value is the name of the directory in which the
+ socket file is stored. (On Unix, an absolute path name begins with a
+ slash. On Windows, paths starting with drive letters are also
+ recognized.) The default behavior when host is not
+ specified, or is empty, is to connect to a Unix-domain
socketUnix domain socket in
/tmp (or whatever socket directory was specified
- when PostgreSQL was built). On machines without
- Unix-domain sockets, the default is to connect to localhost.
+ when PostgreSQL was built). On Windows and
+ on machines without Unix-domain sockets, the default is to connect to
+ localhost.
A comma-separated list of host names is also accepted, in which case
@@ -1123,8 +1127,8 @@ postgresql://%2Fvar%2Flib%2Fpostgresql/dbname
Without either a host name or host address,
- libpq will connect using a
- local Unix-domain socket; or on machines without Unix-domain
+ libpq will connect using a local
+ Unix-domain socket; or on Windows and on machines without Unix-domain
sockets, it will attempt to connect to localhost.
diff --git a/doc/src/sgml/ref/pgupgrade.sgml b/doc/src/sgml/ref/pgupgrade.sgml
index 49de1d57ab..997ef1e12a 100644
--- a/doc/src/sgml/ref/pgupgrade.sgml
+++ b/doc/src/sgml/ref/pgupgrade.sgml
@@ -751,7 +751,7 @@ psql --username=postgres --file=script.sql postgres
can use the option to put the socket files in some
directory with a shorter path name. For security, be sure that that
directory is not readable or writable by any other users.
- (This is not relevant on Windows.)
+ (This is not supported on Windows.)
diff --git a/doc/src/sgml/storage.sgml b/doc/src/sgml/storage.sgml
index 1c19e863d2..3234adb639 100644
--- a/doc/src/sgml/storage.sgml
+++ b/doc/src/sgml/storage.sgml
@@ -169,7 +169,7 @@ last started with
cluster data directory path,
postmaster start timestamp,
port number,
- Unix-domain socket directory path (empty on Windows),
+ Unix-domain socket directory path (could be empty),
first valid listen_address (IP address or *, or empty if
not listening on TCP),
and shared memory segment ID