Annotation of embedaddon/mpd/doc/mpd10.html, revision 1.1.1.4

1.1       misho       1: <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
                      2: <HTML>
                      3: <HEAD>
                      4: <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
                      5: <TITLE>Invoking mpd</TITLE>
                      6: </HEAD>
                      7: <BODY text="#000000" bgcolor="#ffffff">
                      8: 
1.1.1.4 ! misho       9: <A HREF="mpd.html"><EM>Mpd 5.9 User Manual</EM></A>
1.1       misho      10:  <b>:</b> <A HREF="mpd9.html"><EM>Running Mpd</EM></A>
                     11:  <b>:</b> <EM>Invoking mpd</EM><BR>
                     12: <b>Previous:</b> <A HREF="mpd9.html"><EM>Running Mpd</EM></A><BR>
                     13: <b>Next:</b> <A HREF="mpd11.html"><EM>Configuration file format</EM></A>
                     14: 
                     15: 
                     16: <HR NOSHADE>
                     17:   <H2><A NAME="10"></A>3.1. Invoking mpd<A NAME="invoke"></A></H2>
                     18: <p>Mpd is invoked by first setting up your configuration
                     19: files, and then running
                     20: <blockquote><code>
                     21: <code><b>mpd [ <em>options</em> ] [ <em>configuration</em> ] </b></code>
                     22: </code></blockquote>
                     23: 
                     24: On startup mpd run commands from the <code>startup</code> label.
1.1.1.3   misho      25: After that, if <code><em>configuration</em></code> is supplied,
1.1       misho      26: mpd looks in <code>mpd.conf</code> for a matching label,
                     27: and runs the corresponding commands. If 
                     28: <code><em>configuration</em></code> is not supplied,
                     29: mpd looks for the configuration named <code>default</code>.</p>
                     30: <p>Mpd can either be run in interactive mode or in the
                     31: background as a daemon. In interactive mode mpd
                     32: accepts commands typed at the console.</p>
                     33: <p>Mpd understands the following command line options.
                     34: Each option has a short, single character form, as
                     35: well as an equivalent long form.</p>
                     36: <p>
                     37: <dl>
                     38: 
                     39: <dt><b><code>-b  --background</code></b><dd><p>Run as a background daemon.</p>
                     40: 
                     41: <dt><b><code>-d  --directory <em>dir</em></code></b><dd><p>This option allows you to specify a different directory
                     42: for the mpd configuration files other than the default
                     43: <code>/usr/local/etc/mpd</code>.</p>
                     44: 
                     45: <dt><b><code>-f  --file <em>filename</em></code></b><dd><p>Specify an initial configuration file other than the default,
                     46: <code>mpd.conf</code>.</p>
                     47: 
                     48: <dt><b><code>-o  --one-shot</code></b><dd><p>This option forces mpd terminate itself after the last link disappear.
                     49: Link templates are not counted as links.</p>
                     50: 
                     51: <dt><b><code>-p  --pidfile <em>filename</em></code></b><dd><p>Mpd will open and lock <code><em>filename</em></code> and
                     52: write its process ID before starting. If another mpd
                     53: process is already running, mpd will not start.
                     54: The default is <code>/var/run/mpd.pid</code>.</p>
                     55: 
                     56: <dt><b><code>-k  --kill</code></b><dd><p>With this option, pd will attempt to kill any existing mpd
                     57: process before beginning execution. The previous process
                     58: must have written its process ID in the PID file
                     59: <code>/var/run/mpd.pid</code> (or the file you specify with
                     60: the <code>--pidfile</code> option).</p>
                     61: 
                     62: <dt><b><code>-s  --syslog-ident <em>ident</em></code></b><dd><p>Mpd normally logs via <code>syslog(3)</code> with the identifier
                     63: <code>mpd</code>. This option allows you to change that identifier.</p>
                     64: 
1.1.1.2   misho      65: <dt><b><code>-m  --pam-service <em>service</em></code></b><dd><p>Mpd normally invoke <code>pam(3)</code> with the service
                     66: <code>mpd</code>. This option allows you to change that service.</p>
                     67: 
1.1       misho      68: <dt><b><code>-v  --version</code></b><dd><p>Displays the version number of mpd and exits.</p>
                     69: 
                     70: <dt><b><code>-h  --help</code></b><dd><p>Displays a usage message and exits.</p>
                     71: 
                     72: </dl>
                     73: </p>
                     74: <p>Mpd responds to the following signals while it is running:</p>
                     75: <p>
                     76: <dl>
                     77: 
                     78: <dt><b>SIGTERM</b><dd><p>Attempt to gracefully shut down all active connections and exit.</p>
                     79: 
                     80: <dt><b>SIGUSR1</b><dd><p>This signal causes mpd to initiate a connection
                     81: with the first link. If mpd is already
                     82: attempting to connect, this signal has no effect.</p>
                     83: 
                     84: <dt><b>SIGUSR2</b><dd><p>This signal has the opposite effect, namely, it causes
                     85: mpd to close the first link. If the link
                     86: is already in a closed state, this signal has no effect.</p>
                     87: 
                     88: </dl>
                     89: </p>
                     90: 
                     91: 
                     92: 
                     93:  <HR NOSHADE>
1.1.1.4 ! misho      94: <A HREF="mpd.html"><EM>Mpd 5.9 User Manual</EM></A>
1.1       misho      95:  <b>:</b> <A HREF="mpd9.html"><EM>Running Mpd</EM></A>
                     96:  <b>:</b> <EM>Invoking mpd</EM><BR>
                     97: <b>Previous:</b> <A HREF="mpd9.html"><EM>Running Mpd</EM></A><BR>
                     98: <b>Next:</b> <A HREF="mpd11.html"><EM>Configuration file format</EM></A>
                     99: 
                    100: 
                    101: 
                    102: </BODY>
                    103: </HTML>

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>