1
0
mirror of https://gitlab.xiph.org/xiph/icecast-server.git synced 2024-09-22 04:15:54 -04:00

Updated docs: logging to STDERR; known issues

svn path=/icecast/trunk/icecast/; revision=19124
This commit is contained in:
Thomas B. "dm8tbr" Ruecker 2014-05-04 15:07:38 +00:00
parent db99c66aa0
commit e812c46322

View File

@ -36,6 +36,7 @@ Please note that, especially for new Icecast users, editing the config file can
<p>
Should you need to customize the configuration, then make a backup of your working config file, before you make any changes. If Icecast refuses to start it is in most cases due to a malformed config file. In such a case running the following command should point out most XML syntax problems.
<pre>xmllint icecast.xml</pre>
A known limitation of Icecast 2.4.0 is that it will segfault on empty XML tags, so please don't use them (e.g. &lt;webroot&gt;&lt;/webroot&gt;).<br />
Also check the Icecast error.log for additional hints.
</p>
<p>
@ -721,10 +722,12 @@ Aliases are used to provide a way to create multiple mountpoints that refer to t
&lt;loglevel&gt;4&lt;/loglevel&gt; &lt;!-- 4 Debug, 3 Info, 2 Warn, 1 Error --&gt;
&lt;/logging&gt;
</pre>
<p>This section contains information relating to logging within icecast. There are two logfiles currently generated by icecast, an error.log (where all log messages are placed) and an access.log (where all stream/admin/http requests are logged).
<p>This section contains information relating to logging within icecast. There are three logfiles currently generated by icecast, an error.log (where all log messages are placed), an access.log (where all stream/admin/http requests are logged) and an optional playlist.log.
</p>
<p>Note that on non-win32 platforms, a HUP signal can be sent to icecast in which the log files are re-opened for appending giving the ability move/remove the log files.
</p>
<p>If you set any of the filenames to a simple dash (e.g. &lt;accesslog&gt;-&lt;/accesslog&gt;) then Icecast will direct the log output to STDERR instead of a file.
</p>
<h4>accesslog</h4>
<div class="indentedbox">
Into this file, all requests made to the icecast2 will be logged. This file is relative to the path specified by the &lt;logdir&gt; config value.