doc: clarify "user" setting (starting as root / unprivileged)

The "user" option does not work if MPD is started by an unprivileged user.

doc: clarify "user" setting (starting as root / unprivileged)
a6e981c0 · Max Kellermann · bfaaf425 · a6e981c0 · a6e981c0
Commit a6e981c0 authored Dec 20, 2008 by Max Kellermann
Show whitespace changes
Inline Side-by-side

Showing with 8 additions and 5 deletions

mpd.conf.5 doc/mpd.conf.5 +4 -1

mpdconf.example doc/mpdconf.example +4 -4

No files found.
--- 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

--- 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 specifies the user that MPD will run as, if set.  MPD should
-# this user instead.  Otherwise, MPD will run as the user it was
+# never run as root, and you may use this option to make MPD change
-# started by.  If left unspecified, MPD will not drop root
+# its user id after initialization.  Do not use this option if you
-# privileges at all (not recommended).
+# start MPD as an unprivileged user.
 #
 #user                            "nobody"
 #