nsz Git - libfirm/blob - README

   1
   2 This is a library implementing the intermediate representation FIRM
   3 developed at IPD Goos, Uni Karlsruhe.
   4
   5 Create an architecture dependent directory (eg 'mkdir i686-linux') an
   6 cd to it. Call ../configure with wanted features (see ../configure
   7 --help for more hints). Call 'make' to construct the library. This
   8 creates a file libfirm.a
   9
  10 To test the library goto ./<arch>/testprograms and call 'make test'
  11 there.
  12
  13 If you have set up the include and libdir using configure you can
  14 install the library and its headers by 'make install'.  This is
  15 encouraged if the library is hooked up to any other modules, e.g., a
  16 front end.
  17
  18 To generate FIRM code from a compiler frontend read the documentation
  19 "libFIRM: A Library for Compiler Optimization Reaserch Implementing
  20 Firm", UKA tech-report 2002-5. About Firm you can learn in UKA
  21 tech-report 1999-14.
  22
  23
  24
  25 You can generate a Java Native Interface for the library.  For this
  26 configure libfirm with --enable-firmjni and give the path to
  27 the jni headers, e.g.
  28 --with-includedir=/usr/public2/java/jdk1.3.1-sun/include/:/usr/
  29   public2/java/jdk1.3.1-sun/include/linux/.
  30 Then go to ./<arch>/firmjni and call make.  To test the native
  31 interface go on to testprograms and call make test.
  32
  33
  34 If you are using the library for heap analysis with libfirm you
  35 have to configure libfirm with --enable-heapanalysis.  If you
  36 use the heap analysis through the java native interface you
  37 must in addition give the paths to the heap analysis installation:
  38 --with-includedir=<path where you find heapanal/heapanal.h>
  39 --with-libdir=<path where you find libheapanal.a>
  40
  41
  42
  43 You can also give the paths by setting environment variables
  44 CPPFLAGS and LDFLAGS before configuring.