README.txt 1.81 KB
Newer Older
1 2 3 4 5
NOTE: see bottom of this file for suggested configurations on particular ANL
machines.

0 - Checkout, build, and install the trunk version of ROSS

6 7
    git clone http://github.com/carothersc/ROSS.git
    cd ROSS
8 9
    mkdir build
    cd build
10 11
	 # note: other options for ARCH include i386 (for 32 bit machines),
	 # bgp, and bgq (for Blue Gene systems)
12
    ARCH=x86_64 CC=mpicc CXX=mpicxx cmake -DCMAKE_INSTALL_PREFIX=../install ../
13 14 15
    make -j 3
    make install

16 17
    <the result should be that the latest version of ROSS is installed in the 
    ROSS/install/ directory>
18 19 20 21 22 23

1 - If this is the first time you are building codes-base, run

    ./prepare.sh

2- Configure codes-base. This can be done in the source directory or in a
Philip Carns's avatar
Philip Carns committed
24 25
   dedicated build directory if you prefer out-of-tree builds.  The CC
   environment variable must refer to an MPI compiler.
26

Philip Carns's avatar
Philip Carns committed
27
    ./configure --with-ross=/path/to/ross/install --prefix=/path/to/codes-base/install CC=mpicc
28 29 30

3 - Build codes-base

31
    make clean && make && make install && make tests
32

33 34 35 36 37
4 - (optional) run test programs

    make check

5 - codes-base uses flex and bison (or lex and yacc) to generate several parsers.
38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
These tools auto-generate C source files. To remove all of the autogenerated
files for these parsers, execute

    make maintainer-clean-local


Machine-specific configurations:
----------------
- Fusion (ANL): add the following keys to your ~/.soft file and run "resoft"
  prior to following the steps described in this file:

  +python-2.7.3
  +autoconf-2.68
  +git
  +cmake
Rob Ross's avatar
test  
Rob Ross committed
53

54 55
Notes on using the clang static analyzer
-----------------
56 57 58
- follow steps 0-2 as shown above, with one exception:
  - add the following argument to configure:
    CFLAGS=-I<path_to_your_mpi_include_directory>
59 60 61
- edit Makefile, and delete the "CC = mpicc" (or similar) line
- run "scan-build --use-cc=mpicc make"