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.

diff --git a/doc/src/sgml/ref/postmaster.sgml b/doc/src/sgml/ref/postmaster.sgml
index 0c2149e63b21d2b3dcff5bf2946f1fea95a39e5a..0d2a7e93dd269f7ca5957a27c5cb93f690e855fd 100644 (file)
--- a/doc/src/sgml/ref/postmaster.sgml
+++ b/doc/src/sgml/ref/postmaster.sgml
@@ -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>