initlocation is history. (It's still mentioned in manage-ag.sgml,
authorTom Lane
Fri, 18 Jun 2004 21:24:06 +0000 (21:24 +0000)
committerTom Lane
Fri, 18 Jun 2004 21:24:06 +0000 (21:24 +0000)
but I'll leave that file alone so as not to mess up the doc patch
I trust Gavin is working on.)

doc/src/sgml/ref/allfiles.sgml
doc/src/sgml/ref/createdb.sgml
doc/src/sgml/ref/initlocation.sgml [deleted file]
doc/src/sgml/reference.sgml
src/bin/Makefile
src/bin/initlocation/Makefile [deleted file]
src/bin/initlocation/initlocation.sh [deleted file]

index 352a21c292dd88c4d80ed7157903100be9700597..f21410e7c13663c1dd8c61ce0eaba31bd0ac86c1 100644 (file)
@@ -1,5 +1,5 @@
 
@@ -111,7 +111,6 @@ Complete list of usable sgml source files in this directory.
 
 
 
-
 
 
 
index a6b2c8d383cfde4d0d0d1defa6e7d58ab067665e..1d04a61abf69a42591229e6ffe32eb867fabccd3 100644 (file)
@@ -1,5 +1,5 @@
 
 
@@ -90,8 +90,7 @@ PostgreSQL documentation
       
       
        
-   Specifies the alternative location for the database.  See also 
-   linkend="app-initlocation">.
+   Specifies the alternative location for the database.
        
       
      
diff --git a/doc/src/sgml/ref/initlocation.sgml b/doc/src/sgml/ref/initlocation.sgml
deleted file mode 100644 (file)
index 1ddda48..0000000
+++ /dev/null
@@ -1,89 +0,0 @@
-
-
-
-  initlocation
-  1
-  Application
-
-  initlocation
-  create a secondary PostgreSQL database storage area
-
-  initlocation
-
-  
-   initlocation
-   directory
-  
-
-  Description
-  
-   initlocation 
-   creates a new PostgreSQL secondary database storage area.
-   See the discussion under 
-   about how to manage and use secondary storage areas. If the argument does not contain
-   a slash and is not valid as a path, it is assumed to be an environment variable,
-   which is referenced. See the examples at the end.
-  
-  
-   In order to use this command you must be logged in (using su, for example)
-   as the database superuser.
-  
-
-  Examples
-
-   
-    To create a database in an alternate location, using an
-    environment variable:
-
-export PGDATA2=/opt/postgres/data
-
-    Stop and start postmaster so it sees the PGDATA2
-    environment variable.  The system must be configured so the
-    postmaster sees PGDATA2 every time it starts.  Finally:
-
-$ initlocation PGDATA2
-$ createdb -D PGDATA2 testdb
-
-   
-
-   
-    Alternatively, if you allow absolute paths you could write:
-
-$ initlocation /opt/postgres/data
-$ createdb -D /opt/postgres/data/testdb testdb
-
-   
-
-
-
-
index 100c69bde93be436d4799d993d9bf0547770322e..b5d42361ce76496c1066b7da09054b1e983ba93e 100644 (file)
@@ -1,5 +1,5 @@
 
@@ -180,7 +180,6 @@ PostgreSQL Reference Manual
   
 
    &initdb;
-   &initlocation;
    &ipcclean;
    &pgControldata;
    &pgCtl;
index ab7300c0939a949b0096bfc78e7d831b93344518..46e12216c4a05c807831a551389c3ee32af5bae0 100644 (file)
@@ -5,7 +5,7 @@
 # Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
 # Portions Copyright (c) 1994, Regents of the University of California
 #
-# $PostgreSQL: pgsql/src/bin/Makefile,v 1.43 2004/04/20 00:40:06 momjian Exp $
+# $PostgreSQL: pgsql/src/bin/Makefile,v 1.44 2004/06/18 21:24:05 tgl Exp $
 #
 #-------------------------------------------------------------------------
 
@@ -13,7 +13,7 @@ subdir = src/bin
 top_builddir = ../..
 include $(top_builddir)/src/Makefile.global
 
-DIRS := initdb initlocation ipcclean pg_ctl pg_dump \
+DIRS := initdb ipcclean pg_ctl pg_dump \
    psql scripts pg_config pg_controldata pg_resetxlog
 
 all install installdirs uninstall depend distprep:
