diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml index 5bcb543938..eb5292cdc4 100644 --- a/doc/src/sgml/ref/createdb.sgml +++ b/doc/src/sgml/ref/createdb.sgml @@ -1,5 +1,5 @@ @@ -40,7 +40,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/createlang.sgml b/doc/src/sgml/ref/createlang.sgml index 87d27442e9..3e8242481f 100644 --- a/doc/src/sgml/ref/createlang.sgml +++ b/doc/src/sgml/ref/createlang.sgml @@ -1,5 +1,5 @@ @@ -85,7 +85,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index 9c7a3a2624..2a735900a5 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -1,5 +1,5 @@ @@ -39,7 +39,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml index 1eb4c4f46f..ab57c8c883 100644 --- a/doc/src/sgml/ref/dropdb.sgml +++ b/doc/src/sgml/ref/dropdb.sgml @@ -1,5 +1,5 @@ @@ -39,7 +39,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/droplang.sgml b/doc/src/sgml/ref/droplang.sgml index 2346a0d32d..531d9859f7 100644 --- a/doc/src/sgml/ref/droplang.sgml +++ b/doc/src/sgml/ref/droplang.sgml @@ -1,5 +1,5 @@ @@ -85,7 +85,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml index 7f8f7899e5..7b2a2ee9d4 100644 --- a/doc/src/sgml/ref/dropuser.sgml +++ b/doc/src/sgml/ref/dropuser.sgml @@ -1,5 +1,5 @@ @@ -39,7 +39,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index 4406ea94f0..1e5c70006d 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -1,5 +1,5 @@ @@ -199,8 +199,8 @@ pg_dump [ -h host ] Specifies the hostname of the machine on which the postmaster - is running. Defaults to using a local Unix domain socket - rather than an IP connection. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/pg_dumpall.sgml b/doc/src/sgml/ref/pg_dumpall.sgml index f6999059d1..a75a0c5e1c 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -1,5 +1,5 @@ @@ -143,8 +143,8 @@ pg_dumpall [ -h host ] [ -p Specifies the hostname of the machine on which the postmaster - is running. Defaults to using a local Unix domain socket - rather than an IP connection.. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml index dd5f4a1bca..1af53a4738 100644 --- a/doc/src/sgml/ref/pg_restore.sgml +++ b/doc/src/sgml/ref/pg_restore.sgml @@ -307,8 +307,8 @@ pg_restore [ archive-file ] Specifies the hostname of the machine on which the postmaster - is running. Defaults to using a local Unix domain socket - rather than an IP connection. + is running. If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/postmaster.sgml b/doc/src/sgml/ref/postmaster.sgml index e8e34c739f..38f3f8e210 100644 --- a/doc/src/sgml/ref/postmaster.sgml +++ b/doc/src/sgml/ref/postmaster.sgml @@ -1,5 +1,5 @@ @@ -132,23 +132,22 @@ postmaster [ -B nBuffers ] [ -D postmaster is to listen for connections from frontend applications. Defaults to - the value of the - PGHOST + the value of the PGHOST environment variable, or if PGHOST - is not set, then defaults to "all", meaning listen on all configured addresses + is not set, it defaults to listening on all configured addresses (including localhost). - If you use a hostname or address other than "all", do not try to run + If you use a hostname do not try to run multiple instances of postmaster on the same IP address but different ports. Doing so will result in them attempting (incorrectly) to use the same shared memory segments. - Also, if you use a hostname other than "all", all of the host's IP addresses + Also, if you use a hostname, all of the host's IP addresses on which postmaster instances are listening must be distinct in the two last octets. - If you do use "all" (the default), then each instance must listen on a + If you don't use this option, each instance must listen on a different port (via -p or PGPORT). And, of course, do not try to use both approaches on one host. diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index 1780fcfcc8..69075391d6 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -1,5 +1,5 @@ @@ -1322,8 +1322,8 @@ Access permissions for database "test" Specifies the host name of the machine on which the postmaster is running. - Without this option, communication is performed using - local Unix domain sockets. + If host begins with a slash, it is used + as the path to a unix domain socket. diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml index 28151190a7..69e9888f56 100644 --- a/doc/src/sgml/ref/vacuumdb.sgml +++ b/doc/src/sgml/ref/vacuumdb.sgml @@ -1,5 +1,5 @@ @@ -119,7 +119,8 @@ Postgres documentation Specifies the hostname of the machine on which the postmaster - is running. + is running. If host begins with a slash, it is used + as the path to a unix domain socket.