<?xml version="1.0" encoding="utf-8"?>
<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
<!-- This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-FE76E172-6B94-47CC-9551-6DD62C04368D" xml:lang="en"><title>Analysis
of OSS</title><shortdesc>This section explains the tools and tips for effective analysis
of Linux OSS.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<section id="GUID-533D0116-B744-4DAD-8E4B-4957E911D6C5">       <title>Installing
Linux packages in Linux</title>  <ul>
<li><p>Get the latest stable release of OSS from the Internet. Usually OSS
come a in compressed format like <filepath>.tar</filepath>, <filepath>.gz</filepath>,
or <filepath>bz2</filepath>.</p></li>
<li><p>Run the configure script using the following command: <codeph>./configure</codeph>.
It will look for dependency and creates makefiles.</p></li>
<li><p>Compile the code using make tool.</p></li>
<li><p>Copy the files to the target path using the command make install. </p></li>
</ul></section>
<section id="GUID-6A79BF94-03C7-4974-B998-2D91483E08AB"><title>Directory analysis </title><p>OSS
creates the following three subdirectories in the installation directory: <filepath>include</filepath>, <filepath>lib</filepath>,
and <filepath>bin</filepath>. These directories contain valuable information
required for porting, as explained below:</p><ul>
<li><p><b><filepath>include</filepath></b> – This directory contains the user
include files that need to be exported to the proper export directory in Symbian
platform. </p></li>
<li><p><b><filepath>lib</filepath></b> – This directory gives an idea of the
size of the library. It contains libraries built as a result of OSS compilation.
Each of these requires an individual MMP file. </p><note>Symbian platform
compilers produce much smaller-sized libraries than what there are in Linux.</note><table id="GUID-EE2394CB-19F0-4E68-936C-A42AE6AF30EE">
<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
<tbody>
<row>
<entry><p><b>Linux</b></p></entry>
<entry><p><b>Symbian platform</b></p></entry>
</row>
<row>
<entry><p>.SO extension for dynamic libraries</p></entry>
<entry><p>.DLL extension for dynamic libraries</p></entry>
</row>
<row>
<entry><p>.A extension for static libraries</p></entry>
<entry><p>.LIB extension for static libraries</p></entry>
</row>
</tbody>
</tgroup>
</table></li>
<li><p><b><filepath>bin</filepath></b> – This directory contains the executable
built during the compilation of OSS. </p></li>
<li><p><b><filepath>man</filepath></b> – This directory contains the man pages
of OSS. </p></li>
</ul></section>
<section id="GUID-2CFCDC34-B64D-41E7-B432-EF169EAE6392"><title>Tips and tools</title><p>Tools
like <codeph>nm</codeph>, <codeph>ldd</codeph>, and <codeph>dumpbin</codeph> are
useful in OSS porting:</p><ul>
<li><p><b><codeph>ldd</codeph></b> – A Linux tool that can be used to find
the dependency library list and overall size of the library, obtained by adding
the size of all the dependent libraries. In many cases, to build library 'X'
another library 'Y' is needed.</p></li>
<li><p><b><codeph>nm</codeph></b> – Another Linux tool that prints the symbol
table in alphabetical order from one or more object files.</p></li>
<li><p><b><codeph>dumpbin</codeph></b> – A Windows-based tool that can be
used if Windows port is available for OSS. It gets the list of exported symbols. </p></li>
</ul><p>The following command can be used to install the software in the user
directory:  </p><codeblock xml:space="preserve"> ./configure --prefix=$HOME/&lt;foo&gt;</codeblock><p>The
following commands can be used to decompress the file:</p><codeblock xml:space="preserve">tar -xvjf archivefile.tar.bz2 
tar -zxvf archivefile.tar.bz2</codeblock><p>At the end of installing the OSS
in Linux, it is good to update the environment variables <codeph>PKG_CONFIG_PATH</codeph> and <codeph>LD_LIBRARY_PATH</codeph>.
One of the many ways to initialize environment variables is to add them in
the <filepath>.bash_rc</filepath> file.</p><p>Makefile gives subtle information
about the project. <codeph>SOURCES</codeph> in Makefile gives an idea about
the source files of the OSS. These files have to be listed in <codeph>SOURCE</codeph> in
the MMP file.</p><p><codeph>-D&lt;Foo&gt;</codeph> in Makefile gives the list
of preprocessor declarations. These preprocessor declarations can be done
using <codeph>MACRO</codeph> in the MMP file. </p></section>
</conbody></concept>