chiark / gitweb /
document login window
[disorder] / doc / disorder-playrtp.1.in
CommitLineData
9086a105
RK
1.\"
2.\" Copyright (C) 2007 Richard Kettlewell
3.\"
4.\" This program is free software; you can redistribute it and/or modify
5.\" it under the terms of the GNU General Public License as published by
6.\" the Free Software Foundation; either version 2 of the License, or
7.\" (at your option) any later version.
8.\"
9.\" This program is distributed in the hope that it will be useful, but
10.\" WITHOUT ANY WARRANTY; without even the implied warranty of
11.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12.\" General Public License for more details.
13.\"
14.\" You should have received a copy of the GNU General Public License
15.\" along with this program; if not, write to the Free Software
16.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
17.\" USA
18.\"
19.TH disorder-playrtp 1
20.SH NAME
21disorder-playrtp \- play DisOrder network broadcasts
22.SH SYNOPSIS
23.B disorder-playrtp
24.RI [ OPTIONS ]
25.RB [ -- ]
26.I ADDRESS
27.I PORT
28.SH DESCRIPTION
29\fBdisorder-playrtp\fR plays a network broadcast sent from the specified
30address.
f2a6202f
RK
31.PP
32Normally the \fIADDRESS\fR would be 0.0.0.0. The \fIPORT\fR will depend on the
33server configuration. You may need to specify the \fB--multicast\fR option
34(see below) and if you have more than one soundcard perhaps the \fB--device\fR
35option.
9086a105
RK
36.SH OPTIONS
37.TP
38.B --device \fIDEVICE\fR, \fB-D \fIDEVICE\fR
39Specifies the audio device to use. The exact meaning of this is
40platform-dependent; on Linux it is the ALSA device name.
41.TP
f2a6202f
RK
42.B --multicast \fIGROUP\fR, \fB-M \fIGROUP\fR
43Specifies a multicast group to join. This is necessary if the network
44broadcast is being multicasted rather than broadcast.
45.TP
46.B --help\fR, \fB-h
47Display a usage message.
48.TP
49.B --version\fR, \fB-V
50Display version number.
51.SS "Buffer Control Options"
52You shouldn't need to use these options.
53.TP
9086a105
RK
54.B --min \fIFRAMES\fR, \fB-m \fIFRAMES\fR
55Specifies the buffer low watermark in frames. If the number of frames falls
56below this value then playing will be stopped until the buffer fills up.
57.TP
58.B --buffer \fIFRAMES\fR, \fB-b \fIFRAMES\fR
59Specifies the buffer high watermark in frames. Once there are this many frames
60in the buffer, playing will be (re-)started.
61.TP
62.B --max \fIFRAMES\fR, \fB-x \fIFRAMES\fR
63Specifies the maximum buffer size in frames. If there are this many frames in
64the buffer then reading from the network socket will be suspended. The default
65is four times the \fB--buffer\fR value.
66.TP
803f6e52 67.B --rcvbuf \fIBYTES\fR, \fB-R \fIBYTES\fR
f2a6202f
RK
68Specifies socket receive buffer size. The default is 131072 (128Kbytes). The
69buffer size will not be reduced below the operating system's default.
9086a105
RK
70.SH "SEE ALSO"
71.BR disorder_config (5),
72.BR disorderd (8)
73.\" Local Variables:
74.\" mode:nroff
75.\" fill-column:79
76.\" End: