install.sgml

Intercom 是一个 Unix系统上灵活的语音传输软件。支持标准音频压缩比如GSM, G.711, and G.72x和其他音频编码。Intercom专为高速网络设计来传输高品质的语音

<!-- $Id: install.sgml,v 1.1 2002/03/10 10:17:07 shane Exp $ -->

<chapter id="install">
<title>Installing Intercom</title>

<section id="install-requirements">
<title>System Requirements</title>
<para>Intercom currently has the following requirements of the hardware and
software on which it is installed.</para>
<itemizedlist>
<listitem><para>ANSI C compiler with appropriate libraries.
</para></listitem>
<listitem><para>Unix-like system such as Linux or BSD which supports the
<ulink url="http://www.opensound.com">Open Sound System</ulink> sound
API.</para></listitem>
<listitem><para>Full-duplex audio interface hardware supported by
<ulink url="http://www.opensound.com">OSS</ulink>.</para></listitem>
</itemizedlist>
<para>Intercom can also use the following optional components if they are
installed.  In most cases, these components will be automatically detected
at compile-time.</para>
<itemizedlist>
<listitem><para>GNU ReadLine library (if advanced line-input functions are
desired).</para></listitem>
<listitem><para><ulink url="http://www.openssl.org">
OpenSSL library</ulink> (if encryption support is
desired).</para></listitem>
<listitem><para>libGSM library (If GSM compression is desired).  This library
comes bundled with Intercom in any case.</para></listitem>
</itemizedlist>

</section>

<section id="install-obtaining">
<title>Obtaining Intercom</title>

<para>There are several methods of obtaining Intercom.  The latest version
can always be found at the
<ulink url="http://www.cm.nu/~shane/intercom/">Intercom website</ulink>. 
Alternatively, there is a SourceForge project site at
<ulink url="http://www.sourceforge.net/projects/intercom/">
www.sourceforge.net/projects/intercom/</ulink> which should also contain
the latest sources.</para>

<para>Earlier versions of Intercom as well as CVS snapshots can be obtained
from
<ulink url="ftp://ftp.cm.nu/pub/intercom/">ftp://ftp.cm.nu/pub/intercom/</ulink>.
</para>

<section id="intro-obtaining-cvs">
<title>Anonymous CVS Access</title>
<para>A CVS repository is also available for those interested in testing and
working on Intercom.  To access the repository, execute the following
commands from a shell.</para>
<para><command>cvs -d:pserver:[e-mail]:/var/cvs login</command></para>
<para>When prompted for a password, enter "anoncvs".</para>
<para><command>cvs -d:pserver:[e-mail]:/var/cvs co intercom</command></para>
<para>This will create an intercom directory inside your working directory
holding the latest development version of Intercom.</para>

</section>
</section>

<section id="install-quick">
<title>Quick Installation</title>

<para>If you are impatient and wish to get Intercom up and running right
away, go ahead and perform these steps.  However, it is highly recommended
that you read the following sections at some point.

<section id="install-quick-system">
<title>Installing System-Wide</title>

<para>In order to install Intercom system-wide such that anyone can use it,
enter the following commands from a Unix shell.</para>
<para><prompt>$ </prompt>
<command>tar -zxf intercom-&version;.tar.gz</command></para>
<para><prompt>$ </prompt>
<command>cd intercom-&version;</command></para>
<para><prompt>$ </prompt>
<command>./configure</command></para>
<para><prompt>$ </prompt>
<command>make</command></para>
<para><prompt>$ </prompt>
<command>su root -c make install</command></para>

</section>

<section id="install-quick-home">
<title>Installing into a Home Directory</title>

<para>If you would like to install Intercom into your home directory,
execute the following sequence of commands from a Unix shell.</para>
<para><prompt>$ </prompt>
<command>tar -zxf intercom-&version;.tar.gz</command></para>
<para><prompt>$ </prompt>
<command>cd intercom-&version;</command></para>
<para><prompt>$ </prompt>
<command>./configure --prefix=$HOME</command></para>
<para><prompt>$ </prompt>
<command>make</command></para>
<para><prompt>$ </prompt>
<command>make install</command></para>

