.\" 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\-\-server SERVER\fR
Set default server to the RoarAudio server (e.g. roard) at SERVER.

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

.TP
\fB\-\-histsize NUM\fR
Set size of the default history playlist to NUM entrys.
This may be overwritten by restoring a store.

.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 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\-\-role ROLE\fR
Set role for streams (default: music).

.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\fR
Set the number of bits the codec helper uses as it's output format.

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

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

.SH "PLAYLIST OPTIONS"

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

.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