source: multimedia/libdriv/nas.xml@ 512e6761

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/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-size          "1.0 MB">
  <!ENTITY nas-buildsize     "13 MB">
  <!ENTITY nas-time          "0.30 SBU">
]>

<sect1 id="nas" xreflabel="NAS-&nas-version;">
<?dbhtml filename="nas.html"?>
<title>NAS-&nas-version;</title>

<sect2>
<title>Introduction to <application><acronym>NAS</acronym></application></title>

<para>The Network Audio System is a network transparent, client/server audio
transport system. 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 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>patch -Np1 -i ../nas-&nas-version;-bison_fix-1.patch &amp;&amp; -->
<screen><userinput><command>xmkmf &amp;&amp;
make Makefiles &amp;&amp;
make includes &amp;&amp;
make depend &amp;&amp;
make &amp;&amp;
make install install.man</command></userinput></screen>

<!--
make INCROOT=/usr/include USRLIBDIR=/usr/lib \
MANPATH=/usr/share/man BINDIR=/usr/bin \
LIBDIR=/usr/lib CONFIGDIR=/usr/X11R6/lib/X11/config \
install install.man
-->
</sect2>

<sect2>
<title>Command explanations</title>

<para><command>xmkmf...</command>: These commands use the standard for 
compiling <application>X</application> based applications.</para>

<!--
<para><command>make INCROOT=...</command>: These commands install with
the <filename class="directory">/usr</filename> prefix
instead of the default <filename class="directory">/usr/X11R6</filename>
prefix.  They also install the man pages.</para>
-->

</sect2>

<sect2>
<title>Configuring <acronym>NAS</acronym></title>

<sect3><title>Configuring <application>NAS</application></title>

<!-- <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/> -->

<sect4><title>Config Files</title>
<para><filename>/etc/nas/nasd.conf</filename></para>
</sect4>

<sect4><title>Configuration Information</title>
<para>Create the <application>NAS</application> configuration file using the
following command:</para>
<screen><userinput><command>cp /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>

<para>Install the <filename>/etc/rc.d/init.d/nas</filename> init script
included in the <xref linkend="intro-important-bootscripts"/>
package.</para>

<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>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Contents</title>

<para>The <application><acronym>NAS</acronym></application> package contains 
<command>auconvert</command>, <command>auctl</command>, 
<command>audemo</command>, <command>audial</command>, 
<command>auedit</command>, <command>auinfo</command>, 
<command>aupanel</command>, <command>auplay</command>, 
<command>aurecord</command>, <command>auscope</command>, 
<command>autool</command>, <command>auwave</command>, 
<command>auphone</command>, <command>checkmail</command>, 
<command>nasd</command>, <command>issndfile</command>, 
<command>playbucket</command>, <command>soundtoh</command> and the
<filename class='libraryfile'>libaudio</filename> libraries.</para>

</sect2>

<sect2>
<title>Description</title>

<sect3><title>au{utilities}</title>
<para>The <command>au{utilities}</command> 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.</para>
</sect3>

<sect3><title>checkmail</title>
<para><command>checkmail</command> plays a sound file when the user receives 
mail.</para>
</sect3>

<sect3><title>nasd</title>
<para><command>nasd</command> is the Network Audio System server daemon.</para>
</sect3>

<sect3><title>issndfile</title>
<para><command>issndfile</command> checks if a file is in a recognized audio 
file format.</para>
</sect3>

<sect3><title>playbucket</title>
<para><command>playbucket</command> plays, or creates, the bucket 
corresponding to the specified file.</para>
</sect3>

<sect3><title>soundtoh</title>
<para><command>soundtoh</command> converts a sound file to a C language header 
file.</para>
</sect3>

</sect2>

</sect1>