NAME
disorder-playrtp - play DisOrder network broadcasts
SYNOPSIS
disorder-playrtp [OPTIONS] [--] [[GROUP] PORT]
DESCRIPTION
disorder-playrtp plays a network broadcast sent from the specified
address.
If neither a group nor port are specified then the local DisOrder con-
figuration is consulted to find the server and the server is asked
where the RTP stream is.
If just a port is specified then the RTP stream is assumed to be uni-
cast or broadcast to that port.
If a group and a port are specified then the RTP stream is assumed to
be multicast to that group and port.
OPTIONS
The default sound API is the first of the ones listed below that are
available. Usually this implies ALSA under Linux and Core Audio under
OS X.
--alsa, -.
Use ALSA to play sound.
--oss, -o
Use OSS to play sound.
--core-audio, -c
Use Core Audio to play sound.
--device DEVICE, -D DEVICE
Specifies the audio device to use. The exact meaning of this is
platform-dependent; on Linux it is the ALSA device name.
--config PATH, -C PATH
Set the configuration file. The default is /etc/disorder/con-
fig.
--socket PATH, -s PATH
Set the control socket. Normally this would not be used manu-
ally.
--help, -h
Display a usage message.
--version, -V
Display version number.
Buffer Control Options
You shouldn't need to use these options.
--min FRAMES, -m FRAMES
Specifies the buffer low watermark in frames. If the number of
frames falls below this value then playing will be stopped until
the buffer fills up.
--buffer FRAMES, -b FRAMES
Specifies the buffer high watermark in frames. Once there are
this many frames in the buffer, playing will be (re-)started.
--max FRAMES, -x FRAMES
Specifies the maximum buffer size in frames. If there are this
many frames in the buffer then reading from the network socket
will be suspended. The default is four times the --buffer
value.
--rcvbuf BYTES, -R BYTES
Specifies socket receive buffer size. The default is 131072
(128Kbytes). The buffer size will not be reduced below the
operating system's default.
REMOTE CONTROL
The --socket option is used by Disobedience to control a background
disorder-playrtp daemon. The socket will be created as a UNIX domain
stream socket. When a connection is received a single line is read
from it. The following commands are known:
stop Causes disorder-playrtp to terminate.
query Causes the string "running" to be sent back.
Other commands are ignored. After the first command the connection is
closed. Only one connection at a time will be serviced.
This protocol is not guaranteed to be stable.
SEE ALSO
disobedience(1), disorder_config(5), disorderd(8)