<!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/xhtml;charset=UTF-8"/>
<meta name="robots" content="index,follow"/>
<title>AirRAC: Linking with AirRAC</title>
<link rel="shortcut icon" href="favicon.ico">
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="airrac.css" rel="stylesheet" type="text/css"/>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
$(document).ready(function() { searchBox.OnSelectItem(0); });
</script>
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-24983440-1']);
_gaq.push(['_setDomainName', 'none']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
<script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table width="100%">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname"><a href="http://airrac.sourceforge.net"><img height="45px" alt="AirRAC Logo" src="airrac_logo.png"></a>
 <span id="projectnumber">0.2.1</span>
</div>
<div id="projectbrief">C++ Simulated Revenue Accounting (RAC) System Library</div>
</td>
<!-- begin SOURCEFORGE_CUSTOM-->
<td>
<div id="sflogo"><a href="http://airrac.sourceforge.net"><img height="45px" alt="SourceForge Logo" src="sfx_logo.png"></a></div>
</td>
<!-- end SOURCEFORGE_CUSTOM-->
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.4 -->
<script type="text/javascript"><!--
var searchBox = new SearchBox("searchBox", "search",false,'Search');
--></script>
<script type="text/javascript">
function hasClass(ele,cls) {
return ele.className.match(new RegExp('(\\s|^)'+cls+'(\\s|$)'));
}
function addClass(ele,cls) {
if (!this.hasClass(ele,cls)) ele.className += " "+cls;
}
function removeClass(ele,cls) {
if (hasClass(ele,cls)) {
var reg = new RegExp('(\\s|^)'+cls+'(\\s|$)');
ele.className=ele.className.replace(reg,' ');
}
}
function toggleVisibility(linkObj) {
var base = linkObj.getAttribute('id');
var summary = document.getElementById(base + '-summary');
var content = document.getElementById(base + '-content');
var trigger = document.getElementById(base + '-trigger');
if ( hasClass(linkObj,'closed') ) {
summary.style.display = 'none';
content.style.display = 'block';
trigger.src = 'open.png';
removeClass(linkObj,'closed');
addClass(linkObj,'opened');
} else if ( hasClass(linkObj,'opened') ) {
summary.style.display = 'block';
content.style.display = 'none';
trigger.src = 'closed.png';
removeClass(linkObj,'opened');
addClass(linkObj,'closed');
}
return false;
}
</script>
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
<li><a href="dirs.html"><span>Directories</span></a></li>
<li id="searchli">
<div id="MSearchBox" class="MSearchBoxInactive">
<span class="left">
<img id="MSearchSelect" src="search/mag_sel.png"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
alt=""/>
<input type="text" id="MSearchField" value="Search" accesskey="S"
onfocus="searchBox.OnSearchFieldFocus(true)"
onblur="searchBox.OnSearchFieldFocus(false)"
onkeyup="searchBox.OnSearchFieldChange(event)"/>
</span><span class="right">
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
</span>
</div>
</li>
</ul>
</div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('linking.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">Linking with AirRAC </div> </div>
</div>
<div class="contents">
<div class="textblock"><h2><a class="anchor" id="toc"></a>
Table of Contents</h2>
<ul>
<li><a class="el" href="verification.html#intro">Introduction</a></li>
<li><a class="el" href="linking.html#pkgconfig">Using the pkg-config command</a></li>
<li><a class="el" href="linking.html#airrac_config">Using the airrac-config script</a></li>
<li><a class="el" href="linking.html#autotools">M4 macro for the GNU Autotools</a></li>
<li><a class="el" href="linking.html#dynamiclinking">Using AirRAC with dynamic linking</a></li>
</ul>
<h2><a class="anchor" id="intro"></a>
Introduction</h2>
<p>There are two convenient methods of linking your programs with the AirRAC library. The first one employs the <code>`pkg-config'</code> command (see <a href="http://pkgconfig.freedesktop.org/">http://pkgconfig.freedesktop.org/</a>), whereas the second one uses <code>`airrac-config'</code> script. These methods are shortly described below.</p>
<h2><a class="anchor" id="pkgconfig"></a>
Using the pkg-config command</h2>
<p><code>`pkg-config'</code> is a helper tool used when compiling applications and libraries. It helps you insert the correct compiler and linker options. The syntax of the <code>`pkg-config'</code> is as follows:</p>
<div class="fragment"><pre class="fragment">pkg-config <options> <library_name>
</pre></div><p>For instance, assuming that you need to compile an AirRAC based program <code>`my_prog.cpp'</code>, you should use the following command:</p>
<div class="fragment"><pre class="fragment">g++ `pkg-config --cflags airrac` -o my_prog my_prog.cpp `pkg-config --libs airrac`
</pre></div><p>For more information see the <code>`pkg-config'</code> man pages.</p>
<h2><a class="anchor" id="airrac_config"></a>
Using the airrac-config script</h2>
<p>AirRAC provides a shell script called <code>`airrac-config`</code>, which is installed by default in <code>`$prefix/bin'</code> (<code>`/usr/local/bin'</code>) directory. It can be used to simplify compilation and linking of AirRAC based programs. The usage of this script is quite similar to the usage of the <code>`pkg-config'</code> command.</p>
<p>Assuming that you need to compile the program <code>`my_prog</code>.cpp' you can now do that with the following command:</p>
<div class="fragment"><pre class="fragment">g++ `airrac-config --cflags` -o my_prog_opt my_prog.cpp `airrac-config --libs`
</pre></div><p>A list of <code>`airrac-config'</code> options can be obtained by typing:</p>
<div class="fragment"><pre class="fragment">airrac-config --help
</pre></div><p>If the <code>`airrac-config'</code> command is not found by your shell, you should add its location <code>`$prefix/bin'</code> to the <code>PATH</code> environment variable, e.g.:</p>
<div class="fragment"><pre class="fragment">export PATH=/usr/local/bin:$PATH
</pre></div><h2><a class="anchor" id="autotools"></a>
M4 macro for the GNU Autotools</h2>
<p>A M4 macro file is delivered with AirRAC, namely `airrac.m4', which can be found in, e.g., `/usr/share/aclocal'. When used by a `configure' script, thanks to he <code>`AM_PATH_AirRAC'</code> macro (specified in the M4 macro file), the following Makefile variables are then defined:</p>
<ul>
<li><code>`AirRAC_VERSION'</code> (e.g., defined to 0.23.0)</li>
<li><code>`AirRAC_CFLAGS'</code> (e.g., defined to <code>`-I${prefix}/include'</code>)</li>
<li><code>`AirRAC_LIBS'</code> (e.g., defined to <code>`-L${prefix}/lib -lairrac'</code>)</li>
</ul>
<h2><a class="anchor" id="dynamiclinking"></a>
Using AirRAC with dynamic linking</h2>
<p>When using static linking some of the library routines in AirRAC are copied into your executable program. This can lead to unnecessary large executables. To avoid having too large executable files you may use dynamic linking instead. Dynamic linking means that the actual linking is performed when the program is executed. This requires that the system is able to locate the shared AirRAC library file during your program execution. If you install the AirRAC library using a non-standard prefix, the <code>`LD_LIBRARY_PATH'</code> environment variable might be used to inform the linker of the dynamic library location, e.g.: </p>
<div class="fragment"><pre class="fragment">export LD_LIBRARY_PATH=<AirRAC installation prefix>/lib:$LD_LIBRARY_PATH
</pre></div> </div></div>
</div>
<div id="nav-path" class="navpath">
<ul>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Namespaces</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Friends</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Defines</a></div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<li class="footer">Generated on Wed Nov 2 2011 23:02:19 for AirRAC by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a>
1.7.4
</li>
<li class="footer">
<a href="http://sourceforge.net/projects/airrac"><img class="footer" src="http://sflogo.sourceforge.net/sflogo.php?group_id=317250&type=12&format=.png" alt="SourceForge Logo"></a>
</li>
</ul>
</div>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
12d0f975c6c7fa7093d99077a80c5759
>
files
>
191
