Return to READ_ME CVS log

Up to [CSRG BSD Unix] / 43BSD / ingres / source

Annotation of 43BSD/ingres/source/READ_ME, revision 1.1.1.1

1.1       root        1: The source code for the INGRES system lives in this directory.
                      2: 
                      3: RECOMPILATION
                      4: 
                      5: To recompile the system, do:
                      6: 
                      7:        su ingres
                      8:        cd conf; make allclean allinstall
                      9: 
                     10: This will clean out all objects from everywhere and then recompile
                     11: and install the entire system.  This can be expected to take about
                     12: 1.5 hours. Note that all files and dirs should be owned by user
                     13: "ingres" and group "ingres".
                     14: 
                     15: ROAD MAP
                     16: 
                     17: conf
                     18:        Configuration files for the system.  This is the "main"
                     19:        directory -- the Makefile in this directory applies to
                     20:        the entire system, rather than just the particular module.
                     21: ctlmod
                     22:        The control module.  This module provides interprocess
                     23:        communication and provides certain system functions.  It
                     24:        might be considered the "kernel" of the system.
                     25: dbu
                     26:        Database utilities.  These are things like print, help,
                     27:        copy, ksort, etc.
                     28: decomp
                     29:        Decomposition.  This module does query optimization.
                     30: equel
                     31:        The EQUEL preprocessor.
                     32: gutil
                     33:        General utilities.  These are not particular to INGRES,
                     34:        although they were written for INGRES.
                     35: h
                     36:        Header files.
                     37: iutil
                     38:        INGRES utilities.  This includes the old "access" library.
                     39:        This directory has the access methods and utility routines
                     40:        that are used throughout INGRES, but have no meaning outside
                     41:        of the INGRES context.
                     42: libq
                     43:        The EQUEL runtime support.
                     44: monitor
                     45:        The terminal monitor (front end).
                     46: ovqp
                     47:        One Variable Query Processor.  This is the "search engine"
                     48:        (basically a big interpreter).
                     49: parser
                     50:        The parser.  Takes text and produces query trees.
                     51: qrymod
                     52:        Query Modification.  This module supports views, integrity,
                     53:        and protection.
                     54: support
                     55:        All programs that are to be run from the shell are in this
                     56:        directory.
                     57: 
                     58: Note for SUN users:
                     59:        This release will compile on the SUN workstation but it is
                     60: untested and known to have problems with equel programs.  To compile
                     61: for the SUN add 'CPUTYPE=SUN' to the make command or change
                     62: conf/Makefile.
                     63: 
                     64: Known bugs:
                     65:        There is only one known bug with this version of INGRES on
                     66: VAXs running 4.3 BSD UNIX.  The bug is as follows:
                     67: The quel statement
                     68: retrieve (a.foo) where count(a.bar by a.foo)=max(count(a.bar by a.foo))
                     69: will work but
                     70: retrieve (a.foo) where max(count(a.bar by a.foo))=count(a.bar by a.foo)
                     71: will not.  In general the problem is in queries with clauses of the
                     72: form simpleagg(aggfunc())=thesameaggfunc() as such a clause does not
                     73: connect the 'by' clause of the aggfunc with the rest of the query.
                     74: 
                     75: On the SUN many bugs are known but the system and the system is barely
                     76: functional.  Serious use of this version of INGRES on the SUN is
                     77: discouraged.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.