embedaddon/mpd/doc/mpd10.html - view

File: [ELWIX - Embedded LightWeight unIX -] / embedaddon / mpd / doc / mpd10.html
Revision 1.1: download - view: text, annotated - select for diffs - revision graph
Tue Feb 21 23:32:47 2012 UTC (12 years, 10 months ago) by misho
CVS tags: MAIN, HEAD

Initial revision

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <HTML> <HEAD> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> <TITLE>Invoking mpd</TITLE> </HEAD> <BODY text="#000000" bgcolor="#ffffff"> <A HREF="mpd.html">Mpd 5.6 User Manual</A> : <A HREF="mpd9.html">Running Mpd</A> : Invoking mpd  Previous: <A HREF="mpd9.html">Running Mpd</A>  Next: <A HREF="mpd11.html">Configuration file format</A> <HR NOSHADE> <H2><A NAME="10"></A>3.1. Invoking mpd<A NAME="invoke"></A></H2> Mpd is invoked by first setting up your configuration files, and then running <blockquote><code> <code>mpd [ options ] [ configuration ] </code> </code></blockquote> On startup mpd run commands from the <code>startup</code> label. Aftre that, if <code>configuration</code> is supplied, mpd looks in <code>mpd.conf</code> for a matching label, and runs the corresponding commands. If <code>configuration</code> is not supplied, mpd looks for the configuration named <code>default</code>. Mpd can either be run in interactive mode or in the background as a daemon. In interactive mode mpd accepts commands typed at the console. Mpd understands the following command line options. Each option has a short, single character form, as well as an equivalent long form.  <dl> <dt><code>-b --background</code><dd>Run as a background daemon. <dt><code>-d --directory dir</code><dd>This option allows you to specify a different directory for the mpd configuration files other than the default <code>/usr/local/etc/mpd</code>. <dt><code>-f --file filename</code><dd>Specify an initial configuration file other than the default, <code>mpd.conf</code>. <dt><code>-o --one-shot</code><dd>This option forces mpd terminate itself after the last link disappear. Link templates are not counted as links. <dt><code>-p --pidfile filename</code><dd>Mpd will open and lock <code>filename</code> and write its process ID before starting. If another mpd process is already running, mpd will not start. The default is <code>/var/run/mpd.pid</code>. <dt><code>-k --kill</code><dd>With this option, pd will attempt to kill any existing mpd process before beginning execution. The previous process must have written its process ID in the PID file <code>/var/run/mpd.pid</code> (or the file you specify with the <code>--pidfile</code> option). <dt><code>-s --syslog-ident ident</code><dd>Mpd normally logs via <code>syslog(3)</code> with the identifier <code>mpd</code>. This option allows you to change that identifier. <dt><code>-v --version</code><dd>Displays the version number of mpd and exits. <dt><code>-h --help</code><dd>Displays a usage message and exits. </dl>  Mpd responds to the following signals while it is running:  <dl> <dt>SIGTERM<dd>Attempt to gracefully shut down all active connections and exit. <dt>SIGUSR1<dd>This signal causes mpd to initiate a connection with the first link. If mpd is already attempting to connect, this signal has no effect. <dt>SIGUSR2<dd>This signal has the opposite effect, namely, it causes mpd to close the first link. If the link is already in a closed state, this signal has no effect. </dl>  <HR NOSHADE> <A HREF="mpd.html">Mpd 5.6 User Manual</A> : <A HREF="mpd9.html">Running Mpd</A> : Invoking mpd  Previous: <A HREF="mpd9.html">Running Mpd</A>  Next: <A HREF="mpd11.html">Configuration file format</A> </BODY> </HTML>