glfs/multimedia/libdriv/nas.xml
Randy McMurchy 2bd903be5b Updated to NAS-1.7
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3762 af4574ff-66df-0310-9fd7-8a98e5e911e0
2005-04-19 21:05:51 +00:00

207 lines
6.8 KiB
XML

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY nas-download-http "http://nas.codebrilliance.com/nas/nas-&nas-version;.src.tar.gz">
<!ENTITY nas-download-ftp "ftp://ftp.us.xemacs.org/pub/xemacs/aux/nas-&nas-version;.src.tar.gz">
<!ENTITY nas-md5sum "c9918e9c9c95d587a95b455bbabe3b49">
<!ENTITY nas-size "1.2 MB">
<!ENTITY nas-buildsize "17.1 MB">
<!ENTITY nas-time "0.31 SBU">
]>
<sect1 id="nas" xreflabel="NAS-&nas-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="nas.html"?>
<title>NAS-&nas-version;</title>
<indexterm zone="nas">
<primary sortas="a-NAS">NAS</primary></indexterm>
<sect2>
<title>Introduction to <application><acronym>NAS</acronym></application></title>
<para>The Network Audio System is a network transparent, client/server audio
transport system used to read , write and play audio files in many formats
including <filename>.au</filename>, <filename>.snd</filename>,
<filename>.voc</filename>, <filename>.wav</filename>,
<filename>.aiff</filename>, <filename>.aif</filename> and
<filename>.iff</filename>. It can be described as the audio equivalent of an
<application>X</application> server.</para>
<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP):
<ulink url="&nas-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&nas-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &nas-md5sum;</para></listitem>
<listitem><para>Download size: &nas-size;</para></listitem>
<listitem><para>Estimated disk space required:
&nas-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&nas-time;</para></listitem></itemizedlist>
</sect3>
<!-- <sect3><title>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/nas-&nas-version;-bison_fix-1.patch"/></para></listitem>
</itemizedlist></sect3> -->
<sect3><title><application>NAS</application> dependencies</title>
<sect4><title>Required</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>
</sect2>
<sect2>
<title>Installation of <application><acronym>NAS</acronym></application></title>
<para>Install <application><acronym>NAS</acronym></application> by running the
following commands:</para>
<screen><userinput><command>xmkmf &amp;&amp;
make World</command></userinput></screen>
<para>Now, as the root user:</para>
<screen><userinput role='root'><command>make install install.man</command></userinput></screen>
</sect2>
<sect2>
<title>Command explanations</title>
<para><command>xmkmf</command>; <command>make World</command>: These commands
use the standard for compiling <application>X</application> based
applications.</para>
</sect2>
<sect2>
<title>Configuring <acronym>NAS</acronym></title>
<sect3 id="nas-config"><title>Config files</title>
<para><filename>/etc/nas/nasd.conf</filename></para>
<indexterm zone="nas nas-config">
<primary sortas="e-etc-nas-nasd.conf">/etc/nas/nasd.conf</primary></indexterm>
</sect3>
<sect3><title>Configuration information</title>
<para>Create the <application>NAS</application> configuration file using the
following command:</para>
<screen><userinput><command>install -v -m644 /etc/nas/nasd.conf.eg /etc/nas/nasd.conf</command></userinput></screen>
<para>Edit the new configuration file to suit your network and system
needs.</para>
</sect3>
<sect3 id="nas-init"><title>Boot script</title>
<para>Install the <filename>/etc/rc.d/init.d/nas</filename> init script
included in the <xref linkend="intro-important-bootscripts"/>
package.</para>
<indexterm zone="nas nas-init">
<primary sortas="f-nas">nas</primary></indexterm>
<screen><userinput><command>make install-nas</command></userinput></screen>
<para>The init script uses a default parameter to allow access to all hosts on
the network. Review the <command>nasd</command> man page for other available
parameters if you need to modify the script.</para>
</sect3>
</sect2>
<sect2>
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>auconvert, auctl, audemo, audial, auedit, auinfo, aupanel, auphone,
auplay, aurecord, auscope, autool, auwave, checkmail, issndfile, nasd,
playbucket and soundtoh</seg>
<seg>libaudio.[so,a]</seg>
<seg>/etc/nas and /usr/X11R6/include/audio</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<varlistentry id="au-utilities">
<term><command>au[utilities]</command></term>
<listitem><para>are a collection of tools to convert, play, edit, record,
and manipulate sound files. See the respective man page for each utility
for a full description of each one.</para>
<indexterm zone="nas au-utilities">
<primary sortas="b-au-utilities">au[utilities]</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="checkmail">
<term><command>checkmail</command></term>
<listitem><para>plays a sound file when the user receives mail.</para>
<indexterm zone="nas checkmail">
<primary sortas="b-checkmail">checkmail</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="issndfile">
<term><command>issndfile</command></term>
<listitem><para>checks if a file is in a recognized audio file format.</para>
<indexterm zone="nas issndfile">
<primary sortas="b-issndfile">issndfile</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="nasd">
<term><command>nasd</command></term>
<listitem><para>is the Network Audio System server daemon.</para>
<indexterm zone="nas nasd">
<primary sortas="b-nasd">nasd</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="playbucket">
<term><command>playbucket</command></term>
<listitem><para>plays, or creates, the bucket corresponding to the
specified file.</para>
<indexterm zone="nas playbucket">
<primary sortas="b-playbucket">playbucket</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="soundtoh">
<term><command>soundtoh</command></term>
<listitem><para>converts a sound file to a C language header file.</para>
<indexterm zone="nas soundtoh">
<primary sortas="b-soundtoh">soundtoh</primary>
</indexterm></listitem>
</varlistentry>
<varlistentry id="libaudio">
<term><filename class='libraryfile'>libaudio.[so,a]</filename></term>
<listitem><para>contains API functions to read and write audio files.</para>
<indexterm zone="nas libaudio">
<primary sortas="c-libaudio">libaudio.[so,a]</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>