diff --git a/src/bin/initlocation/Makefile b/src/bin/initlocation/Makefile
deleted file mode 100644 (file)
index 1ebf1ab..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-#-------------------------------------------------------------------------
-#
-# Makefile for src/bin/initlocation
-#
-# Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
-# Portions Copyright (c) 1994, Regents of the University of California
-#
-# $PostgreSQL: pgsql/src/bin/initlocation/Makefile,v 1.15 2003/11/29 19:52:04 pgsql Exp $
-#
-#-------------------------------------------------------------------------
-
-subdir = src/bin/initlocation
-top_builddir = ../../..
-include $(top_builddir)/src/Makefile.global
-
-all: initlocation
-
-initlocation: initlocation.sh
-   cp $< $@
-   chmod a+x $@
-
-install: all installdirs
-   $(INSTALL_SCRIPT) initlocation $(DESTDIR)$(bindir)/initlocation
-
-installdirs:
-   $(mkinstalldirs) $(DESTDIR)$(bindir)
-
-uninstall:
-   rm -f $(DESTDIR)$(bindir)/initlocation
-
-clean distclean maintainer-clean:
-   rm -f initlocation
diff --git a/src/bin/initlocation/initlocation.sh b/src/bin/initlocation/initlocation.sh
deleted file mode 100644 (file)
index 6ee584b..0000000
+++ /dev/null
@@ -1,171 +0,0 @@
-#!/bin/sh
-#-------------------------------------------------------------------------
-#
-# initlocation.sh--
-#     Create a secondary PostgreSQL database storage area.  
-# 
-# Portions Copyright (c) 1996-2002, PostgreSQL Global Development Group
-# Portions Copyright (c) 1994, Regents of the University of California
-#
-#
-# IDENTIFICATION
-#    $PostgreSQL: pgsql/src/bin/initlocation/initlocation.sh,v 1.17 2003/11/29 19:52:04 pgsql Exp $
-#
-#-------------------------------------------------------------------------
-
-exit_nicely(){
-    echo "$CMDNAME: failed" 1>&2
-    rm -rf "$PGALTDATA"
-    exit 1
-}
-
-
-CMDNAME=`basename $0`
-EffectiveUser=`id -n -u 2>/dev/null || whoami 2>/dev/null`
-
-if [ "$USER" = 'root' -o "$LOGNAME" = 'root' ]
-then
-    echo "$CMDNAME: cannot be run as root" 1>&2
-    echo "Please log in (using, e.g., \"su\") as the (unprivileged) user that will" 1>&2
-    echo "own the server process." 1>&2
-    exit 1
-fi
-
-Location=
-
-while [ "$#" -gt 0 ]
-do
-    case "$1" in
-        # These options are not really necessary, but what the heck.
-   --location=*)
-            Location=`echo $1 | sed 's/^--pgdata=//'`
-            ;;
-   --location)
-            Location="$2"
-            shift;;
-   -D)
-            Location="$2"
-            shift;;
-
-   --help|-\?)
-            usage=t
-            break;;
-
-   -*)
-            echo "$CMDNAME: invalid option: $1" 1>&2
-            echo "Try \"$CMDNAME --help\" for more information." 1>&2
-            exit 1
-            ;;
-   *)
-            Location="$1"
-            ;;
-   esac
-   shift
-done
-
-
-if [ "$usage" ]; then
-        echo "$CMDNAME initializes an alternative filesystem location for database"
-   echo "creation."
-   echo ""
-   echo "Usage:"
-        echo "  $CMDNAME LOCATION"
-   echo
-   echo "Please read the description of the CREATE DATABASE command for details."
-   echo
-        echo "Report bugs to ."
-   exit 0
-fi
-
-
-if [ -z "$Location" ]; then
-   echo "$CMDNAME: missing required argument LOCATION" 1>&2
-        echo "Try \"$CMDNAME --help\" for more information." 1>&2
-   exit 1
-fi
-
-
-#
-# Here's what's going on:
-#
-# You can call initlocation ENVAR (no dollar sign), then ENVAR will
-# (a) be tested whether it is valid as a path, or
-# (b) be resolved as an environment variable.
-# The latter has been the traditional behaviour.
-#
-# You can call initlocation $ENVAR, which will of course be resolved
-# by the shell, or initlocation some/path (containing at least one slash).
-# Then you just take that path.
-# This should appease users who are confused by the above behavour.
-#
-
-echo "$Location" | grep '/' >/dev/null 2>&1
-
-if [ "$?" -ne 0 -a ! -d "$Location" ]; then
-    PGALTDATA=`printenv $Location 2> /dev/null`
-    if [ -z "$PGALTDATA" ]; then
-        echo "$CMDNAME: environment variable $Location not set" 1>&2
-        exit 1
-    fi
-    haveenv=t
-else
-    PGALTDATA="$Location"
-    haveenv=f
-fi
-
-echo "The files belonging to this location will be owned by user \"$EffectiveUser\"."
-echo "This user must also own the server process."
-echo
-
-# -----------------------------------------------------------------------
-# Create the data directory if necessary
-# -----------------------------------------------------------------------
-
-# don't want to leave anything lying around
-trap 'echo "Caught signal." ; exit_nicely' 1 2 3 15
-
-# umask must disallow access to group, other for files and dirs
-umask 077
-
-if [ ! -d "$PGALTDATA" ]; then
-   echo "creating directory $PGALTDATA"
-   mkdir "$PGALTDATA"
-   if [ "$?" -ne 0 ]; then
-            echo "$CMDNAME: could not create directory \"$PGALTDATA\"" 1>&2
-            echo "Make sure \"$PGALTDATA\" is a valid path and that you have permission to access it." 1>&2
-            exit_nicely
-        fi
-else
-        echo "fixing permissions on pre-existing directory $PGALTDATA"
-   chmod go-rwx "$PGALTDATA" || exit_nicely
-fi
-
-
-if [ ! -d "$PGALTDATA"/base ]; then
-   echo "creating directory $PGALTDATA/base"
-   mkdir "$PGALTDATA/base"
-   if [ "$?" -ne 0 ]; then
-            echo "$CMDNAME: could not create $PGALTDATA/base" 1>&2
-            echo "Make sure \"$PGALTDATA/base\" is a valid path and that you have permission to access it." 1>&2
-            exit_nicely
-        fi
-else
-        echo "fixing permissions on pre-existing directory $PGALTDATA/base"
-   chmod go-rwx "$PGALTDATA/base" || exit_nicely
-fi
-
-echo
-echo "$CMDNAME is complete."
-# We can only suggest them these commands if they used the environment
-# variable notation. Otherwise they would be induced to use an absolute
-# path, which the backend won't allow by default.
-if [ "$haveenv" = "t" ]; then
-    echo "You can now create a database using"
-    echo "  CREATE DATABASE  WITH LOCATION = '$Location'"
-    echo "in SQL, or"
-    echo "  createdb -D '$Location' "
-    echo "from the shell."
-fi
-echo
-
-exit 0