.\" rpld.1:

.TH "rpld" "1" "July 2010" "RoarAudio PlayList Daemon" "System User's Manual: rpld"

.SH NAME

rpld \- RoarAudio PlayList Daemon

.SH SYNOPSIS

rpld [OPTIONS]

.SH DESCRIPTION

The RoarAudio PlayList Daemon is a daemon which manages playlists and can play
files or streams from those lists using a RoarAudio Sound Server.

.SH "MISC OPTIONS"

.TP
\fB-h \-\-help\fR
Show a small help.

.TP
\fB\-\-daemon\fR
Daemonize (go into background).

.TP
\fB\-\-watchdog\fR
Start watchdog. This will automatically terminate the daemon if it stops responding.

.TP
\fB\-\-server SERVER\fR
Set default server to the RoarAudio server (e.g. roard) at SERVER.

.TP
\fB\-\-server\-queue SERV\fR
The server to use for the Main Queue.
Normally \-\-server should be used.

.TP
\fB\-\-server\-info SERV\fR
Copies the serverinfo data from the given server. Use +default as server
to use the data from the default server.
The following data is copied from the server:
location, description, contact, serial and uiurl.

.TP
\fB\-\-pidfile PIDFILE\fR
Write a pidfile at PIDFILE.

.TP
\fB\-\-histsize NUM\fR
Set size of the default history playlist to NUM entries.
This may be overwritten by restoring a store.
The special value of "default" can be used to not alter the value.
This may be used by init scripts to keep the default.

.TP
\fB\-\-location  LOC\fR
Sets lion-readable location of server.
Examples: livingroom, room 32

.TP
\fB\-\-description  DESC\fR
Sets lion-readable description of server.
Examples: Stereo, UKW Transmitter

.TP
\fB\-\-contact CONTACT\fR
Sets contact information for the server.

.TP
\fB\-\-serial SERIAL\fR
Sets the serial number for this device or server.
This is normally only used by embedded systems.

.TP
\fB\-\-uiurl UIURL\fR
Sets the URL of the user interface for this device or server.
This is normally only used by embedded systems.
It is common to set this to a URL of type HTTP but all protocols are
considered valid. This includes ssh, telnet and others.

.TP
\fB\-\-plugin\-load PLUGIN\fR
Load plugin PLUGIN.

.TP
\fB\-\-plugin\-args ARGS\fR
Set the plugin arguments for the plugin loaded next to ARGS.
This must always be used before \-\-plugin\-load.

.SH "SECURITY OPTIONS"

.TP
\fB\-\-user    USER\fR
Sets UID to USER.

.TP
\fB\-\-group   GROUP\fR
Sets GID to GROUP.

.TP
\fB\-\-allow\-running\-as\-root\fR
Allow one to run as root. This is a bad thing to do.
Do never set this option. This will open very bad security holes!

.SH "STORE OPTIONS"

.TP
\fB\-\-restore\fR
Restore state from store.

.TP
\fB\-\-no\-restore\fR
Do not restore state from store.

.TP
\fB\-\-auto\-restore\fR
will restore old state if possible.
This is a non-fatal version of \fB\-\-restore\fR.

.TP
\fB\-\-store\fR
Store state on exit.

.TP
\fB\-\-no\-store\fR
Do not store state on exit.

.TP
\fB\-\-store\-path DIR\fR
Location where to store/restore from/to.

.SH "PLAYBACK OPTIONS"

.TP
\fB\-\-play\fR
Start in playling state.

.TP
\fB\-\-stopped\fR
Start in stopped state (default).

.TP
\fB\-\-no\-default\-queue\fR
Do not create a default queue. If set and no store is loaded or the loaded store
does not contain any queues itself rpld will not connect to any RoarAudio server
at startup at all. This is mainly for debuggung and testing.

.TP
\fB\-\-role ROLE\fR
Set role for streams (default: music).
The special value of "default" can be used to use the default.

.TP
\fB\-\-codec\-helper\-rate RATE\fR
Set the sample rate the codec helper uses as it's output format.

.TP
\fB\-\-codec\-helper\-bits BITS\fR
Set the number of bits the codec helper uses as it's output format.

.TP
\fB\-\-codec\-helper\-channels CHANNELS\fR
Set the number of channels the codec helper uses as it's output format.

.TP
\fB\-\-codec\-helper\-codec CODEC\fR
Set the codec the codec helper uses as it's output format.

.SH "PLAYLIST OPTIONS"

.TP
\fB\-\-playlist\-import PLAYLIST TYPE FILE\fR
Load playlist PLAYLIST of type TYPE from file FILE.
The playlist is created if it does not exist.

.TP
\fB\-\-playlist\-export PLAYLIST TYPE FILE\fR
save playlist PLAYLIST to file FILE in format TYPE.

.TP
\fB--load-playlist PLAYLIST TYPE FILE\fR
The old name of \-\-playlist\-import. Should not be used.

.SH "NETWORK OPTIONS"

.TP
\fB\-\-tcp\fR
Listen on TCP Socket.

.TP
\fB\-\-unix\fR
Listen on UNIX Socket.

.TP
\fB\-\-decnet\fR
Listen on DECnet Socket.

.TP
\fB\-\-port PORT\fR
Listen on port PORT.
This is only useful for TCP listen sockets.

.TP
\fB\-\-bind ADDR\fR
Listen on address ADDR.

.TP
\fB\-\-proto PROTO\fR
Set protocol of listen socket.

.TP
\fB\-\-acclev LEV\fR
Sets the accesslevel for this socket to LEV.

.TP
\fB\-\-new\-sock\fR
Opens an additional listen socket.

.TP
\fB\-\-slp\fR
Enable OpenSLP support.

.TP
\fB\-\-no\-listen\fR
Do not add a default listening socket.
This option is in general not very useful for any user.
It is only useful for specal tests and with \fB\-\-client\-fh\fR.

.TP
\fB\-\-client\-fh FH\fR
Added a client at the given FH to rpld.
This option is in general not very useful for any user.

.TP
\fB\-\-close\-fh FH\fR
This closes a given FH at startup time.
This option is in general not very useful for any user.

.SH "CODEC OPTIONS"

.TP
\fB\-\-bl\-codec CODEC\fR
Use helper for codec CODEC.

.SH "SEE ALSO"
\fBroartips\fR(7),
\fBlibroar\fR(7),
\fBRoarAudio\fR(7).

.SH "HISTORY"

For history information see \fBRoarAudio\fR(7).

.\" ll