    ======================================================
    Frequently Asked Questions (FAQ) for PostgreSQL >=V6.1
    IRIX Specific
    TO BE READ IN CONJUNCTION WITH THE NORMAL FAQ
    ======================================================
    last updated:           Mon Mar 05 17:00:00 GMT 1998

    current maintainer:     Andrew C.R. Martin (martin@biochem.ucl.ac.uk)
    original author:        Andrew C.R. Martin (martin@biochem.ucl.ac.uk)

    Changes in this version (* = modified, + = new, - = removed):
    *1.5)   Can I install PostgreSQL (<V6.3) under Irix 6.x?
    +1.10)  How do I install PostgreSQL V6.3 under Irix 6.x?

    This file is divided approximately as follows:
    1.*)    Installing PostgreSQL
    2.*)    Uninstalling PostgreSQL
    3.*)    Extending PostgreSQL

    Questions answered:
    1.1)    What extra items do I need to install PostgreSQL under Irix?
    1.2)    What changes do I need to make to src/Makefile.global?
    1.3)    What are the references in X11_LIB to libsocket and libnsl in
            src/Makefile.global?
    1.4)    Are there any other changes I should make?
    1.5)    Can I install PostgreSQL (<V6.3) under Irix 6.x?
    1.6)    The make fails with the following message:
            ld32: ERROR 4: Conflicting flag setting: -call_shared
    1.7)    Why won't it link? (Problems with lorder)
    1.8)    I have major problems with IRIX 6!
    1.9)    Why does lex fail with PostgreSQL 6.2.1?
    1.10)   How do I install PostgreSQL V6.3 under Irix 6.x?
    2.1)    Why can't I move the executable files?
    3.1)    How do I compile a C program to create a function for extending
            PostgreSQL

    ----------------------------------------------------------------------
    Section 1:      Installing PostgreSQL
    ----------------------------------------------------------------------

    1.1)    What extra items do I need to install PostgreSQL under Irix?

            You *must* have the following installed:
            a) Gnu make (installed as gmake)

            You are recommended to install the following:
            a) GNU install (installed as ginstall)
               (This is part of the GNU fileutils package)

            You may choose to install the following:
            a) GNU readline library (if you wish psql to have readline
               support).
            b) tcl/tk (if you wish to compile pgtclsh)

    1.2)    What changes do I need to make to src/Makefile.global or
            src/Makefile.custom?

            The easiest way to do this is to use the customize script in
            the src directory.

            You *must* set the following variables:
                    PORTNAME=       irix5

            You will also need to change the following to match your own
            installation:
                    POSTGRESDIR

            If you switch on the USE_TCL option, you will need to set these:
                    TCL_INCDIR=
                    TCL_LIBDIR=
                    TCL_LIB =
                    TK_INCDIR=
                    TK_LIBDIR=
                    TK_LIB =

            You may also make any other changes you need as documented in
            the INSTALL file and in Makefile.global

    1.3)    What are the references in X11_LIB to libsocket and libnsl in
            src/Makefile.global?

            This was a problem in 1.08 (they are Sun Solaris specific).
            It is fixed in 1.09 and above.

    1.4)    Are there any other changes I should make?

            If you have installed the GNU install program (ginstall), you
            should add the following line to src/Makefile.custom:
                    CUSTOM_INSTALL=ginstall

            For an explanation as to why this is a good idea, see Question 2.1
            Ginstall is part of the GNU fileutils package.

    1.5)    Can I install PostgreSQL (<V6.3) under Irix 6.x?

            Instructions for PostgreSQL V6.3 are answered in Question 1.10!

            Irix 6.2-6.4 has a bug in ld which mishandles the addresses of
            static procedures when object files are assembled into
            larger object files using 'ld -r'. This bug has been reported
            to Silicon Graphics.

            One option is to use the Gnu version of ld. Alternatively,
            the following patch should be applied as a workaround.
            (Supplied by Bob Bruccoleri <bruc@bms.com>)

    *** ./backend/Makefile.orig     Thu May 22 00:00:15 1997
    --- ./backend/Makefile  Thu Jun  5 16:47:27 1997
    ***************
    *** 54,60 ****
      all: postgres $(POSTGRES_IMP) global1.bki.source local1_template1.bki.source

      postgres: $(OBJS) ../utils/version.o
    !       $(CC) -o postgres $(OBJS) ../utils/version.o $(LDFLAGS)

      $(OBJS): $(DIRS:%=%.dir)

    --- 54,64 ----
      all: postgres $(POSTGRES_IMP) global1.bki.source local1_template1.bki.source

      postgres: $(OBJS) ../utils/version.o
    ! #     $(CC) -o postgres $(OBJS) ../utils/version.o $(LDFLAGS)
    !       -rm -f *.o
    !       find . -name "*.o" -exec cp \{\} . \;
    !       rm -f SUBSYS.o
    !       $(CC) -o postgres *.o ../utils/version.o $(LDFLAGS)

      $(OBJS): $(DIRS:%=%.dir)

    1.6)    The make fails with the following message:
            ld32: ERROR 4: Conflicting flag setting: -call_shared

            If gmake fails in .../src/backend while building obj/ACCESS.o
            with a message from ld32, you can work around this by using
            ld for the LD environment variable rather than cc.

            The problem has been observed under Irix 5.3 when compiling both
            Postgres95-1.09 and PostgreSQL-6.2Beta6, but on some systems
            these appear to compile with no such problems.

            Fix supplied by Brian Sanders (bsanders@netcom.com,
            brian@fresnelsoft.com)

    1.7)    Why won't it link? (Problems with lorder)

            According to the IRIX man pages, lorder is useless, but harmless
            under IRIX. However, it has caused problems for some people
            using both IRIX 6.2.

            The solution is to add the following line to
            .../src/makefiles/Makefile.irix5

            MK_NO_LORDER=true

    1.8)    I have major problems with IRIX 6!

            The following is quoted directly from Bob Bruccoleri <bruc@bms.com>

    There is a really nasty loader bug in the compiler system (7.1)
    on Irix 6.x, and the error that Lasse Petersen is the result of it.
    Here is the original message. I don't know if all the changes have been
    folded into the current release.

    Date: Fri, 06 Jun 1997 17:12:20 -0400 (EDT)
    From: bruc@bms.com (Robert Bruccoleri)
    Subject: [PORTS] Patches for Irix 6.4

    I have worked out how to compile PostgreSQL on Irix 6.4 using the -n32 compiler
    mode and version 7.1 of the C compiler. (The n32 compiler use 32 bits addressing,
    but allows access to all the instructions in the MIPS4 instruction set.)
    There were several problems:

    1) The ld command is not referenced as a macro in all the Makefiles. On
    this platform, you have to include -n32 on all the ld commands. Makefiles
    were changed as needed.

    2) There is a bug in "ld" which mishandles the addresses of static procedures
    when object files are assembled into larger object files using "ld -r".
    Because of this, I put a hack into src/backend/Makefile to avoid all the
    SUBSYS.o files and just link all the objects. I have contacted SGI about the
    problem, and hopefully, it will be fixed in the near future.

    3) Lots of warnings are generated from the compiler. Since the regression
    tests worked OK, I didn't attempt to fix them. If anyone wants the compilation
    log, please let me know, and I'll email it to you.

    The version of postgresql was 970602. Here is Makefile.custom:

    CUSTOM_COPT = -O2 -n32
    MK_NO_LORDER = 1
    LD = ld -n32
    CC += -n32

    Here are the patches:

    *** ./backend/access/Makefile.orig      Sun Nov 10 00:00:15 1996
    - --- ./backend/access/Makefile Tue Jun  3 10:22:32 1997
    ***************
    *** 8,13 ****
    - --- 8,16 ----
      #
      #-------------------------------------------------------------------------

    + SRCDIR = ../..
    + include ../../Makefile.global
    +
      OBJS = common/SUBSYS.o gist/SUBSYS.o hash/SUBSYS.o heap/SUBSYS.o \
             index/SUBSYS.o rtree/SUBSYS.o nbtree/SUBSYS.o transam/SUBSYS.o

    *** ./backend/bootstrap/Makefile.orig   Fri Apr 18 06:00:23 1997
    - --- ./backend/bootstrap/Makefile      Tue Jun  3 10:23:59 1997
    ***************
    *** 38,44 ****
      all: SUBSYS.o

      SUBSYS.o: $(OBJS)
    !       ld -r -o SUBSYS.o $(OBJS)

      # bootstrap.o's dependency on bootstrap_tokens.h is computed by the
      # make depend, but we state it here explicitly anyway because
    - --- 38,44 ----
      all: SUBSYS.o

      SUBSYS.o: $(OBJS)
    !       $(LD) -r -o SUBSYS.o $(OBJS)

      # bootstrap.o's dependency on bootstrap_tokens.h is computed by the
      # make depend, but we state it here explicitly anyway because

    *** ./backend/Makefile.orig     Thu May 22 00:00:15 1997
    - --- ./backend/Makefile        Thu Jun  5 16:47:27 1997
    ***************
    *** 54,60 ****
      all: postgres $(POSTGRES_IMP) global1.bki.source local1_template1.bki.source

      postgres: $(OBJS) ../utils/version.o
    !       $(CC) -o postgres $(OBJS) ../utils/version.o $(LDFLAGS)

      $(OBJS): $(DIRS:%=%.dir)

    - --- 54,64 ----
      all: postgres $(POSTGRES_IMP) global1.bki.source local1_template1.bki.source

      postgres: $(OBJS) ../utils/version.o
    ! #     $(CC) -o postgres $(OBJS) ../utils/version.o $(LDFLAGS)
    !       -rm -f *.o
    !       find . -name "*.o" -exec cp \{\} . \;
    !       rm -f SUBSYS.o
    !       $(CC) -o postgres *.o ../utils/version.o $(LDFLAGS)

      $(OBJS): $(DIRS:%=%.dir)

    ***************
    *** 116,122 ****
      install: $(LIBDIR) $(BINDIR) $(HEADERDIR) postgres $(POSTGRES_IMP) fmgr.h\
               global1.bki.source local1_template1.bki.source \
               libpq/pg_hba.conf.sample optimizer/geqo/pg_geqo.sample
    !
            $(INSTALL) $(INSTL_EXE_OPTS) postgres $(BINDIR)/postgres
      ifeq ($(MAKE_EXPORTS), true)
            $(INSTALL) $(INSTLOPTS) $(POSTGRES_IMP) $(LIBDIR)/$(POSTGRES_IMP)
    - --- 120,126 ----
      install: $(LIBDIR) $(BINDIR) $(HEADERDIR) postgres $(POSTGRES_IMP) fmgr.h\
               global1.bki.source local1_template1.bki.source \
               libpq/pg_hba.conf.sample optimizer/geqo/pg_geqo.sample
    !
            $(INSTALL) $(INSTL_EXE_OPTS) postgres $(BINDIR)/postgres
      ifeq ($(MAKE_EXPORTS), true)
            $(INSTALL) $(INSTLOPTS) $(POSTGRES_IMP) $(LIBDIR)/$(POSTGRES_IMP)

    *** ./backend/optimizer/Makefile.orig   Wed Feb 19 12:00:34 1997
    - --- ./backend/optimizer/Makefile      Tue Jun  3 10:39:47 1997
    ***************
    *** 8,13 ****
    - --- 8,16 ----
      #
      #-------------------------------------------------------------------------

    + SRCDIR= ../..
    + include ../../Makefile.global
    +
      all: submake SUBSYS.o

      OBJS = path/SUBSYS.o plan/SUBSYS.o prep/SUBSYS.o util/SUBSYS.o geqo/SUBSYS.o

    *** ./backend/libpq/pqcomprim.c.orig    Mon May 26 00:00:23 1997
    - --- ./backend/libpq/pqcomprim.c       Fri Jun  6 16:02:24 1997
    ***************
    *** 32,40 ****
      #    define hton_l(n) (ntoh_l(n))
      #  else       /* BYTE_ORDER != BIG_ENDIAN */
      #    if BYTE_ORDER == PDP_ENDIAN
    ! #      #error PDP_ENDIAN macros not written yet
      #    else     /* BYTE_ORDER !=  anything known */
    ! #      #error BYTE_ORDER not defined as anything understood
      #    endif    /* BYTE_ORDER == PDP_ENDIAN */
      #  endif      /* BYTE_ORDER == BIG_ENDIAN */
      #endif                /* BYTE_ORDER == LITTLE_ENDIAN */
    - --- 32,40 ----
      #    define hton_l(n) (ntoh_l(n))
      #  else       /* BYTE_ORDER != BIG_ENDIAN */
      #    if BYTE_ORDER == PDP_ENDIAN
    ! #      error PDP_ENDIAN macros not written yet
      #    else     /* BYTE_ORDER !=  anything known */
    ! #      error BYTE_ORDER not defined as anything understood
      #    endif    /* BYTE_ORDER == PDP_ENDIAN */
      #  endif      /* BYTE_ORDER == BIG_ENDIAN */
      #endif                /* BYTE_ORDER == LITTLE_ENDIAN */

    *** ./backend/storage/Makefile.orig     Sun Nov 10 00:01:06 1996
    - --- ./backend/storage/Makefile        Tue Jun  3 10:41:29 1997
    ***************
    *** 8,13 ****
    - --- 8,16 ----
      #
      #-------------------------------------------------------------------------

    + SRCDIR= ../..
    + include ../../Makefile.global
    +
      all: submake SUBSYS.o

      OBJS = buffer/SUBSYS.o file/SUBSYS.o ipc/SUBSYS.o large_object/SUBSYS.o \

    1.9)    Why does lex fail with PostgreSQL 6.2.1?

            IRIX 5.3 lex has been reported to fail in
            postgresql-6.2.1/src/backend/parser with the error:

            lex scan.l
            "scan.l":line 86: Error: Invalid request %x xc
            gmake[2]: *** [scan.c] Error 1

            The answer is to use GNU flex 2.5.4 or later. Use the command
               flex --version
            to check you have a new enough version of flex

    1.10)   How do I install PostgreSQL V6.3 under Irix 6.x?

            Irix 6.2-6.4 has a bug in ld which mishandles the addresses of
            static procedures when object files are assembled into
            larger object files using 'ld -r'. This bug has been reported
            to Silicon Graphics.

            Depending on your Irix installation you may also encounter
            2 other problems detailed below: Conflict in C standards,
            Conflict in library functions.

            a) Solving the ld bug
            ---------------------

            One option is to use the Gnu version of ld. Alternatively,
            the following patch should be applied as a workaround.
            (Supplied by Bob Bruccoleri <bruc@bms.com> and modified for
            PostgreSQL V6.3 by Lasse Hiller Petersen <lassehp@imv.aau.dk>)

            Apply the following patch:

    *** ./backend/Makefile.orig     Tue Mar  3 15:33:58 1998
    --- ./backend/Makefile  Tue Mar  3 15:39:27 1998
    ***************
    *** 63,69 ****
                                    global1.description
    local1_template1.description

      postgres: $(OBJS) ../utils/version.o
    !       $(CC) -o postgres $(OBJS) ../utils/version.o $(LDFLAGS)

      $(OBJS): $(DIRS:%=%.dir)

    --- 63,73 ----
                                    global1.description
    local1_template1.description

      postgres: $(OBJS) ../utils/version.o
    ! #     $(CC) -o postgres $(OBJS) ../utils/version.o $(LDFLAGS)
    !       -rm -f *.o
    !       find . -name "*.o" -exec cp \{\} . \;
    !       rm -f SUBSYS.o
    !       $(CC) -o postgres *.o ../utils/version.o $(LDFLAGS)

      $(OBJS): $(DIRS:%=%.dir)

            Lasse configured with ./configure --enable-locale
            and modified Makefile.custom to contain:
    CC = cc -n32
    LD = ld -n32

            He reports that the installation without -n32 works fine too,
            but the -n32 was required for compatibility with his Perl
            installation. His system was an Origin200 running IRIX64 v6.4.

            b) Conflict in C standards
            --------------------------

            I have found that the following patch is also necessary in order
            to prevent a duplicate definition of a Union used for semaphores.
            Apply the following patch to:
            .../src/makefile/Makefile.irix5:

    *** src/makefiles/Makefile.irix5.orig   Thu Mar  5 16:59:58 1998
    --- src/makefiles/Makefile.irix5        Thu Mar  5 17:01:13 1998
    ***************
    *** 6,9 ****
      %.so: %.o
            $(LD) -G -Bdynamic -shared -o $@ $<

    !
    --- 6,9 ----
      %.so: %.o
            $(LD) -G -Bdynamic -shared -o $@ $<

    ! CFLAGS+= -U_NO_XOPEN4

            i.e. the addition of the line:
            CFLAGS+= -U_NO_XOPEN4

            This is needed to stop the semun union being redefined in
            /usr/include/sys/sem.h

            c) Conflict in library functions
            --------------------------------

            In addition, if you have the nsl and crypt libraries these will
            conflict with the required definitions. I think that libnsl.a
            may be the Netware socket library (or something similar). In
            any case, if you have these libraries, they will be added to
            Makefile.global and you will need to remove them.

            Thus, you should edit .../src/Makefile.global. Goto (approximately)
            line 217 where LDFLAGS= is set and remove -lnsl and -lcrypt
            from this line.

    ----------------------------------------------------------------------
    Section 2:      Deinstalling PostgreSQL
    ----------------------------------------------------------------------

    2.1)    Why can't I move the executable files?

            By default, the IRIX port uses the BSD compatible version of
            install from /usr/bin/X11. If you read the man page for this
            version of install, you will see that it is not meant for
            end-user use; it has the interesting side-effect of chowning
            files it installs to root.

            You should still be able to delete the files as you (the
            postgres user) will own the directory in which they are
            stored.

            The normal IRIX install program cannot be used easily as it
            takes its arguments in the reverse order. It is therefore
            recommended to use the GNU version of install (ginstall).
            See Question 1.4

    ----------------------------------------------------------------------
    Section 3:      Extending PostgreSQL
    ----------------------------------------------------------------------
    3.1)    How do I compile a C program to create a function for extending
            PostgreSQL

            Here is a sample command line:

            cc -I/usr/local/PostgreSQL/include/ -I/usr/local/PostgreSQL/src/backend
                    -shared -o funcs.so funcs.c

    ----------------------------------------------------------------------------
    Dr. Andrew C.R. Martin                             University College London
    EMAIL: (Work) martin@biochem.ucl.ac.uk    (Home) andrew@stagleys.demon.co.uk
    URL:   http://www.biochem.ucl.ac.uk/~martin
    Tel:   (Work) +44(0)171 419 3890                    (Home) +44(0)1372 275775