1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Configuration, installation and runtime options — XMDS2 2.2.2 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '2.2.2',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS_HTML,http://www.xmds.org/_static/mathjax-use-tex-fonts.js"></script>
<link rel="shortcut icon" href="_static/xmds_favicon.ico"/>
<link rel="top" title="XMDS2 2.2.2 documentation" href="index.html" />
<link rel="up" title="Reference section" href="reference_index.html" />
<link rel="next" title="Useful XML Syntax" href="reference_usefulXMLSyntax.html" />
<link rel="prev" title="Reference section" href="reference_index.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="reference_usefulXMLSyntax.html" title="Useful XML Syntax"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="reference_index.html" title="Reference section"
accesskey="P">previous</a> |</li>
<li><a href="index.html">XMDS2 2.2.2 documentation</a> »</li>
<li><a href="reference_index.html" accesskey="U">Reference section</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<p>:: index:: Configure, Reconfigure, XMDS2 runtime options</p>
<div class="section" id="configuration-installation-and-runtime-options">
<span id="referenceconfigurationinstallationruntime"></span><h1>Configuration, installation and runtime options<a class="headerlink" href="#configuration-installation-and-runtime-options" title="Permalink to this headline">ΒΆ</a></h1>
<dl class="docutils">
<dt>Running the ‘xmds2’ program with the option ‘–help’, gives several options that can change its behaviour at runtime. These include:</dt>
<dd><ul class="first last simple">
<li>‘-o’ or ‘–output’, which overrides the name of the output file to be generated</li>
<li>‘-n’ or ‘–no-compile’, which generates the C code for the simulation, but does not try to compile it</li>
<li>‘-v’ or ‘–verbose’, which gives verbose output about compilation flags.</li>
<li>‘-g’ or ‘–debug’, which compiles the simulation in debug mode (compilation errors refer to lines in the source, not the .xmds file). This option implies ‘-v’. This option is mostly useful when debugging XMDS code generation.</li>
<li>‘–waf-verbose’, which makes <tt class="docutils literal"><span class="pre">waf</span></tt> be very verbose when configuring XMDS or compiling simulations. This option is intended for developer use only to aid in diagnosing problems with <tt class="docutils literal"><span class="pre">waf</span></tt>.</li>
</ul>
</dd>
</dl>
<p>It also has commands to configure XMDS2 and recheck the installation. If your program requires extra paths to compile, you can configure XMDS2 to include those paths by default. Simply use the command</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>xmds2 --configure --include-path /path/to/include --lib-path /path/to/lib
</pre></div>
</div>
<p>Alternatively, you can set the <tt class="docutils literal"><span class="pre">CXXFLAGS</span></tt> or <tt class="docutils literal"><span class="pre">LINKFLAGS</span></tt> environment variables before calling <tt class="docutils literal"><span class="pre">xmds2</span> <span class="pre">--reconfigure</span></tt>. For example, to pass the compiler flag <tt class="docutils literal"><span class="pre">-pedantic</span></tt> and the link flag <tt class="docutils literal"><span class="pre">-lm</span></tt> using the bash shell, use:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span><span class="nb">export </span><span class="nv">CXXFLAGS</span><span class="o">=</span><span class="s2">"-pedantic"</span>
<span class="nv">$ </span><span class="nb">export </span><span class="nv">LINKFLAGS</span><span class="o">=</span><span class="s2">"-lm"</span>
<span class="nv">$ </span>xmds2 --reconfigure<span class="sb">``</span>
</pre></div>
</div>
<p>This method can also be used to change the default compilers for standard and parallel processing, using the CXX and MPICXX flags respectively.</p>
<p>Running XMDS2 with the ‘–configure’ option also searches for packages that have been installed since you last installed or configured XMDS2. If you wish to run ‘xmds2 –configure’ with the same extra options as last time, simply use the command:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>xmds2 --reconfigure
</pre></div>
</div>
<p>A detailed log of the checks is saved in the file ‘~/.xmds/waf_configure/config.log’. This can be used to identify issues with packages that XMDS2 is not recognised, but you think that you have successfully installed on your system.</p>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<img class="logo" src="_static/xmds_logo.png" alt="Logo"/>
</a></p>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="reference_usefulXMLSyntax.html" title="Useful XML Syntax"
>next</a> |</li>
<li class="right" >
<a href="reference_index.html" title="Reference section"
>previous</a> |</li>
<li><a href="index.html">XMDS2 2.2.2 documentation</a> »</li>
<li><a href="reference_index.html" >Reference section</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2008-2014, Graham Dennis, Joe Hope and Mattias Johnsson. Licensed under the GNU FDL.
Last updated on Oct 14, 2014.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2b1.
</div>
</body>
</html>
|
