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