source: multimedia/libdriv/nas.xml@ 2bd903b

<!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>