summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMax Kellermann <max@duempel.org>2008-12-20 17:37:12 +0100
committerMax Kellermann <max@duempel.org>2008-12-20 17:37:12 +0100
commita6e981c08d8f37e86bb6040d23486fd18b05d111 (patch)
tree0bc6b117cb1fdba3616a51cab9840ed4268499cc /doc
parentbfaaf425c2989ac4d04303d220a51e9e173084d3 (diff)
doc: clarify "user" setting (starting as root / unprivileged)
The "user" option does not work if MPD is started by an unprivileged user.
Diffstat (limited to 'doc')
-rw-r--r--doc/mpd.conf.55
-rw-r--r--doc/mpdconf.example8
2 files changed, 8 insertions, 5 deletions
diff --git a/doc/mpd.conf.5 b/doc/mpd.conf.5
index 31b105c8d..ff24fd82a 100644
--- a/doc/mpd.conf.5
+++ b/doc/mpd.conf.5
@@ -66,7 +66,10 @@ the "kill" command. When mpd is restarted, it will read the state file and
restore the state of mpd (including the playlist).
.TP
.B user <username>
-This specifies the user that mpd will run as, if set.
+This specifies the user that MPD will run as, if set. MPD should
+never run as root, and you may use this option to make MPD change its
+user id after initialization. Do not use this option if you start MPD
+as an unprivileged user.
.TP
.B bind_to_address <ip address or hostname or any>
This specifies which address mpd binds to and listens on. Multiple
diff --git a/doc/mpdconf.example b/doc/mpdconf.example
index 83109383e..83eb0ab16 100644
--- a/doc/mpdconf.example
+++ b/doc/mpdconf.example
@@ -30,10 +30,10 @@ error_file "~/.mpd/mpd.error"
######################## DAEMON OPTIONS ########################
#
-# If started as root, MPD will drop root privileges and run as
-# this user instead. Otherwise, MPD will run as the user it was
-# started by. If left unspecified, MPD will not drop root
-# privileges at all (not recommended).
+# This specifies the user that MPD will run as, if set. MPD should
+# never run as root, and you may use this option to make MPD change
+# its user id after initialization. Do not use this option if you
+# start MPD as an unprivileged user.
#
#user "nobody"
#