</section>

</section>

<section id="install-detail">
<title>Detailed Installation Instructions</title>
<para>Intercom uses the GNU AutoConf suite of utilities to compile and
install the source.  If you are familiar with GNU AutoConf, you should have
no trouble.  If not, you may wish to read the <filename>INSTALL</filename>
contained in the base directory of the source distribution.</para>
<section id="install-detail-unpack">
<title>Unpack the Source</title>
<para>When you download Intercom, you will have a .tar.gz file.  It has a
name similar to <filename>intercom-&version;.tar.gz</filename>.  The first
thing you need do is unpack the file.  If you have a relatively modern Unix
system, the command
<command>tar -zxf
<replaceable>intercom-&version;.tar.gz</replaceable></command>
should unpack the source.  The unpack process will create a directory named
something similar to
<filename><replaceable>intercom-&version;</replaceable></filename>.
Change to that directory by entering
<command>cd
<filename><replaceable>intercom-&version;</replaceable></filename></command>
and continue to the following section.</para>

</section>

<section id="install-detail-configure">
<title>Configuring the Source</title>

<para>After unpacking the source distribution, you must configure the source
for your particular system.  This is done with the command
<command>./configure</command>.  Simply executing
<command>./configure</command> is often sufficient and will examine your
system and configure the source appropriately.  However, configure does have
options which modify its behavior.  One of the most important of these is the
--help switch which prints a list of valid configure options.  Running
<command>./configure --help</command> will print this usage summary.</para>

<para>One option which many people like to change is where Intercom gets
installed.  By default, this is /usr/local.  Binaries are placed in
/usr/local/bin, man pages in /usr/local/man etc.  To change this option,
simply execute ./configure with the --prefix option.  For example, to
install Intercom into your HOME directory, enter
<command>./configure --prefix=$HOME</command>.</para>

<section id="install-detail-configure-optimize">
<title>Optimizing the Source</title>

<para>Some tasks which Intercom must perform can be quite resource
intensive, especially on older hardware.  If you encounter problems like
recording overruns, you may wish to use these methods to optimize your build
of Intercom.</para>

<para>There are two options which can be passed to configure to control how
Intercom is optimized.  The first, is the
--with-cpu=<replaceable>type</replaceable>.  This tells the compiler that
Intercom is being compiled for the specified CPU type.  The resulting binary
should not be executed on any other CPU platform except that for which it
was compiled.  For a list of valid CPU types, consult your compiler
documentation.  Some examples of valid CPU types are i386, i486, i586
(pentium), and i686 (pentiumpro).  For example, for a version of Intercom
optimized for Pentium class systems, you would enter
<command>./configure --with-cpu=i586</command>.</para>
<note><para><emphasis>Warning:</emphasis>
The --with-cpu option is only known to work with the GNU C compiler (GCC). 
Further, the available CPU types vary depending on the version of gcc being
used.  Consult your documentation for details.</para></note>

<para>The other swich controling optimization is --enable-optimize.  This
switch enables compiler optimizations specific to your compiler version and
CPU type if the --with-cpu option is used.  <emphasis>Warning:</emphasis>
This option enables certain experimental compiler optimizations, it is
recommended that this option only be used if absolutely necessary.</para>

</section>

</section>

<section id="install-detail-compile">
<title>Compiling the Source</title>

<para>Once you have configured the source, it needs to be compiled into
binary form.  To do this, simply execute the <command>make</command>
command.  If the make completes without error, you are ready to install the
program.</para>

</section>

<section id="install-detail-install">
<title>Installing the package</title>

<para>The final step is to install Intercom on your system.  If you chose to
install Intercom in the default location (/usr/local), then you will most
likely need to become the root user.  Once you are in a position where you
have write access to the installation path, simply type <command>make
install</command>.  Intercom will be installed onto the system and you are
ready to go.</para>

</section>

</section>

</chapter>