doc/{mpd.conf.5,mpdconf.example}: move documentation to the manual
This commit is contained in:
Max Kellermann
parent
42af040fbd
commit
a29cc48fec
@ -151,39 +151,10 @@ This is the gain (in dB) applied to songs with ReplayGain tags.
|
||||
.B volume_normalization <yes or no>
|
||||
If yes, mpd will normalize the volume of songs as they play. The default is no.
|
||||
.TP
|
||||
.B audio_buffer_size <size in KiB>
|
||||
This specifies the size of the audio buffer in kibibytes. The default is 4096,
|
||||
large enough for nearly 12 seconds of CD-quality audio.
|
||||
.TP
|
||||
.B buffer_before_play <0-100%>
|
||||
This specifies how much of the audio buffer should be filled before playing a
|
||||
song. Try increasing this if you hear skipping when manually changing songs.
|
||||
The default is 10%, a little over 1 second of CD-quality audio with the default
|
||||
buffer size.
|
||||
.TP
|
||||
.B http_proxy_host <hostname>
|
||||
This setting is deprecated. Use the "proxy" setting in the "curl"
|
||||
input block. See MPD user manual for details.
|
||||
.TP
|
||||
.B connection_timeout <seconds>
|
||||
If a client does not send any new data in this time period, the connection is
|
||||
closed. The default is 60.
|
||||
.TP
|
||||
.B max_connections <number>
|
||||
This specifies the maximum number of clients that can be connected to mpd. The
|
||||
default is 5.
|
||||
.TP
|
||||
.B max_playlist_length <number>
|
||||
This specifies the maximum number of songs that can be in the playlist. The
|
||||
default is 16384.
|
||||
.TP
|
||||
.B max_command_list_size <size in KiB>
|
||||
This specifies the maximum size a command list can be. The default is 2048.
|
||||
.TP
|
||||
.B max_output_buffer_size <size in KiB>
|
||||
This specifies the maximum size of the output buffer to a client. The default
|
||||
is 8192.
|
||||
.TP
|
||||
.B filesystem_charset <charset>
|
||||
This specifies the character set used for the filesystem. A list of supported
|
||||
character sets can be obtained by running "iconv \-l". The default is
|
||||
|
||||
@ -373,38 +373,6 @@ input {
|
||||
#
|
||||
###############################################################################
|
||||
|
||||
|
||||
# MPD Internal Buffering ######################################################
|
||||
#
|
||||
# This setting adjusts the size of internal decoded audio buffering. Changing
|
||||
# this may have undesired effects. Don't change this if you don't know what you
|
||||
# are doing.
|
||||
#
|
||||
#audio_buffer_size "4096"
|
||||
#
|
||||
# This setting controls the percentage of the buffer which is filled before
|
||||
# beginning to play. Increasing this reduces the chance of audio file skipping,
|
||||
# at the cost of increased time prior to audio playback.
|
||||
#
|
||||
#buffer_before_play "10%"
|
||||
#
|
||||
###############################################################################
|
||||
|
||||
|
||||
# Resource Limitations ########################################################
|
||||
#
|
||||
# These settings are various limitations to prevent MPD from using too many
|
||||
# resources. Generally, these settings should be minimized to prevent security
|
||||
# risks, depending on the operating resources.
|
||||
#
|
||||
#connection_timeout "60"
|
||||
#max_connections "10"
|
||||
#max_playlist_length "16384"
|
||||
#max_command_list_size "2048"
|
||||
#max_output_buffer_size "8192"
|
||||
#
|
||||
###############################################################################
|
||||
|
||||
# Character Encoding ##########################################################
|
||||
#
|
||||
# If file or directory names do not display correctly for your locale then you
|
||||
|
||||
131
doc/user.xml
131
doc/user.xml
@ -914,6 +914,137 @@ systemctl start mpd.socket</programlisting>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Resource Limitations</title>
|
||||
|
||||
<para>
|
||||
These settings are various limitations to prevent
|
||||
<application>MPD</application> from using too many
|
||||
resources (denial of service).
|
||||
</para>
|
||||
|
||||
<informaltable>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Setting</entry>
|
||||
<entry>Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>connection_timeout</varname>
|
||||
<parameter>SECONDS</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
If a client does not send any new data in this time
|
||||
period, the connection is closed. Clients waiting
|
||||
in "idle" mode are excluded from this. Default is
|
||||
<parameter>60</parameter>.
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>max_connections</varname>
|
||||
<parameter>NUMBER</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
This specifies the maximum number of clients that
|
||||
can be connected to <application>MPD</application>
|
||||
at the same time. Default is
|
||||
<parameter>5</parameter>.
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>max_playlist_length</varname>
|
||||
<parameter>NUMBER</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
The maximum number of songs that can be in the
|
||||
playlist. Default is <parameter>16384</parameter>.
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>max_command_list_size</varname>
|
||||
<parameter>KBYTES</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
The maximum size a command list. Default is
|
||||
<parameter>2048</parameter> (2 MiB).
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>max_output_buffer_size</varname>
|
||||
<parameter>KBYTES</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
The maximum size of the output buffer to a client
|
||||
(maximum response size). Default is
|
||||
<parameter>8192</parameter> (8 MiB).
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</section>
|
||||
|
||||
<section>
|
||||
<title>Buffer Settings</title>
|
||||
|
||||
<para>
|
||||
Do not change these unless you know what you are doing.
|
||||
</para>
|
||||
|
||||
<informaltable>
|
||||
<tgroup cols="2">
|
||||
<thead>
|
||||
<row>
|
||||
<entry>Setting</entry>
|
||||
<entry>Description</entry>
|
||||
</row>
|
||||
</thead>
|
||||
<tbody>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>audio_buffer_size</varname>
|
||||
<parameter>KBYTES</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
Adjust the size of the internal audio buffer.
|
||||
Default is <parameter>4096</parameter> (4 MiB).
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
<row>
|
||||
<entry>
|
||||
<varname>buffer_before_play</varname>
|
||||
<parameter>PERCENT</parameter>
|
||||
</entry>
|
||||
<entry>
|
||||
Control the percentage of the buffer which is filled
|
||||
before beginning to play. Increasing this reduces
|
||||
the chance of audio file skipping, at the cost of
|
||||
increased time prior to audio playback. Default is
|
||||
<parameter>10%</parameter>.
|
||||
</entry>
|
||||
</row>
|
||||
|
||||
</tbody>
|
||||
</tgroup>
|
||||
</informaltable>
|
||||
</section>
|
||||
</section>
|
||||
</chapter>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user