The normal operation of our servers is to have tcpip_sockets enabled,

but occasionally I may need to shut down the server and restart it
w/o tcpip sockets. Postmaster has the -i option to turn on tcpip
connections, but it wasn't immediately clear how to easily or
temporarily turn it off (when it's been enabled in postgresql.conf).

In fact, it wasn't clear to me until digging in to postmaster.c that
I could pass '-c tcpip_socket=false' or '--tcpip_socket=false'.
(And then of course when I looked more closely at the man page I
realized I'd missed the proper part of the documentation.) What I'd
been looking for is a flag that would have the opposite effect of
'-i', and it's conceivable that others will be looking for specific
flags to do the opposite of '-F' and '-S'.

I was preparing to add options to postmaster until I realized that
maybe the solution is just to add some documentation.

If you'd rather have 1 character options to accomplish this, I'd be
happy to do that-- adding those 9 lines of code is definitely within
my ability. :)  (Although, the "right" letter to be the opposite of -S
isn't clear to me, since -s is already taken.)

Ron Snyder.
This commit is contained in:
Bruce Momjian 2002-06-15 19:52:56 +00:00
parent dbbd13bdb5
commit 7882179994

View file

@ -1,5 +1,5 @@
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.29 2002/04/21 19:02:39 thomas Exp $
$Header: /cvsroot/pgsql/doc/src/sgml/ref/postmaster.sgml,v 1.30 2002/06/15 19:52:56 momjian Exp $
PostgreSQL documentation
-->
@ -145,7 +145,13 @@ PostgreSQL documentation
<para>
Disables <function>fsync</function> calls for performance
improvement, at the risk of data corruption in event of a
system crash. Read the detailed documentation before using this!
system crash. This parameter corresponds to setting
fsync=false in postgresql.conf. Read the detailed
documentation before using this!
</para>
<para>
<option>--fsync=true</option> has the opposite effect
of this option.
</para>
</listitem>
</varlistentry>
@ -169,7 +175,12 @@ PostgreSQL documentation
<para>
Allows clients to connect via TCP/IP (Internet domain)
connections. Without this option, only local Unix domain
socket connections are accepted.
socket connections are accepted. This option corresponds
to setting tcpip_socket=true in postgresql.conf.
</para>
<para>
<option>--tcpip_socket=false</option> has the opposite
effect of this option.
</para>
</listitem>
</varlistentry>
@ -260,6 +271,10 @@ PostgreSQL documentation
to troubleshoot problems. See below for a better way to start
the <application>postmaster</application> in the background.
</para>
<para>
<option>--silent_mode=false</option> has the opposite effect
of this option.
</para>
</listitem>
</varlistentry>