Commit 76920de8 authored by Peter Eisentraut's avatar Peter Eisentraut

Rename parameter "hostname" to "virtual_host". Seemed very ambiguous...

parent 85b762b4
<!-- <!--
$Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.36 2000/11/14 19:13:26 petere Exp $ $Header: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v 1.37 2000/11/15 18:36:03 petere Exp $
--> -->
<Chapter Id="runtime"> <Chapter Id="runtime">
...@@ -932,33 +932,6 @@ env PGOPTIONS='-c geqo=off' psql ...@@ -932,33 +932,6 @@ env PGOPTIONS='-c geqo=off' psql
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term>HOSTNAME (<type>string</type>)</term>
<listitem>
<para>
Specifies the TCP/IP hostname or address on which the
<application>postmaster</application> is to listen for
connections from client applications. Defaults to the value
of the <envar>PGHOST</envar> environment variable, or if
<envar>PGHOST</envar> is not set, it defaults to listening on
all configured addresses (including localhost).
</para>
<para>
If you use a hostname do not try to run multiple instances of
<application>postmaster</application> 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, all of the host's IP addresses on which
<application>postmaster</application> instances are listening
must be distinct in the two last octets.
</para>
<para>
If you do not use this option, then each instance must listen
on a different port.
</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term>KRB_SERVER_KEYFILE (<type>string</type>)</term> <term>KRB_SERVER_KEYFILE (<type>string</type>)</term>
<listitem> <listitem>
...@@ -1151,6 +1124,33 @@ env PGOPTIONS='-c geqo=off' psql ...@@ -1151,6 +1124,33 @@ env PGOPTIONS='-c geqo=off' psql
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term>VIRTUAL_HOST (<type>string</type>)</term>
<listitem>
<para>
Specifies the TCP/IP hostname or address on which the
<application>postmaster</application> is to listen for
connections from client applications. Defaults to the value
of the <envar>PGHOST</envar> environment variable, or if
<envar>PGHOST</envar> is not set, it defaults to listening on
all configured addresses (including localhost).
</para>
<para>
If you use a hostname do not try to run multiple instances of
<application>postmaster</application> 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, all of the host's IP addresses on which
<application>postmaster</application> instances are listening
must be distinct in the two last octets.
</para>
<para>
If you do not use this option, then each instance must listen
on a different port.
</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>
</para> </para>
</sect2> </sect2>
...@@ -1189,6 +1189,11 @@ env PGOPTIONS='-c geqo=off' psql ...@@ -1189,6 +1189,11 @@ env PGOPTIONS='-c geqo=off' psql
<entry>fsync = off</entry> <entry>fsync = off</entry>
<entry></entry> <entry></entry>
</row> </row>
<row>
<entry>-h <replaceable>x</replaceable></entry>
<entry>virtual_host = <replaceable>x</replaceable></entry>
<entry></entry>
</row>
<row> <row>
<entry>-i</entry> <entry>-i</entry>
<entry>tcpip_socket = on</entry> <entry>tcpip_socket = on</entry>
......
...@@ -11,7 +11,7 @@ ...@@ -11,7 +11,7 @@
* *
* *
* IDENTIFICATION * IDENTIFICATION
* $Header: /cvsroot/pgsql/src/backend/postmaster/postmaster.c,v 1.187 2000/11/14 18:37:42 tgl Exp $ * $Header: /cvsroot/pgsql/src/backend/postmaster/postmaster.c,v 1.188 2000/11/15 18:36:04 petere Exp $
* *
* NOTES * NOTES
* *
...@@ -115,7 +115,7 @@ static Dllist *PortList; ...@@ -115,7 +115,7 @@ static Dllist *PortList;
/* The socket number we are listening for connections on */ /* The socket number we are listening for connections on */
int PostPortNumber; int PostPortNumber;
char * UnixSocketName; char * UnixSocketName;
char * HostName; char * Virtual_host;
/* /*
* This is a sequence number that indicates how many times we've had to * This is a sequence number that indicates how many times we've had to
...@@ -453,7 +453,7 @@ PostmasterMain(int argc, char *argv[]) ...@@ -453,7 +453,7 @@ PostmasterMain(int argc, char *argv[])
enableFsync = false; enableFsync = false;
break; break;
case 'h': case 'h':
HostName = optarg; Virtual_host = optarg;
break; break;
case 'i': case 'i':
NetServer = true; NetServer = true;
...@@ -609,7 +609,7 @@ PostmasterMain(int argc, char *argv[]) ...@@ -609,7 +609,7 @@ PostmasterMain(int argc, char *argv[])
if (NetServer) if (NetServer)
{ {
status = StreamServerPort(AF_INET, HostName, status = StreamServerPort(AF_INET, Virtual_host,
(unsigned short) PostPortNumber, UnixSocketName, (unsigned short) PostPortNumber, UnixSocketName,
&ServerSock_INET); &ServerSock_INET);
if (status != STATUS_OK) if (status != STATUS_OK)
...@@ -621,7 +621,7 @@ PostmasterMain(int argc, char *argv[]) ...@@ -621,7 +621,7 @@ PostmasterMain(int argc, char *argv[])
} }
#ifdef HAVE_UNIX_SOCKETS #ifdef HAVE_UNIX_SOCKETS
status = StreamServerPort(AF_UNIX, HostName, status = StreamServerPort(AF_UNIX, Virtual_host,
(unsigned short) PostPortNumber, UnixSocketName, (unsigned short) PostPortNumber, UnixSocketName,
&ServerSock_UNIX); &ServerSock_UNIX);
if (status != STATUS_OK) if (status != STATUS_OK)
...@@ -794,7 +794,7 @@ usage(const char *progname) ...@@ -794,7 +794,7 @@ usage(const char *progname)
printf(" -d 1-5 debugging level\n"); printf(" -d 1-5 debugging level\n");
printf(" -D DATADIR database directory\n"); printf(" -D DATADIR database directory\n");
printf(" -F turn fsync off\n"); printf(" -F turn fsync off\n");
printf(" -h HOSTNAME host name or IP address to listen to\n"); printf(" -h HOSTNAME host name or IP address to listen on\n");
printf(" -i enable TCP/IP connections\n"); printf(" -i enable TCP/IP connections\n");
printf(" -k FILENAME Unix domain socket location\n"); printf(" -k FILENAME Unix domain socket location\n");
#ifdef USE_SSL #ifdef USE_SSL
...@@ -1311,7 +1311,7 @@ ConnFree(Port *conn) ...@@ -1311,7 +1311,7 @@ ConnFree(Port *conn)
/* /*
* get_host_port -- return a pseudo port number (16 bits) * get_host_port -- return a pseudo port number (16 bits)
* derived from the primary IP address of HostName. * derived from the primary IP address of Virtual_host.
*/ */
static unsigned short static unsigned short
get_host_port(void) get_host_port(void)
...@@ -1323,13 +1323,13 @@ get_host_port(void) ...@@ -1323,13 +1323,13 @@ get_host_port(void)
SockAddr saddr; SockAddr saddr;
struct hostent *hp; struct hostent *hp;
hp = gethostbyname(HostName); hp = gethostbyname(Virtual_host);
if ((hp == NULL) || (hp->h_addrtype != AF_INET)) if ((hp == NULL) || (hp->h_addrtype != AF_INET))
{ {
char msg[1024]; char msg[1024];
snprintf(msg, sizeof(msg), snprintf(msg, sizeof(msg),
"FATAL: get_host_port: gethostbyname(%s) failed\n", "FATAL: get_host_port: gethostbyname(%s) failed\n",
HostName); Virtual_host);
fputs(msg, stderr); fputs(msg, stderr);
pqdebug("%s", msg); pqdebug("%s", msg);
exit(1); exit(1);
...@@ -1362,7 +1362,7 @@ reset_shared(unsigned short port) ...@@ -1362,7 +1362,7 @@ reset_shared(unsigned short port)
* the -h option, or set PGHOST, to a value other than the internal * the -h option, or set PGHOST, to a value other than the internal
* default. * default.
* *
* If HostName is set, then we generate the IPC keys using the * If Virtual_host is set, then we generate the IPC keys using the
* last two octets of the IP address instead of the port number. * last two octets of the IP address instead of the port number.
* This algorithm assumes that no one will run multiple PostgreSQL * This algorithm assumes that no one will run multiple PostgreSQL
* instances on one host using two IP addresses that have the same two * instances on one host using two IP addresses that have the same two
...@@ -1376,7 +1376,7 @@ reset_shared(unsigned short port) ...@@ -1376,7 +1376,7 @@ reset_shared(unsigned short port)
* host. * host.
*/ */
if (HostName[0] != '\0') if (Virtual_host[0] != '\0')
port = get_host_port(); port = get_host_port();
ipc_key = port * 1000 + shmem_seq * 100; ipc_key = port * 1000 + shmem_seq * 100;
......
...@@ -4,7 +4,7 @@ ...@@ -4,7 +4,7 @@
* Support for grand unified configuration scheme, including SET * Support for grand unified configuration scheme, including SET
* command, configuration file, and command line options. * command, configuration file, and command line options.
* *
* $Header: /cvsroot/pgsql/src/backend/utils/misc/guc.c,v 1.20 2000/11/14 19:13:27 petere Exp $ * $Header: /cvsroot/pgsql/src/backend/utils/misc/guc.c,v 1.21 2000/11/15 18:36:05 petere Exp $
* *
* Copyright 2000 by PostgreSQL Global Development Group * Copyright 2000 by PostgreSQL Global Development Group
* Written by Peter Eisentraut <peter_e@gmx.net>. * Written by Peter Eisentraut <peter_e@gmx.net>.
...@@ -319,7 +319,7 @@ ConfigureNamesString[] = ...@@ -319,7 +319,7 @@ ConfigureNamesString[] =
{"unixsocket", PGC_POSTMASTER, &UnixSocketName, {"unixsocket", PGC_POSTMASTER, &UnixSocketName,
"", NULL}, "", NULL},
{"hostname", PGC_POSTMASTER, &HostName, {"virtual_host", PGC_POSTMASTER, &Virtual_host,
"", NULL}, "", NULL},
{NULL, 0, NULL, NULL, NULL} {NULL, 0, NULL, NULL, NULL}
......
...@@ -9,7 +9,7 @@ ...@@ -9,7 +9,7 @@
* Portions Copyright (c) 1996-2000, PostgreSQL, Inc * Portions Copyright (c) 1996-2000, PostgreSQL, Inc
* Portions Copyright (c) 1994, Regents of the University of California * Portions Copyright (c) 1994, Regents of the University of California
* *
* $Id: pqcomm.h,v 1.44 2000/11/13 15:18:14 momjian Exp $ * $Id: pqcomm.h,v 1.45 2000/11/15 18:36:06 petere Exp $
* *
*------------------------------------------------------------------------- *-------------------------------------------------------------------------
*/ */
...@@ -180,6 +180,6 @@ extern int Unix_socket_permissions; ...@@ -180,6 +180,6 @@ extern int Unix_socket_permissions;
extern char * Unix_socket_group; extern char * Unix_socket_group;
extern char * UnixSocketName; extern char * UnixSocketName;
extern char * HostName; extern char * Virtual_host;
#endif /* PQCOMM_H */ #endif /* PQCOMM_H */
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment