From a6e981c08d8f37e86bb6040d23486fd18b05d111 Mon Sep 17 00:00:00 2001 From: Max Kellermann Date: Sat, 20 Dec 2008 17:37:12 +0100 Subject: [PATCH] doc: clarify "user" setting (starting as root / unprivileged) The "user" option does not work if MPD is started by an unprivileged user. --- doc/mpd.conf.5 | 5 ++++- doc/mpdconf.example | 8 ++++---- 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 -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 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" #