audiod clean_exit(): Only check status fd once
[paraslash.git] / audiod.ggo
1 section "general options"
2 #~~~~~~~~~~~~~~~~~~~~~~~~
3
4 option "user" u
5 #~~~~~~~~~~~~~~
6
7 "run as user 'name'. Read the output of
8 'para_server -h' for more information on this
9 option."
10
11         string typestr="name"
12         optional
13
14 option "group" g
15 #~~~~~~~~~~~~~~~
16
17 "set group id to 'group'. Read the output of
18 'para_server -h' for more information on this
19 option."
20
21         string typestr="group"
22         optional
23
24 option "loglevel" l
25 #~~~~~~~~~~~~~~~~~~
26
27 "set loglevel (0-6)"
28
29         int typestr="level"
30         default="4"
31         optional
32
33 option "daemon" d
34 #~~~~~~~~~~~~~~~~
35
36 "run as background daemon"
37
38         flag off
39
40
41 option "force" F
42 #~~~~~~~~~~~~~~~
43
44 "force startup even if
45 socket exists"
46
47         flag off
48
49 option "logfile" L
50 #~~~~~~~~~~~~~~~~~
51
52 "(default=stdout/stderr)"
53
54         string typestr="filename"
55         optional
56
57 option "mode" m
58 #~~~~~~~~~~~~~~
59
60 "mode to use on startup (on/off/sb)"
61
62         string typestr="mode"
63         default="on"
64         optional
65
66 option "socket" s
67
68 "well-known socket to listen on
69 (default=/var/paraslash/audiod_sock.<host_name>)"
70
71         string typestr="filename"
72         optional
73
74 option "user_allow" -
75 #~~~~~~~~~~~~~~~~~~~~
76
77 "allow this user to connect to para_audiod.
78 May be specified multiple times. If not
79 specified at all, all users are allowed to
80 connect."
81
82         int typestr="uid"
83         default="-1"
84         optional
85         multiple
86
87
88
89
90 section "stream i/o options."
91 #~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92
93 option "receiver" r
94 #~~~~~~~~~~~~~~~~~~
95
96 "Select receiver.  May be given multiple
97 times, once for each supported audio format.
98 'receiver_spec' consists of an audio format and
99 the receiver name, separated by a colon, and
100 any options for that receiver, seperated by
101 whitespace.  If any receiver options are
102 present, the whole receiver argument must be
103 quoted.
104
105 Example:
106
107 -r 'mp3:http -i www.paraslash.org -p 8009'
108 "
109
110         string typestr="receiver_spec"
111         default="http"
112         optional
113         multiple
114
115
116 option "no_default_filters" D
117 #~~~~~~~~~~~~~~~~~~~~~~~~~~~~
118
119 "Configure filters manually. If (and only
120 if) this option is set, the --filter options
121 take effect.  Otherwise, the compiled-in
122 default filters mp3dec (oggdec) and wav are
123 activated for mp3 (ogg) streams."
124
125         flag off
126
127
128 option "filter" f
129 #~~~~~~~~~~~~~~~~
130
131 "Select filter(s) manually.  May be given
132 multiple times. filter_spec consists of an
133 audio format, the name of the filter, and any
134 options for that filter.
135
136 Examples:
137         -f 'mp3:mp3dec'
138         -f 'mp3:compress --inertia 5 --damp 2'
139
140 Note that these options are ignored by default,
141 see --no_default_filters."
142
143 string typestr="filter_spec" optional multiple
144
145
146 option "writer" w
147 #~~~~~~~~~~~~~~~~~~~~~~~~~~
148
149 "Specify stream writer.
150
151 May be given multiple times, even multiple
152 times for the same audio format.  Default
153 value is 'alsa' for all supported audio
154 formats. Example:
155
156         -w 'aac:osx'
157
158 "
159         string typestr="writer_spec"
160         optional
161         multiple
162
163
164 option "stream_delay" -
165 #~~~~~~~~~~~~~~~~~~~~~~
166
167 "Time to add to para_server's start_time.
168
169 Amount of time to be added to the server, before data is sent to
170 the writer.  Useful for syncronizing the audio output of clients."
171
172         int typestr="milliseconds"
173         default="200"
174         optional
175
176 option "stream_timeout" -
177 #~~~~~~~~~~~~~~~~~~~~~~~~
178
179 "Deactivate slot if idle for that many
180 seconds"
181
182         int typestr="seconds"
183         default="30"
184         optional