icecast-server/doc/icecast2_yp.html

<?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.x Documentation</title>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<body>
<div class="boxtest">
<h1>Icecast 2 YP Directories</h1>
<hr id='titlebar' />
<br />
<br />
<br />
<h2>Overview</h2>
<p>A YP (Yellow Pages) directory is a listing of broadcast streams.  Icecast2 has it own YP directory located at <a href="http://dir.xiph.org">http://dir.xiph.org</a>.  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>
<br />
<br />
<br />
<h2>Configuring icecast2 for YP Support</h2>
<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>
<p>If icecast has been built with YP support, then the following configuration options control the YP directory settings:</p>
<pre>
    &lt;directory&gt;
        &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;
</pre>
<p>Multiple directory XML chunks can be specified in order to be listed in multiple directories.</p>
<br />
<br />
<br />
<h2>Configuring Your Source Client for YP Support</h2>
<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.<br />
This can however be overridden in mount point settings, refer to the config file documentation for further details.</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>
<br />
<br />
<br />
</div>
</body>
</html>
- convert icecast documentation to xhtml - clean up html code - sync index.html with README svn path=/icecast/trunk/icecast/; revision=7786 2004-09-18 10:31:39 -04:00			`<?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>`
Make HTML title non-version specific.. Add a new "changes" page which enumerates major feature/fixes for each version.. We are starting with 2.3. svn path=/icecast/trunk/icecast/; revision=9762 2005-08-16 22:40:29 -04:00			`<title>Icecast v2.x Documentation</title>`
- convert icecast documentation to xhtml - clean up html code - sync index.html with README svn path=/icecast/trunk/icecast/; revision=7786 2004-09-18 10:31:39 -04:00			`<link rel="stylesheet" type="text/css" href="style.css" />`
			`</head>`
			`<body>`
			`<div class="boxtest">`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`<h1>Icecast 2 YP Directories</h1>`
replace table with hr+css svn path=/icecast/trunk/icecast/; revision=7791 2004-09-18 16:14:50 -04:00			`<hr id='titlebar' />`
- convert icecast documentation to xhtml - clean up html code - sync index.html with README svn path=/icecast/trunk/icecast/; revision=7786 2004-09-18 10:31:39 -04:00			`<br />`
			`<br />`
			`<br />`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`<h2>Overview</h2>`
Updated YP documentation svn path=/icecast/trunk/icecast/; revision=19130 2014-05-04 12:57:39 -04:00			`<p>A YP (Yellow Pages) directory is a listing of broadcast streams. Icecast2 has it own YP directory located at <a href="http://dir.xiph.org">http://dir.xiph.org</a>. 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>`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`<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>`
- convert icecast documentation to xhtml - clean up html code - sync index.html with README svn path=/icecast/trunk/icecast/; revision=7786 2004-09-18 10:31:39 -04:00			`<br />`
			`<br />`
			`<br />`
going and going... svn path=/trunk/icecast/; revision=5608 2003-11-18 12:43:05 -05:00			`<h2>Configuring icecast2 for YP Support</h2>`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`<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>`
going and going... svn path=/trunk/icecast/; revision=5608 2003-11-18 12:43:05 -05:00			`<p>If icecast has been built with YP support, then the following configuration options control the YP directory settings:</p>`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`<pre>`
			`<directory>`
small fixes svn path=/icecast/trunk/icecast/; revision=8596 2005-01-03 12:48:54 -05:00			`<yp-url-timeout>15</yp-url-timeout>`
			`<yp-url>http://dir.xiph.org/cgi-bin/yp-cgi</yp-url>`
			`</directory>`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`</pre>`
			`<p>Multiple directory XML chunks can be specified in order to be listed in multiple directories.</p>`
- convert icecast documentation to xhtml - clean up html code - sync index.html with README svn path=/icecast/trunk/icecast/; revision=7786 2004-09-18 10:31:39 -04:00			`<br />`
			`<br />`
			`<br />`
going and going... svn path=/trunk/icecast/; revision=5608 2003-11-18 12:43:05 -05:00			`<h2>Configuring Your Source Client for YP Support</h2>`
Updated YP documentation svn path=/icecast/trunk/icecast/; revision=19130 2014-05-04 12:57:39 -04:00			`<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.<br />`
			`This can however be overridden in mount point settings, refer to the config file documentation for further details.</p>`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`<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>`
- convert icecast documentation to xhtml - clean up html code - sync index.html with README svn path=/icecast/trunk/icecast/; revision=7786 2004-09-18 10:31:39 -04:00			`<br />`
			`<br />`
			`<br />`
icecast2 documentation. need I say more ? svn path=/trunk/icecast/; revision=5569 2003-11-12 22:50:30 -05:00			`</div>`
			`</body>`
			`</html>`