|
a/doc/upmpdcli.txt |
|
b/doc/upmpdcli.txt |
|
... |
|
... |
| 2 |
|
2 |
|
| 3 |
|
3 |
|
| 4 |
*upmpdcli* is an UPnP Media Renderer front-end to *MPD*, the Music Player
|
4 |
*upmpdcli* is an UPnP Media Renderer front-end to *MPD*, the Music Player
|
| 5 |
Daemon.
|
5 |
Daemon.
|
| 6 |
|
6 |
|
|
|
7 |
[[upmpdcli.security]]
|
|
|
8 |
== Security
|
|
|
9 |
|
|
|
10 |
*upmpdcli* is not audited for security issues, and, as far as I
|
|
|
11 |
know, it may be full of exploitable bugs. Do not run it on an
|
|
|
12 |
Internet-facing host.
|
|
|
13 |
|
|
|
14 |
[[upmpdcli.config]]
|
| 7 |
== Configuration
|
15 |
== Configuration
|
| 8 |
[[upmpdcli.config]]
|
|
|
| 9 |
|
16 |
|
| 10 |
See the man page for command line details. In most situations, *upmpdcli*
|
17 |
See the man page for command line details. In most situations, *upmpdcli*
|
| 11 |
will be run as follows:
|
18 |
will be run as follows:
|
| 12 |
|
19 |
|
| 13 |
upmpdcli -D -c /etc/upmpdcli.conf
|
20 |
upmpdcli -D -c /etc/upmpdcli.conf
|
|
... |
|
... |
| 20 |
The configuration parameters can be set from the command line, a
|
27 |
The configuration parameters can be set from the command line, a
|
| 21 |
configuration file, or the environment in this order of priority. It would
|
28 |
configuration file, or the environment in this order of priority. It would
|
| 22 |
be rather confusing to use a mix of methods, so you should probably chose
|
29 |
be rather confusing to use a mix of methods, so you should probably chose
|
| 23 |
one.
|
30 |
one.
|
| 24 |
|
31 |
|
|
|
32 |
All parameters have defaults, and a typical installation needs no
|
|
|
33 |
modification of the configuration file. If several instances of *upmpdcli*
|
|
|
34 |
run on the same network, it may be useful to give them distinct names
|
|
|
35 |
(_friendlyname_ parameter). The other parameters are only useful in special
|
|
|
36 |
situations.
|
|
|
37 |
|
| 25 |
The following parameters can be set:
|
38 |
The following parameters can be set:
|
| 26 |
|
39 |
|
| 27 |
|========================
|
40 |
|========================
|
| 28 |
|What|Command line|Environment|Config variable
|
41 |
|What|Command line|Environment|Config variable
|
| 29 |
|Configuration file name|-c config|$UPMPD_CONFIG|
|
42 |
|Configuration file name|-c config|$UPMPD_CONFIG|
|
|
... |
|
... |
| 33 |
|Do we own the *MPD* queue and fearlessly clear it|-o 0/1||ownqueue
|
46 |
|Do we own the *MPD* queue and fearlessly clear it|-o 0/1||ownqueue
|
| 34 |
|UPnP "friendly name" for the device. This gets displayed in network search
|
47 |
|UPnP "friendly name" for the device. This gets displayed in network search
|
| 35 |
results.|-f friendlyname|$UPMPD_FRIENDLYNAME|friendlyname
|
48 |
results.|-f friendlyname|$UPMPD_FRIENDLYNAME|friendlyname
|
| 36 |
|Log file name. Leave empty for stderr|-d logfilename||logfilename
|
49 |
|Log file name. Leave empty for stderr|-d logfilename||logfilename
|
| 37 |
|Verbosity level (0-4)|-l loglevel||loglevel
|
50 |
|Verbosity level (0-4)|-l loglevel||loglevel
|
|
|
51 |
|UPnP network interface|-i iface|$UPMPD_UPNPIFACE|upnpiface
|
|
|
52 |
|UPnP IP address (if interface not set)|||upnpip
|
|
|
53 |
|UPnP port|-p port|$UPMPD_UPNPPORT|upnpport
|
| 38 |
|===========================
|
54 |
|===========================
|
| 39 |
|
55 |
|
| 40 |
[[upmpdcli.boot]]
|
56 |
[[upmpdcli.boot]]
|
| 41 |
== Boot time startup
|
57 |
== Boot time startup
|
| 42 |
|
58 |
|