****************************************************

             XML Definition Interpreter

           Build Instructions - Red Hat Linux

    Copyright (c) 2005 - The MITRE Corporation

****************************************************

The MITRE Corporation developed the Definition Interpreter to 
demonstrate the usability of OVAL definitions in the XML formats.
The source for the Interpreter is freely available
for reference use. This document describes the steps you need to
build the OVAL Definition Interpreter.

For information about using the Interpreter refer to the ReadMe.txt
file included with the Interpreter, or the OVAL Web site.

      XML Definition Interpreter:
      http://oval.mitre.org/oval/download/README_xml.html 

BY USING THE INTERPRETER, YOU SIGNIFY YOUR ACCEPTANCE OF THE
TERMS AND CONDITIONS OF USE.  IF YOU DO NOT AGREE TO THESE TERMS,
DO NOT USE THE INTERPRETER.  SEE THE TERMS.TXT FILE INCLUDED WITH
THE INTERPRETER, OR http://oval.mitre.org/oval/termsofuse.html.


-- CONTENTS --

  I    OVERVIEW
        A. Source Distribution
        B. Source Distribution Contents
        C. Supporting Libraries
  II  XML DEFINITION INTERPRETER
        A. PCRE Library
        B. Xerces Library
        C. Building the XML Definition Interpreter
  III   PCRE
  IV   XERCES
  V    REPORTING PROBLEMS

-- I -- OVERVIEW --

Download the appropriate installation files from the OVAL Web site.

  A. Source Distributions

       The source for the Interpreter is freely available on the OVAL
       Web site.  There is currently a bzipped tarball for linux users 
       that contains all the source code as well as a Makefile for 
       each interpreter.  To download the source go to:

            http://oval.mitre.org/oval/download/interpreter.html

  B. Source Distribution Contents

       The source code distribution contains the source for
       both the XML Definition Interpreter. The source distribution
       does not include the source for the libraries needed to compile the
       Interpreter.


  C. Supporting Libraries

       The Interpreter rely on several c/c++ libraries that can be found
       on the web.  The supporting libraries are not included in the source
       distribution of the Interpreter.  See sections III - IV for more 
       information about the specific libraries used and where to download
       their source from.
     
-- II -- XML DEFINITION INTERPRETER --

The following instructions describe how to build the OVAL XML Definition 
Interpreter on a Red Hat system.  The XML Definition Interpreter has been
built on Red Hat and tested on Red Hat Enterprise Linux 3 and Red Hat 9.
The source distribution includes a makefile that has can be used to
build the Interpreter.  Before the Interpreter can be built the supporting
libraries must be installed. Follow the instruction below to setup and install
the supporting libraries.

  A. PCRE (Perl-compatible regular-expression) Library
 
       Red Hat Enterprise 3 and Red Hat 9 generally include the PCRE 
       library.  If it has not been installed your system, it is easiest
       to simply install the pcre-devel RPM, available from Red Hat via
       your install media or Internet download method.

  B. Xerces Library

       The Definition Interpreter uses the open source Xerces library.  The
       binary was compiled with version 2.6 of the xerces-c library.  From
       the Xerces Web site:

         "This product includes software developed by the Apache Software
	 Foundation (http://www.apache.org/)."

       For more information about Xerces visit:

         http://xml.apache.org

       The source code is also available at the above Web site.

       Note: Our ovaldi RPM places a pre-compiled copy of this library into
             /usr/lib/ovaldi to reduce the dependencies that an unsophisticated
	     user would need to resolve.

  C. Building the XML Definition Interpreter

      After installing the PCRE and Xerces libraries, change into the 
      directory:

        <installed path>\Interpreter\project\redhat

      From that directory, simply run "make" to build the XML Definition
      Interpreter.

 
-- III -- PCRE --

The Interpreter uses the open source PCRE library.  The Interpreter
currently uses version 5.0 of the PCRE library.  From the PCRE Web site:

  "Regular expression support is provided by the PCRE library 
   package, which is open source software, written by Philip Hazel,
   and copyright by the University of Cambridge, England."

For more information about PCRE visit:

    http://www.pcre.org

To download the source code for PCRE, please use the following ftp
site:

    ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

-- IV -- XERCES --

The Definition Interpreter uses the open source Xerces library.  The
binary was compiled with version 2.6 of the xerces-c library.  From
the Xerces Web site:

  "This product includes software developed by the Apache Software
  Foundation (http://www.apache.org/)."

For more information about Xerces visit:

    http://xml.apache.org

The source code is also available at the above Web site.


    Note: Our ovaldi RPM places a pre-compiled copy of this library into
	  /usr/lib/ovaldi to reduce the dependencies that an unsophisticated
	  user would need to resolve.


-- V -- REPORTING PROBLEMS --

To report a problem with either OVAL Definition Interpreter, please
send an email with a brief description of the problem to 
oval@mitre.org. Include the platform the Interpreter was run on, and
the version of the Interpreter and definitions file.

