diff options
| author | Max Kellermann <max@duempel.org> | 2015-10-27 11:05:47 +0100 |
|---|---|---|
| committer | Max Kellermann <max@duempel.org> | 2015-10-27 11:05:47 +0100 |
| commit | 94f850a5885c89e5255948f9274aaaa4197bc52b (patch) | |
| tree | 5348c92cb0ed9a3dc409be922abac07eee4438de /doc | |
| parent | 3882c114505ea39e3707f27d91eb8ef363a8895b (diff) | |
| parent | db9997a1068e00c5f78d4bb9834ce5a13e7b7a3b (diff) | |
| download | mpd-94f850a5885c89e5255948f9274aaaa4197bc52b.tar.gz mpd-94f850a5885c89e5255948f9274aaaa4197bc52b.tar.xz mpd-94f850a5885c89e5255948f9274aaaa4197bc52b.zip | |
Merge tag 'v0.19.11'
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/user.xml | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/doc/user.xml b/doc/user.xml index f66f6e397..e30b667ca 100644 --- a/doc/user.xml +++ b/doc/user.xml @@ -1025,6 +1025,58 @@ database { plugin). </para> </section> + + <section id="realtime"> + <title>Real-Time Scheduling</title> + + <para> + On Linux, <application>MPD</application> attempts to configure + <ulink + url="https://en.wikipedia.org/wiki/Real-time_computing">real-time + scheduling</ulink> for some threads that benefit from it. + </para> + + <para> + This is only possible you allow <application>MPD</application> + to do it. This privilege is controlled by + <varname>RLIMIT_RTPRIO</varname> + <varname>RLIMIT_RTTIME</varname>. You can configure this + privilege with <command>ulimit</command> before launching + <application>MPD</application>: + </para> + + <programlisting>ulimit -HS -r 50; mpd</programlisting> + + <para> + Or you can use the <command>prlimit</command> program from the + <application>util-linux</application> package: + </para> + + <programlisting>prlimit --rtprio=50 --rttime=unlimited mpd</programlisting> + + <para> + The <application>systemd</application> service file shipped + with <application>MPD</application> comes with this setting. + </para> + + <para> + This works only if the Linux kernel was compiled with + <varname>CONFIG_RT_GROUP_SCHED</varname> disabled. Use the + following command to check this option for your current + kernel: + </para> + + <programlisting>zgrep ^CONFIG_RT_GROUP_SCHED /proc/config.gz</programlisting> + + <note> + <para> + There is a rumor that real-time scheduling improves audio + quality. That is not true. All it does is reduce the + probability of skipping (audio buffer xruns) when the + computer is under heavy load. + </para> + </note> + </section> </chapter> <chapter id="use"> |