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
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Toolkit Installation on Linux</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><meta name="keywords" content="Intellon, Atheros, Qualcomm, HomePlug, powerline, communications, INT6000, INT6300, INT6400, AR7400, AR7420"><link rel="home" href="index.html" title="Qualcomm Atheros Open Powerline Toolkit"><link rel="up" href="ch01.html" title="Chapter 1. Overview"><link rel="prev" href="ch01s03.html" title="Toolkit Distribution"><link rel="next" href="ch01s05.html" title="Toolkit Installation on Mac OS X"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">
Toolkit Installation on Linux
</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><th width="60%" align="center">Chapter 1.
Overview
</th><td width="20%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr></table><hr></div><div class="section" title="Toolkit Installation on Linux"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="install-linux"></a>
Toolkit Installation on Linux
</h2></div></div></div><p>
The Linux version of the toolkit must be compiled from source code. The only requirement is the standard <span class="application">GNU/Linux</span> toolchain consisting of <span class="application">make</span>, <span class="application">gcc</span> and <span class="application">ld</span>. These are included with most <span class="application">Linux</span> distributions but may require installation. On <span class="productname">Debian</span>™ based distributions, such as <span class="productname">Ubuntu</span>™, they may be installed using <span class="application">apt-get</span>. On <span class="productname">RedHat</span>™ distributions, such as <span class="productname">Fedora</span>™, they may be installed using <span class="application">rpm</span>. On <span class="productname">SuSE</span>™ based distributions, they may be installed using <span class="application">YaST2</span>.
</p><div class="section" title="Toolkit Installation on GNU/Linux™"><div class="titlepage"><div><div><h3 class="title"><a name="idp18533192"></a>
Toolkit Installation on GNU/<span class="productname">Linux</span>™
</h3></div></div></div><div class="example"><a name="idp18533864"></a><p class="title"><b>Example 1.1.
Toolkit Installation on GNU/<span class="productname">Linux</span>™
</b></p><div class="example-contents"><pre class="screen">
# cp plc-utils-1.2.1.tar.gz /home/mydir
# cd /home/mydir
# tar -vzxf plc-utils-1.2.1.tar.gz
# cd plc-utils-1.2.1
# make
# make install
# make manuals
</pre></div></div><br class="example-break"><p>
Decompress the archive and extract the contents with the <span class="application">tar</span> utility. This will create a folder having the same basename as the archive such that one version will not over-write another. Consult the <span class="application">tar</span> man page on your system for detailed instructions. Change directory to the appropriate folder.
</p><p>
The main package folder contains a recursive <code class="filename">Makefile</code> that will compile and install all toolkit programs. If you do not want to compile and install all programs then change directory to the appropriate folder and run <span class="application">make</span> from there. To compile binary files, type <strong class="userinput"><code>make</code></strong>. To install binary files, type <strong class="userinput"><code>make install</code></strong>. To install man pages, type <strong class="userinput"><code>make manuals</code></strong>. The package does not automatically install examples, scripts, applets or man pages.
</p><p>
We recommend that you <span class="command"><strong>login</strong></span> as <code class="constant">root</code> user before installing the toolkit; otherwise, you will be prompted for the <code class="constant">root</code> password as each program or component is installed.
</p><p>
Programs are installed in folder <code class="filename">/usr/local/bin</code> and man pages are installed in folders <code class="filename">/usr/share/man/man1</code>. If these folders are not correct for your system, or if you want to install in other folders, then edit the folder names defined in the <a class="link" href="ch03s06.html" title="Cross-Compiling on GNU/Linux">make.def</a> file found in main toolkit folder or over-ride these definitions in subordinate makefiles.
</p></div><div class="section" title="Toolkit Documentation on GNU/Linux"><div class="titlepage"><div><div><h3 class="title"><a name="idp18547152"></a>
Toolkit Documentation on GNU/Linux
</h3></div></div></div><p>
Toolkit web pages are not automatically installed. To access toolkit documentation, point your browser to <a class="ulink" href="index.html" target="_top">docbook/index.html</a> and add the page to the browser bookmark or favorites list. If you are interested in how the toolkit has been implemented then do the same for page <a class="ulink" href="toolkit.html" target="_top">docbook/toolkit.html</a>. </p><p>
The method described above is only recommended if you do not plan to move or remove toolkit folders. Otherwise, you can merely copy the entire contents of the toolkit <code class="filename">docbook</code> folder to another folder of your choice and point your browser to the new file locations.
</p><pre class="screen">
cp -rv docbook/* /home/mydir/toolkit
</pre></div><div class="section" title="Toolkit Removal on GNU/Linux™"><div class="titlepage"><div><div><h3 class="title"><a name="idp18549840"></a>
Toolkit Removal on GNU/<span class="productname">Linux</span>™
</h3></div></div></div><p>
To uninstall installed programs and man pages on Linux, change to the main toolkit folder and type <strong class="userinput"><code>make uninstall</code></strong>.
</p><div class="example"><a name="idp18551128"></a><p class="title"><b>Example 1.2.
Toolkit Removal on GNU/<span class="productname">Linux</span>™
</b></p><div class="example-contents"><pre class="screen">
# cd /home/mydir/plc-utils-1.2.1
make uninstall
</pre></div></div><br class="example-break"></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch01s05.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">
Toolkit Distribution
</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">
Toolkit Installation on Mac OS X
</td></tr></table></div></body></html>
|
