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:
9: <A HREF="mpd.html"><EM>Mpd 5.9 User Manual</EM></A>
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.
25: After that, if <code><em>configuration</em></code> is supplied,
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:
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:
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>
94: <A HREF="mpd.html"><EM>Mpd 5.9 User Manual</EM></A>
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>