From 01c4edad38a631f0b11cb7874d084d227e6327df Mon Sep 17 00:00:00 2001 From: Bruce Momjian Date: Mon, 13 Nov 2000 23:57:20 +0000 Subject: [PATCH] Add mention of hostname leading slash handling to all manual pages that use -h. --- doc/src/sgml/ref/createdb.sgml | 3 ++- doc/src/sgml/ref/createlang.sgml | 3 ++- doc/src/sgml/ref/createuser.sgml | 3 ++- doc/src/sgml/ref/dropdb.sgml | 3 ++- doc/src/sgml/ref/droplang.sgml | 3 ++- doc/src/sgml/ref/dropuser.sgml | 3 ++- doc/src/sgml/ref/pg_dump.sgml | 4 ++-- doc/src/sgml/ref/pg_dumpall.sgml | 4 ++-- doc/src/sgml/ref/pg_restore.sgml | 4 ++-- doc/src/sgml/ref/postmaster.sgml | 11 +++++------ doc/src/sgml/ref/psql-ref.sgml | 4 ++-- doc/src/sgml/ref/vacuumdb.sgml | 3 ++- 12 files changed, 27 insertions(+), 21 deletions(-) diff --git a/doc/src/sgml/ref/createdb.sgml b/doc/src/sgml/ref/createdb.sgml index dc0544bc85..ac4561810b 100644 --- a/doc/src/sgml/ref/createdb.sgml +++ b/doc/src/sgml/ref/createdb.sgml @@ -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 42cdfad5de..7c4bc2f5e3 100644 --- a/doc/src/sgml/ref/createlang.sgml +++ b/doc/src/sgml/ref/createlang.sgml @@ -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 0dd0e466fd..f6ed6469c4 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -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 7924104061..3df5779228 100644 --- a/doc/src/sgml/ref/dropdb.sgml +++ b/doc/src/sgml/ref/dropdb.sgml @@ -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 406d0b08a5..1b63c979cf 100644 --- a/doc/src/sgml/ref/droplang.sgml +++ b/doc/src/sgml/ref/droplang.sgml @@ -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 de8a78e3e9..fe2883fd76 100644 --- a/doc/src/sgml/ref/dropuser.sgml +++ b/doc/src/sgml/ref/dropuser.sgml @@ -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 1a50c83380..e6c16a8056 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -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 b2905e7387..85d9272a38 100644 --- a/doc/src/sgml/ref/pg_dumpall.sgml +++ b/doc/src/sgml/ref/pg_dumpall.sgml @@ -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 300ca78d9c..cda4afe984 100644 --- a/doc/src/sgml/ref/postmaster.sgml +++ b/doc/src/sgml/ref/postmaster.sgml @@ -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 6563854785..4678bfc533 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -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 368a82f233..e41c46d7c3 100644 --- a/doc/src/sgml/ref/vacuumdb.sgml +++ b/doc/src/sgml/ref/vacuumdb.sgml @@ -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. -- 2.39.5