This commit is contained in:
gferg 2003-04-28 14:59:07 +00:00
parent c86560a681
commit 8779d73495
2 changed files with 2755 additions and 0 deletions

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,69 @@
<chapter id="sap"><title id="tsap">Add a channel information service</title>
<para>Typing multicast addresses is not very fun... that's why you need
a channel information service ! VideoLAN has implemented a channel
information service based on the SAP/SDP standard. The mini-SAP-server
sends announces about the multicast programs on the network (via the
multicast address <emphasis>224.2.127.254</emphasis> reserved for this
purpose), and VLCs receive these annouces and automatically add the
programs announced to their playlist.</para>
<sect1><title>Install and configure the mini-SAP-server</title>
<note><para>The mini-SAP-server is only available for Linux.</para></note>
<para>Download the latest version of the mini-SAP-server from the <ulink
url="http://www.videolan.org/streaming/">streaming download
page</ulink>.</para>
<para>Install-it:</para>
<screen>
<prompt>% </prompt><userinput>tar xvzf miniSAPserver-version.tar.gz</userinput>
<prompt>% </prompt><userinput>cd miniSAPserver-version</userinput>
<prompt>% </prompt><userinput>make</userinput>
</screen>
<para>Edit the configuration file <filename>sap.cfg</filename> shipped
with the tarball. It should contain a global section with the Time To
Live of the SAP announces and a section per program announced. Use the
comments to understand each parameter.</para>
<para>The Time To Live option indicates the maximum number of routers
that the SAP announce packets can cross before being dropped.</para>
</sect1>
<sect1><title>Run the mini-SAP-server</title>
<para>Start the mini-SAP-server :</para>
<screen>
<prompt>% </prompt><userinput>./sapserver -c sap.cfg</userinput>
</screen>
<para>If you want to run the mini-SAP-server in the background, use the
<command>-d</command> command line switch. For instance:</para>
<screen>
<prompt>% </prompt><userinput>./sapserver -d -c sap.cfg</userinput>
</screen>
<para>You can also omit the <command>-c</command> command line switch if
your config file is <filename>/etc/sap.cfg</filename>.</para>
</sect1>
<sect1><title>Configure VLC(s) to listen to the SAP announces</title>
<para>Start VLC with the following command line:</para>
<screen>
<prompt>% </prompt><userinput>vlc --extraintf sap</userinput>
</screen>
<para>Then open the playlist : you should see the programs announced.
When you double-click on the name of a program, VLC will subscribe to
the multicast address and start to play the stream !</para>
</sect1>