icecast2_yp.html 2.07 KB
Newer Older
j's avatar
j committed
1 2 3 4 5 6 7 8 9
<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
<head>
<title>Icecast v2.0 Documentation</title>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<body>
<div class="boxtest">
10
<h1>Icecast 2 YP Directories</h1>
j's avatar
j committed
11
<hr id='titlebar' />
j's avatar
j committed
12 13 14
<br />
<br />
<br />
15 16 17
<h2>Overview</h2>
<p>A YP (Yellow Pages) directory is a listing of broadcast streams.  Icecast2 has it own YP directory located at http://dir.xiph.org.  Currently icecast2 can only be listed in an icecast2-supported YP directory.  This means that you cannot list your stream in the Shoutcast YP directory.</p>
<p>In the icecast2 configuration file are all the currently available YP directory servers.  Listing your stream in a YP is a combination of settings in the icecast configuration file and also in your source client.</p>
j's avatar
j committed
18 19 20
<br />
<br />
<br />
vanguardist's avatar
vanguardist committed
21
<h2>Configuring icecast2 for YP Support</h2>
22
<p>First of all, icecast must have been built with YP support.  This is automatically done if you have libcurl installed.  If libcurl is not detected when icecats is compiled, then YP support is disabled.</p>
vanguardist's avatar
vanguardist committed
23
<p>If icecast has been built with YP support, then the following configuration options control the YP directory settings:</p>
24 25
<pre>
    &lt;directory&gt;
Karl Heyes's avatar
Karl Heyes committed
26 27 28
        &lt;yp-url-timeout&gt;15&lt;/yp-url-timeout&gt;
        &lt;yp-url&gt;http://dir.xiph.org/cgi-bin/yp-cgi&lt;/yp-url&gt;
    &lt;/directory&gt;
29 30
</pre>
<p>Multiple directory XML chunks can be specified in order to be listed in multiple directories.</p>
j's avatar
j committed
31 32 33
<br />
<br />
<br />
vanguardist's avatar
vanguardist committed
34
<h2>Configuring Your Source Client for YP Support</h2>
35 36
<p>This is usually covered in the source client documentation.  More specifically, the source client needs to provide the HTTP header ice-public:1 on connect in order to enable YP listing of the stream.</p>
<p>If a mountpoint is being listed on a YP, then you will see some additional statistics relating to the YP such as last-touch, currently-playing, etc.</p>
j's avatar
j committed
37 38 39
<br />
<br />
<br />
40 41 42
</div>
</body>
</html>