1 arta  1.1 This is the top-level directory in the SDO/JSOC software tree.
 2           
 3           The JSOC software tree compiles on the following architecture:
 4           
 5               * linux_ia32: X86 32-bit Intel and AMD processors: 
 6                 e.g., n00, n01, ..., n11
 7               * linux_x86_64: X86 64-bit AMD and Intel processors
 8                 e.g., n12, n13, n14, n15
 9           
10           Note: We no longer support linux_ia64 (Intel Itanium under SGI Irix)
11           after Ver_3-5-PreRelease.
12           
13           A new make system is in place after Ver_3-5-PreRelease. If you have a
14           cvs working directory of or before Ver_3-5-PreRelease, you'll need to
15           run 'make clean' before 'cvs update' in order to clean up the .c files

16 arta  1.2 generated from .pgc files in base/libsum_pg.

17 arta  1.1 
18           ./configure only makes symbolic links for all header files in the JSOC
19           tree.  The binaries, as well as .c files generated from .pgc files,
20           are placed into architecture specific target directory, e.g.,
21           _linux_ia32. Symbolic links to executables and libraries are also made
22           in bin/ and lib/.
23           
24           The default compiler is icc with optimization and without debug. Two

25 arta  1.2 exceptions to this rule are base/libsum_pg and base/sum, both

26 arta  1.1 of which are fixed to compile with 'gcc -g -O0'.
27           

28 arta  1.2 base/sum is not part of the default targets. Uncomment the
29           following line in base/sum/Rules.mk to change it.

30 arta  1.1 #TGT_BIN		:= $(TGT_BIN) $(TGT_$(d))
31           
32           Except for src/third_party/su, nothing in src/third_party is among the
33           default targets. 
34           
35           To change your default compiler to gcc, modify the following line in
36           make_basic.mk from
37           
38           COMPILER = icc
39           to 
40           COMPILER = gcc
41           
42           Before changing this make variable, you should run 'make clean'.
43           A mixture of icc-compiled and gcc-compiled object files will
44           probably not link and/or run properly.
45           
46           To enable debug, modify the following line in make_basic.mk from 
47           
48           DEBUG =

49 jps   1.3 to 
50           DEBUG = 1

51 arta  1.1 

52 jps   1.3 When you have finished making any customizations to make_basic.mk, type:
53           
54           ./configure
55           make
56           
57           If the computer you are building DRMS on has multiple CPUs, you
58           might want to save time by typing something like:

59 arta  1.1 

60 jps   1.3 make -j 4

61 arta  1.1 
62           Since there is only one Makefile for the whole JSOC tree, you must
63           always compile in this top level directory. However, you will be able
64           to make specific target, e.g., make drms_server.
65           

66 jps   1.3 To learn more about the new make system, please refer to
67           http://jsoc.stanford.edu/jsocwiki/JsocMakefileBackground      and
68           http://jsoc.stanford.edu/jsocwiki/JsocMakefileAdd