Add and install the pg_geqo.sample file

diff --git a/src/backend/Makefile b/src/backend/Makefile
index 97552283c397f91073296642883e24cf5a08c699..6317b8abc66000e8ba7f9d422c96d2b64b842e64 100644 (file)
--- a/src/backend/Makefile
+++ b/src/backend/Makefile
@@ -34,7 +34,7 @@
 #
 #
 # IDENTIFICATION
-#    $Header: /cvsroot/pgsql/src/backend/Makefile,v 1.18 1997/01/05 21:17:21 bryanh Exp $
+#    $Header: /cvsroot/pgsql/src/backend/Makefile,v 1.19 1997/02/19 13:09:29 scrappy Exp $
 #
 #-------------------------------------------------------------------------
 
@@ -181,7 +181,7 @@ endif
 
 install: $(LIBDIR) $(BINDIR) $(HEADERDIR) postgres $(EXP) fmgr.h\
          global1.bki.source local1_template1.bki.source \
-         libpq/pg_hba.conf.sample 
+         libpq/pg_hba.conf.sample optimizer/geqo/pg_geqo.sample
        
        $(INSTALL) $(INSTL_EXE_OPTS) postgres $(BINDIR)/postgres
 ifeq ($(MAKE_EXPORTS), true)
@@ -196,6 +196,8 @@ endif
          $(LIBDIR)/local1_template1.bki.source
        $(INSTALL) $(INSTLOPTS) libpq/pg_hba.conf.sample \
          $(LIBDIR)/pg_hba.conf.sample
+       $(INSTALL) $(INSTLOPTS) optimizer/geqo/pg_geqo.sample \
+         $(LIBDIR)/pg_geqo.sample
 
 $(BINDIR) $(LIBDIR) $(HEADERDIR): 
        mkdir $@

diff --git a/src/backend/optimizer/geqo/pg_geqo.sample b/src/backend/optimizer/geqo/pg_geqo.sample
new file mode 100644 (file)
index 0000000..12694e3
--- /dev/null
+++ b/src/backend/optimizer/geqo/pg_geqo.sample
@@ -0,0 +1,64 @@
+#*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=
+#                          pg_geqo                                  *
+#                          -------                                  =
+#                                                                   *
+#             Example Genetic Algorithm config file                 =
+#                     for the PostgreSQL                            *
+#            Genetic Query Optimization (GEQO) module               =
+#                                                                   *
+#*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=
+# Martin Utesch                      * Institute of Automatic Control      *
+#                             = University of Mining and Technology =
+# utesch@aut.tu-freiberg.de   * Freiberg, Germany                   *
+#*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=*=
+
+# this file should be '$PGDATA/pg_geqo', but it doesn't have
+# to exist
+
+# comment character is '#'
+#
+# separator between recognized tag and possible value
+# must be white space
+
+# qs: means query size, which is the number of relations
+#     contained in a query
+
+#=================+===================+=============================+
+# RECOGNIZED TAGS |  POSSIBLE VALUES  |          DEFAULTS           |
+#=================+===================+=============================+
+# 'Pool_Size'     | positive int      | 2^(qs+1)                    |
+#-----------------+-------------------+-----------------------------+
+# 'Effort'        | [low,medium,high] | medium                      |
+#-----------------+-------------------+-----------------------------+
+# 'Generations'   | positive int      | 'Effort' * log2('Pool_Size')|
+#-----------------+-------------------+-----------------------------+
+# 'Selection_Bias'| [1.50; 2.00]      | 2.0                         |
+#-----------------+-------------------+-----------------------------+
+# 'Random_Seed'   | positive long     | time(NULL)                  |
+#=================+===================+=============================+
+
+# 'Pool_Size' is essential for the genetic algorithm performance.
+# It gives us the number of individuals within one population.
+#
+# 'Effort' 'low' means integer value of 1, 'medium' 40, and 'high' 80.
+#
+# 'Generations' gives us the stopping criterion for the number
+# of iterations within the genetic algorithm.
+#
+# 'Selection_Bias' gives us the selective pressure within the
+# population.
+#
+# 'Random_Seed' is the random seed for the random() function.
+# You don't have to set it.
+
+# All parameters will be computed within the GEQO module when they
+# are not set in the pg_geqo file.
+
+
+# Example pg_geqo settings:
+#
+#Pool_Size            128
+#Effort               low
+#Generations          200
+#Random_Seed          830518260
+#Selection_Bias       1.750000