Unix instructions:

1. Set the environment variable LDFLAGS to indicate the Oracle libraries needed to build the system. For instance:

   LDFLAGS=-lclntsh -lcommon -lcore4 -lnlsrtl3

   or

   setenv LDFLAGS "-lclntsh -lcommon -lcore4 -lnlsrtl3"

   depending on the shell that you are using. We have found that the required libraries are frequently dependent upon the version of Oracle, the version of any additional Oracle component -- such as SQL*Net -- and possibly the operating system. Hence, they will likely differ from those shown. We further warn that the order in which the libraries are listed may be important. We have also witnessed that certain libraries may require multiple listings. Please refer to your Oracle documentation.

2. Change directory to $XSB_DIR/build and run the XSB configuration script, configure, with the options

   -with-oracle     -site-static-libraries=OracleLibPath

   where OracleLibPath is the directory that contains the Oracle client libraries.

   With some configurations, compilation of Pro*C files requires that you use a C compiler other than the default one. If such is the case, then additionally pass the option

   -with-cc=compiler

   to configure, indicating that compiler compiler should instead be used.

   As a final measure, if Oracle include files cannot be located automatically, then employ the option

   -site-includes=OracleHeaderPath

   where OracleHeaderPath is the directory that contains the Oracle client header files.

   Note the final message that configure produces before completing. It indicates how you should invoke makexsb to build an Oracle-enabled version of XSB (step 4).

3. Change directory to $XSB_DIR/emu and create the file orastuff.c from orastuff.pc by invoking the Pro*C preprocessor:

   make -f proc.mk orastuff.c

   A sample makefile, proc.mk, is provided, but you should use the one included with your version of Oracle. This used to be found with sample SQL*Plus and Pro*C files in the Oracle installation hierarchy.

   Note: this file may provide insight into the library paths and linking options required by your Oracle installation.

4. Run makexsb as directed by the message displayed at the end of the run of the configure script (from step 2).

   If errors ensue, then review the cause(s) and consider employing the additional options mentioned in step 2. If one or more are appropriate, then apply them, repeating this process from that step.

   When makexsb completes, it will provide you with the name of the XSB executable. Unless you have used the configuration option

   -config-tag=tag

   this will likely be ../bin/xsb-ora.