Merge branch 't/sound_device_lock'
[paraslash.git] / audiod.c
1 /*
2 * Copyright (C) 2005-2014 Andre Noll <maan@tuebingen.mpg.de>
3 *
4 * Licensed under the GPL v2. For licencing details see COPYING.
5 */
6
7 /** \file audiod.c The paraslash's audio daemon. */
8
9 #include <netinet/in.h>
10 #include <sys/socket.h>
11 #include <regex.h>
12 #include <sys/types.h>
13 #include <arpa/inet.h>
14 #include <sys/un.h>
15 #include <netdb.h>
16 #include <signal.h>
17
18 #include "para.h"
19 #include "error.h"
20 #include "crypt.h"
21 #include "audiod.cmdline.h"
22 #include "list.h"
23 #include "sched.h"
24 #include "ggo.h"
25 #include "buffer_tree.h"
26 #include "recv.h"
27 #include "filter.h"
28 #include "grab_client.h"
29 #include "client.cmdline.h"
30 #include "client.h"
31 #include "audiod.h"
32 #include "net.h"
33 #include "daemon.h"
34 #include "string.h"
35 #include "fd.h"
36 #include "write.h"
37 #include "write_common.h"
38 #include "signal.h"
39 #include "version.h"
40
41 __printf_2_3 void (*para_log)(int, const char*, ...) = daemon_log;
42 /** define the array of error lists needed by para_audiod */
43 INIT_AUDIOD_ERRLISTS;
44 /** define the array containing all supported audio formats */
45 const char *audio_formats[] = {AUDIOD_AUDIO_FORMAT_ARRAY NULL};
46
47 DEFINE_RECEIVER_ARRAY;
48
49 /** Defines how audiod handles one supported audio format. */
50 struct audio_format_info {
51 /** pointer to the receiver for this audio format */
52 struct receiver *receiver;
53 /** the receiver configuration */
54 void *receiver_conf;
55 /** the number of filters that should be activated for this audio format */
56 unsigned int num_filters;
57 /** Array of filter numbers to be activated. */
58 unsigned *filter_nums;
59 /** Pointer to the array of filter configurations. */
60 void **filter_conf;
61 /** the number of filters that should be activated for this audio format */
62 unsigned int num_writers;
63 /** Array of writer numbers to be activated. */
64 int *writer_nums;
65 /** pointer to the array of writer configurations */
66 void **writer_conf;
67 /** do not start receiver/filters/writer before this time */
68 struct timeval restart_barrier;
69 };
70
71 /**
72 * para_audiod uses \p MAX_STREAM_SLOTS different slots, each of which may
73 * be associated with a receiver/filter/writer triple. This array holds all
74 * information on the status of these slots.
75 *
76 * \sa struct slot_info
77 * */
78 struct slot_info slot[MAX_STREAM_SLOTS];
79
80 /** The vss status flags audiod is interested in. */
81 enum vss_status_flags {
82 /** Whether the 'N' flag is set. */
83 VSS_STATUS_FLAG_NEXT = 1,
84 /** The 'P' flag is set. */
85 VSS_STATUS_FLAG_PLAYING = 2,
86 };
87
88 /**
89 * The scheduler instance of para_audiod.
90 *
91 * This is needed also in audiod_command.c (for the tasks command), so it can
92 * not be made static.
93 */
94 struct sched sched = {.max_fileno = 0};
95
96 /* The task for obtaining para_server's status (para_client stat). */
97 struct status_task {
98 /** The associated task structure of audiod. */
99 struct task *task;
100 /** Client data associated with the stat task. */
101 struct client_task *ct;
102 /** Do not restart client command until this time. */
103 struct timeval restart_barrier;
104 /** Last time we received status data from para_server. */
105 struct timeval last_status_read;
106 size_t min_iqs;
107 /** The offset value announced by para_server. */
108 int offset_seconds;
109 /** The length of the current audio file as announced by para_server. */
110 int length_seconds;
111 /** The start of the current stream from the view of para_server. */
112 struct timeval server_stream_start;
113 /** The average time deviation between para_server and para_audiod. */
114 struct timeval sa_time_diff;
115 /** Whether client time is ahead of server time. */
116 int sa_time_diff_sign;
117 /** The 'P' and the 'N' flags as announced by para_server. */
118 enum vss_status_flags vss_status;
119 /** Number of times the clock difference is to be checked. */
120 unsigned clock_diff_count;
121 /** When to start the next check for clock difference. */
122 struct timeval clock_diff_barrier;
123 /** Number of the audio format as announced by para_server. */
124 int current_audio_format_num;
125 /* The status task btrn is the child of the client task. */
126 struct btr_node *btrn;
127 };
128
129 /** The array of status items sent by para_server. */
130 char *stat_item_values[NUM_STAT_ITEMS] = {NULL};
131
132 /**
133 * the current mode of operation of which can be changed by the on/off/cycle
134 * commands. It is either, AUDIOD_OFF, AUDIOD_ON or AUDIOD_STANDBY.
135 */
136 int audiod_status = AUDIOD_ON;
137
138 /**
139 * the gengetopt args_info struct that holds information on all command line
140 * arguments
141 */
142 struct audiod_args_info conf;
143
144 static char *socket_name;
145 static struct audio_format_info afi[NUM_AUDIO_FORMATS];
146
147 static struct signal_task signal_task_struct, *sig_task = &signal_task_struct;
148
149 static struct status_task status_task_struct;
150
151 /**
152 * the task that calls the status command of para_server
153 *
154 * \sa struct status_task
155 */
156 static struct status_task *stat_task = &status_task_struct;
157
158 /**
159 * the task for handling audiod commands
160 *
161 * \sa struct task, struct sched
162 */
163 struct command_task {
164 /** the local listening socket */
165 int fd;
166 /** the associated task structure */
167 struct task *task;
168 };
169
170 /** iterate over all supported audio formats */
171 #define FOR_EACH_AUDIO_FORMAT(af) for (af = 0; af < NUM_AUDIO_FORMATS; af++)
172
173 /**
174 * Get the audio format number.
175 *
176 * \param name The name of the audio format.
177 *
178 * \return The audio format number on success, -E_UNSUPPORTED_AUDIO_FORMAT if
179 * \a name is not a supported audio format.
180 */
181 static int get_audio_format_num(const char *name)
182 {
183 int i;
184
185 while (para_isspace(*name))
186 name++;
187 FOR_EACH_AUDIO_FORMAT(i)
188 if (!strcmp(name, audio_formats[i]))
189 return i;
190 return -E_UNSUPPORTED_AUDIO_FORMAT;
191 }
192
193 static int get_matching_audio_format_nums(const char *re)
194 {
195 int i, ret;
196 regex_t preg;
197
198 ret = para_regcomp(&preg, re, REG_EXTENDED | REG_NOSUB);
199 if (ret < 0)
200 return ret;
201 ret = 0;
202 FOR_EACH_AUDIO_FORMAT(i)
203 if (regexec(&preg, audio_formats[i], 0, NULL, 0) != REG_NOMATCH)
204 ret |= (1 << i);
205 regfree(&preg);
206 return ret;
207 }
208
209 /**
210 * Compute the play time based on information of the given slot.
211 *
212 * \param slot_num The slot number (negative means: no slot).
213 *
214 * This computes a string of the form "0:07 [3:33] (3%/3:40)" using information
215 * from the status items received from para_server and the start time of the
216 * (first) writer of the given slot.
217 *
218 * It has to take into account that the stream was probably not started at
219 * the beginning of the file, that the clock between the server and the client
220 * host may differ and that playback of the stream was delayed, e.g. because
221 * the prebuffer filter is used in the filter configuration of the given slot.
222 *
223 * If no writer is active in the given slot, or \a slot_num is negative
224 * (indicating that para_audiod runs in standby mode), an approximation based
225 * only on the status items is computed and the returned string is prefixed
226 * with "~".
227 *
228 * \return A string that must be freed by the caller.
229 */
230 char *get_time_string(int slot_num)
231 {
232 int ret, seconds = 0, length;
233 struct timeval *tmp, sum, sss, /* server stream start */
234 rstime, /* receiver start time */
235 wstime, /* writer start time */
236 wtime, /* now - writer start */
237 rskip; /* receiver start - sss */
238 struct slot_info *s = slot_num < 0? NULL : &slot[slot_num];
239 char *msg;
240
241 if (audiod_status == AUDIOD_OFF)
242 goto empty;
243 if (!(stat_task->vss_status & VSS_STATUS_FLAG_PLAYING)) {
244 if (stat_task->length_seconds) /* paused */
245 return NULL;
246 goto empty; /* stopped */
247 }
248 if (audiod_status == AUDIOD_ON && !s)
249 goto empty;
250 /*
251 * Valid status items and playing, set length and tmp to the stream
252 * start. We use the slot info and fall back to the info from current
253 * status items if no slot info is available.
254 */
255 length = stat_task->length_seconds;
256 tmp = &stat_task->server_stream_start;
257 if (s && s->wns && s->wns[0].btrn) { /* writer active in this slot */
258 btr_get_node_start(s->wns[0].btrn, &wstime);
259 if (wstime.tv_sec != 0) { /* writer wrote something */
260 if (s->server_stream_start.tv_sec == 0) {
261 /* copy status info to slot */
262 s->server_stream_start = stat_task->server_stream_start;
263 s->offset_seconds = stat_task->offset_seconds;
264 s->seconds_total = stat_task->length_seconds;
265 }
266 length = s->seconds_total;
267 tmp = &s->server_stream_start;
268 }
269 }
270 if (stat_task->sa_time_diff_sign > 0)
271 tv_diff(tmp, &stat_task->sa_time_diff, &sss);
272 else
273 tv_add(tmp, &stat_task->sa_time_diff, &sss);
274 if (!s || !s->wns || !s->wns[0].btrn) {
275 struct timeval diff;
276 tv_diff(now, &sss, &diff);
277 seconds = diff.tv_sec + stat_task->offset_seconds;
278 goto out;
279 }
280 tv_diff(now, &wstime, &wtime);
281 //PARA_CRIT_LOG("offset %d\n", s->offset_seconds);
282 seconds = s->offset_seconds;
283 if (s->receiver_node->btrn) {
284 btr_get_node_start(s->receiver_node->btrn, &rstime);
285 ret = tv_diff(&rstime, &sss, &rskip);
286 if (ret > 0) { /* audiod was started in the middle of the stream */
287 tv_add(&wtime, &rskip, &sum);
288 seconds += sum.tv_sec;
289 } else
290 seconds += wtime.tv_sec;
291 } else
292 seconds += wtime.tv_sec;
293 out:
294 seconds = PARA_MIN(seconds, length);
295 seconds = PARA_MAX(seconds, 0);
296 msg = make_message(
297 "%s%d:%02d [%d:%02d] (%d%%/%d:%02d)",
298 s? "" : "~",
299 seconds / 60,
300 seconds % 60,
301 (length - seconds) / 60,
302 (length - seconds) % 60,
303 length? (seconds * 100 + length / 2) / length : 0,
304 length / 60,
305 length % 60
306 );
307 //PARA_DEBUG_LOG("slot %d: %s\n", slot_num, msg);
308 return msg;
309 empty:
310 return para_strdup(NULL);
311 }
312
313 static int want_colors(void)
314 {
315 if (conf.color_arg == color_arg_no)
316 return 0;
317 if (conf.color_arg == color_arg_yes)
318 return 1;
319 if (conf.logfile_given)
320 return 0;
321 return isatty(STDERR_FILENO);
322 }
323
324 static void parse_config_or_die(void)
325 {
326 int ret;
327 char *config_file;
328 struct audiod_cmdline_parser_params params = {
329 .override = 0,
330 .initialize = 0,
331 .check_required = 1,
332 .check_ambiguity = 0,
333 .print_errors = 1
334 };
335
336 if (conf.config_file_given)
337 config_file = para_strdup(conf.config_file_arg);
338 else {
339 char *home = para_homedir();
340 config_file = make_message("%s/.paraslash/audiod.conf", home);
341 free(home);
342 }
343 ret = file_exists(config_file);
344 if (conf.config_file_given && !ret) {
345 PARA_EMERG_LOG("can not read config file %s\n", config_file);
346 goto err;
347 }
348 if (ret) {
349 audiod_cmdline_parser_config_file(config_file, &conf, &params);
350 daemon_set_loglevel(conf.loglevel_arg);
351 }
352 free(config_file);
353 return;
354 err:
355 free(config_file);
356 exit(EXIT_FAILURE);
357 }
358
359 static void setup_signal_handling(void)
360 {
361 sig_task->fd = para_signal_init();
362 PARA_INFO_LOG("signal pipe: fd %d\n", sig_task->fd);
363 para_install_sighandler(SIGINT);
364 para_install_sighandler(SIGTERM);
365 para_install_sighandler(SIGHUP);
366 para_sigaction(SIGPIPE, SIG_IGN);
367 }
368
369 static void clear_slot(int slot_num)
370 {
371 struct slot_info *s = &slot[slot_num];
372
373 PARA_INFO_LOG("clearing slot %d\n", slot_num);
374 memset(s, 0, sizeof(struct slot_info));
375 s->format = -1;
376 }
377
378 static void close_receiver(int slot_num)
379 {
380 struct slot_info *s = &slot[slot_num];
381 struct audio_format_info *a;
382
383 if (s->format < 0 || !s->receiver_node)
384 return;
385 a = &afi[s->format];
386 PARA_NOTICE_LOG("closing %s receiver in slot %d\n",
387 audio_formats[s->format], slot_num);
388 a->receiver->close(s->receiver_node);
389 btr_remove_node(&s->receiver_node->btrn);
390 task_reap(&s->receiver_node->task);
391 free(s->receiver_node);
392 s->receiver_node = NULL;
393 stat_task->current_audio_format_num = -1;
394 tv_add(now, &(struct timeval)EMBRACE(0, 200 * 1000),
395 &a->restart_barrier);
396 }
397
398 static void writer_cleanup(struct writer_node *wn)
399 {
400 struct writer *w;
401
402 if (!wn)
403 return;
404 w = writers + wn->writer_num;
405 PARA_INFO_LOG("closing %s\n", writer_names[wn->writer_num]);
406 w->close(wn);
407 btr_remove_node(&wn->btrn);
408 task_reap(&wn->task);
409 }
410
411 static void close_writers(struct slot_info *s)
412 {
413 struct audio_format_info *a;
414 int i;
415
416 if (s->format < 0)
417 return;
418 assert(s->wns);
419 a = afi + s->format;
420 if (a->num_writers == 0)
421 writer_cleanup(s->wns);
422 else {
423 for (i = 0; i < a->num_writers; i++)
424 writer_cleanup(s->wns + i);
425 }
426 free(s->wns);
427 s->wns = NULL;
428 }
429
430 static void close_filters(struct slot_info *s)
431 {
432 int i;
433 struct audio_format_info *a = afi + s->format;
434 if (a->num_filters == 0)
435 return;
436 for (i = a->num_filters - 1; i >= 0; i--) {
437 struct filter_node *fn = s->fns + i;
438 struct filter *f;
439
440 if (!fn)
441 continue;
442 f = filters + fn->filter_num;
443 if (f->close)
444 f->close(fn);
445 btr_remove_node(&fn->btrn);
446 task_reap(&fn->task);
447 }
448 free(s->fns);
449 s->fns = NULL;
450 }
451
452 static void notify_receivers(int error)
453 {
454 int i;
455
456 FOR_EACH_SLOT(i) {
457 struct slot_info *s = slot + i;
458 if (s->format < 0)
459 continue;
460 if (!s->receiver_node)
461 continue;
462 task_notify(s->receiver_node->task, error);
463 }
464 }
465
466 static int get_empty_slot(void)
467 {
468 int i;
469 struct slot_info *s;
470
471 FOR_EACH_SLOT(i) {
472 s = &slot[i];
473 if (s->format < 0) {
474 clear_slot(i);
475 return i;
476 }
477 if (s->wns || s->receiver_node || s->fns)
478 continue;
479 clear_slot(i);
480 return i;
481 }
482 return -E_NO_MORE_SLOTS;
483 }
484
485 static void open_filters(struct slot_info *s)
486 {
487 struct audio_format_info *a = afi + s->format;
488 struct filter_node *fn;
489 int nf = a->num_filters;
490 struct btr_node *parent;
491 int i;
492
493 if (nf == 0)
494 return;
495 PARA_INFO_LOG("opening %s filters\n", audio_formats[s->format]);
496 assert(s->fns == NULL);
497 s->fns = para_calloc(nf * sizeof(struct filter_node));
498 parent = s->receiver_node->btrn;
499 for (i = 0; i < nf; i++) {
500 char buf[20];
501 struct filter *f = filters + a->filter_nums[i];
502 fn = s->fns + i;
503 fn->filter_num = a->filter_nums[i];
504 fn->conf = a->filter_conf[i];
505 fn->btrn = btr_new_node(&(struct btr_node_description)
506 EMBRACE(.name = f->name, .parent = parent,
507 .handler = f->execute, .context = fn));
508
509 f->open(fn);
510 sprintf(buf, "%s (slot %d)", f->name, (int)(s - slot));
511 fn->task = task_register(&(struct task_info) {
512 .name = buf,
513 .pre_select = f->pre_select,
514 .post_select = f->post_select,
515 .context = fn,
516 }, &sched);
517 parent = fn->btrn;
518 PARA_NOTICE_LOG("%s filter %d/%d (%s) started in slot %d\n",
519 audio_formats[s->format], i, nf, f->name, (int)(s - slot));
520 }
521 }
522
523 static void open_writers(struct slot_info *s)
524 {
525 int i;
526 struct audio_format_info *a = afi + s->format;
527 struct writer_node *wn;
528 struct btr_node *parent = s->fns[a->num_filters - 1].btrn;
529
530 assert(s->wns == NULL);
531 s->wns = para_calloc(PARA_MAX(1U, a->num_writers)
532 * sizeof(struct writer_node));
533 for (i = 0; i < a->num_writers; i++) {
534 wn = s->wns + i;
535 wn->conf = a->writer_conf[i];
536 wn->writer_num = a->writer_nums[i];
537 register_writer_node(wn, parent, &sched);
538 PARA_NOTICE_LOG("%s writer started in slot %d\n",
539 writer_names[a->writer_nums[i]], (int)(s - slot));
540 }
541 }
542
543 /* returns slot num on success */
544 static int open_receiver(int format)
545 {
546 struct audio_format_info *a = &afi[format];
547 struct slot_info *s;
548 int ret, slot_num;
549 struct receiver *r = a->receiver;
550 struct receiver_node *rn;
551
552 tv_add(now, &(struct timeval)EMBRACE(2, 0), &a->restart_barrier);
553 ret = get_empty_slot();
554 if (ret < 0)
555 return ret;
556 slot_num = ret;
557 rn = para_calloc(sizeof(*rn));
558 rn->receiver = r;
559 rn->conf = a->receiver_conf;
560 rn->btrn = btr_new_node(&(struct btr_node_description)
561 EMBRACE(.name = r->name, .context = rn));
562 ret = r->open(rn);
563 if (ret < 0) {
564 btr_remove_node(&rn->btrn);
565 free(rn);
566 return ret;
567 }
568 s = &slot[slot_num];
569 s->format = format;
570 s->receiver_node = rn;
571 PARA_NOTICE_LOG("started %s: %s receiver in slot %d\n",
572 audio_formats[format], r->name, slot_num);
573 rn->task = task_register(&(struct task_info) {
574 .name = r->name,
575 .pre_select = r->pre_select,
576 .post_select = r->post_select,
577 .context = rn,
578 }, &sched);
579 return slot_num;
580 }
581
582 static bool receiver_running(void)
583 {
584 int i;
585 long unsigned ss1 = stat_task->server_stream_start.tv_sec;
586
587 FOR_EACH_SLOT(i) {
588 struct slot_info *s = &slot[i];
589 long unsigned ss2 = s->server_stream_start.tv_sec;
590
591 if (!s->receiver_node)
592 continue;
593 if (task_status(s->receiver_node->task) >= 0)
594 return true;
595 if (ss1 == ss2)
596 return true;
597 }
598 return false;
599 }
600
601 /**
602 * Return the root node of the current buffer tree.
603 *
604 * This is only used for stream grabbing.
605 *
606 * \return \p NULL if no slot is currently active. If more than one buffer tree
607 * exists, the node corresponding to the most recently started receiver is
608 * returned.
609 */
610 struct btr_node *audiod_get_btr_root(void)
611 {
612 int i, newest_slot = -1;
613 struct timeval newest_rstime = {0, 0};
614
615 FOR_EACH_SLOT(i) {
616 struct slot_info *s = &slot[i];
617 struct timeval rstime;
618 if (!s->receiver_node)
619 continue;
620 if (task_status(s->receiver_node->task) < 0)
621 continue;
622 btr_get_node_start(s->receiver_node->btrn, &rstime);
623 if (newest_slot >= 0 && tv_diff(&rstime, &newest_rstime, NULL) < 0)
624 continue;
625 newest_rstime = rstime;
626 newest_slot = i;
627 }
628 if (newest_slot == -1)
629 return NULL;
630 return slot[newest_slot].receiver_node->btrn;
631 }
632
633 /* whether a new instance of a decoder should be started. */
634 static bool must_start_decoder(void)
635 {
636 int cafn = stat_task->current_audio_format_num;
637 unsigned vs = stat_task->vss_status;
638
639 if (audiod_status != AUDIOD_ON)
640 return false;
641 if (cafn < 0)
642 return false;
643 if (!stat_task->ct)
644 return false;
645 if (vs & VSS_STATUS_FLAG_NEXT)
646 return false;
647 if (!(vs & VSS_STATUS_FLAG_PLAYING))
648 return false;
649 if (receiver_running())
650 return false;
651 if (tv_diff(now, &afi[cafn].restart_barrier, NULL) < 0)
652 return false;
653 return true;
654 }
655
656 static void compute_time_diff(const struct timeval *status_time)
657 {
658 struct timeval tmp, diff;
659 static unsigned count;
660 int sign, sa_time_diff_sign = stat_task->sa_time_diff_sign;
661 const struct timeval max_deviation = {0, 500 * 1000};
662 const int time_smooth = 5;
663
664 sign = tv_diff(status_time, now, &diff);
665 // PARA_NOTICE_LOG("%s: sign = %i, sa_time_diff_sign = %i\n", __func__,
666 // sign, sa_time_diff_sign);
667 if (!count) {
668 sa_time_diff_sign = sign;
669 stat_task->sa_time_diff = diff;
670 count++;
671 goto out;
672 }
673 if (count > 5) {
674 int s = tv_diff(&diff, &stat_task->sa_time_diff, &tmp);
675 if (tv_diff(&max_deviation, &tmp, NULL) < 0)
676 PARA_WARNING_LOG("time diff jump: %lims\n",
677 s * tv2ms(&tmp));
678 }
679 count++;
680 sa_time_diff_sign = tv_convex_combination(
681 sa_time_diff_sign * time_smooth, &stat_task->sa_time_diff,
682 count > 10? sign : sign * time_smooth, &diff,
683 &tmp);
684 stat_task->sa_time_diff = tmp;
685 PARA_INFO_LOG("time diff (cur/avg): %s%lums/%s%lums\n",
686 sign < 0? "-" : "+",
687 tv2ms(&diff),
688 sa_time_diff_sign < 0? "-" : "+",
689 tv2ms(&stat_task->sa_time_diff)
690 );
691 out:
692 stat_task->sa_time_diff_sign = sa_time_diff_sign;
693 }
694
695 static int update_item(int itemnum, char *buf)
696 {
697 long unsigned sec, usec;
698
699 if (stat_task->clock_diff_count && itemnum != SI_CURRENT_TIME)
700 return 1;
701 free(stat_item_values[itemnum]);
702 stat_item_values[itemnum] = para_strdup(buf);
703 stat_client_write_item(itemnum);
704 switch (itemnum) {
705 case SI_STATUS_FLAGS:
706 stat_task->vss_status = 0;
707 if (strchr(buf, 'N'))
708 stat_task->vss_status |= VSS_STATUS_FLAG_NEXT;
709 if (strchr(buf, 'P'))
710 stat_task->vss_status |= VSS_STATUS_FLAG_PLAYING;
711 break;
712 case SI_OFFSET:
713 stat_task->offset_seconds = atoi(buf);
714 break;
715 case SI_SECONDS_TOTAL:
716 stat_task->length_seconds = atoi(buf);
717 break;
718 case SI_STREAM_START:
719 if (sscanf(buf, "%lu.%lu", &sec, &usec) == 2) {
720 stat_task->server_stream_start.tv_sec = sec;
721 stat_task->server_stream_start.tv_usec = usec;
722 }
723 break;
724 case SI_CURRENT_TIME:
725 if (sscanf(buf, "%lu.%lu", &sec, &usec) == 2) {
726 struct timeval tv = {sec, usec};
727 compute_time_diff(&tv);
728 }
729 break;
730 case SI_FORMAT:
731 stat_task->current_audio_format_num
732 = get_audio_format_num(buf);
733 }
734 return 1;
735 }
736
737 static int parse_stream_command(const char *txt, char **cmd)
738 {
739 int ret, len;
740 char *re, *p = strchr(txt, ':');
741
742 if (!p)
743 return -E_MISSING_COLON;
744 *cmd = p + 1;
745 len = p - txt;
746 re = malloc(len + 1);
747 strncpy(re, txt, len);
748 re[len] = '\0';
749 ret = get_matching_audio_format_nums(re);
750 free(re);
751 return ret;
752 }
753
754 static int add_filter(int format, char *cmdline)
755 {
756 struct audio_format_info *a = &afi[format];
757 int filter_num, nf = a->num_filters;
758 void *cfg;
759
760 filter_num = check_filter_arg(cmdline, &cfg);
761 if (filter_num < 0)
762 return filter_num;
763 a->filter_conf = para_realloc(a->filter_conf,
764 (nf + 1) * sizeof(void *));
765 a->filter_nums = para_realloc(a->filter_nums,
766 (nf + 1) * sizeof(unsigned));
767 a->filter_nums[nf] = filter_num;
768 a->filter_conf[nf] = cfg;
769 a->num_filters++;
770 PARA_INFO_LOG("%s filter %d: %s\n", audio_formats[format], nf,
771 filters[filter_num].name);
772 return filter_num;
773 }
774
775 static int parse_writer_args(void)
776 {
777 int i, ret;
778 char *cmd;
779 struct audio_format_info *a;
780
781 for (i = 0; i < conf.writer_given; i++) {
782 void *wconf;
783 int j, nw, writer_num, af_mask;
784
785 ret = parse_stream_command(conf.writer_arg[i], &cmd);
786 if (ret < 0)
787 return ret;
788 af_mask = ret;
789 FOR_EACH_AUDIO_FORMAT(j) {
790 a = afi + j;
791 if ((af_mask & (1 << j)) == 0) /* no match */
792 continue;
793 wconf = check_writer_arg_or_die(cmd, &writer_num);
794 nw = a->num_writers;
795 a->writer_nums = para_realloc(a->writer_nums, (nw + 1) * sizeof(int));
796 a->writer_conf = para_realloc(a->writer_conf, (nw + 1) * sizeof(void *));
797 a->writer_nums[nw] = writer_num;
798 a->writer_conf[nw] = wconf;
799 PARA_INFO_LOG("%s writer #%d: %s\n", audio_formats[j],
800 nw, writer_names[writer_num]);
801 a->num_writers++;
802 }
803 }
804 /* Use default writer for audio formats which are not yet set up. */
805 FOR_EACH_AUDIO_FORMAT(i) {
806 void *writer_conf;
807 int writer_num;
808 a = afi + i;
809 if (a->num_writers > 0)
810 continue; /* already set up */
811 writer_conf = check_writer_arg_or_die(NULL, &writer_num);
812 a->writer_nums = para_malloc(sizeof(int));
813 a->writer_nums[0] = writer_num;
814 a->writer_conf = para_malloc(sizeof(void *));
815 a->writer_conf[0] = writer_conf;
816 a->num_writers = 1;
817 PARA_INFO_LOG("%s writer: %s (default)\n", audio_formats[i],
818 writer_names[writer_num]);
819 }
820 return 1;
821 }
822
823 static int parse_receiver_args(void)
824 {
825 int i, ret, receiver_num;
826 char *cmd = NULL;
827 struct audio_format_info *a;
828
829 for (i = conf.receiver_given - 1; i >= 0; i--) {
830 char *arg;
831 int j, af_mask;
832
833 ret = parse_stream_command(conf.receiver_arg[i], &arg);
834 if (ret < 0)
835 goto out;
836 af_mask = ret;
837 FOR_EACH_AUDIO_FORMAT(j) {
838 a = afi + j;
839 if ((af_mask & (1 << j)) == 0) /* no match */
840 continue;
841 /*
842 * If multiple receivers are given for this audio format, the
843 * last one wins and we have to free the previous receiver
844 * config here. Since we are iterating backwards, the winning
845 * receiver arg is in fact the first one given.
846 */
847 if (a->receiver_conf)
848 a->receiver->free_config(a->receiver_conf);
849 a->receiver_conf = check_receiver_arg(arg, &receiver_num);
850 ret = -E_RECV_SYNTAX;
851 if (!a->receiver_conf)
852 goto out;
853 a->receiver = receivers + receiver_num;
854 }
855 }
856 /*
857 * Use the first available receiver with no arguments for those audio
858 * formats for which no receiver was specified.
859 */
860 cmd = para_strdup(receivers[0].name);
861 FOR_EACH_AUDIO_FORMAT(i) {
862 a = &afi[i];
863 if (a->receiver_conf)
864 continue;
865 a->receiver_conf = check_receiver_arg(cmd, &receiver_num);
866 if (!a->receiver_conf)
867 return -E_RECV_SYNTAX;
868 a->receiver = &receivers[receiver_num];
869 }
870 FOR_EACH_AUDIO_FORMAT(i) {
871 a = afi + i;
872 PARA_INFO_LOG("receiving %s streams via %s receiver\n",
873 audio_formats[i], a->receiver->name);
874 }
875 ret = 1;
876 out:
877 free(cmd);
878 return ret;
879 }
880
881 static int init_default_filters(void)
882 {
883 int i, ret = 1;
884
885 FOR_EACH_AUDIO_FORMAT(i) {
886 struct audio_format_info *a = &afi[i];
887 char *tmp;
888 int j;
889
890 if (a->num_filters)
891 continue; /* no default -- nothing to to */
892 /*
893 * udp and dccp streams are fec-encoded, so add fecdec as the
894 * first filter.
895 */
896 if (strcmp(afi[i].receiver->name, "udp") == 0 ||
897 strcmp(afi[i].receiver->name, "dccp") == 0) {
898 tmp = para_strdup("fecdec");
899 add_filter(i, tmp);
900 free(tmp);
901 if (ret < 0)
902 goto out;
903 }
904 /* add "dec" to audio format name */
905 tmp = make_message("%sdec", audio_formats[i]);
906 for (j = 0; filters[j].name; j++)
907 if (!strcmp(tmp, filters[j].name))
908 break;
909 free(tmp);
910 ret = -E_UNSUPPORTED_FILTER;
911 if (!filters[j].name)
912 goto out;
913 tmp = para_strdup(filters[j].name);
914 ret = add_filter(i, tmp);
915 free(tmp);
916 if (ret < 0)
917 goto out;
918 PARA_INFO_LOG("%s -> default filter: %s\n", audio_formats[i],
919 filters[j].name);
920 }
921 out:
922 return ret;
923 }
924
925 static int parse_filter_args(void)
926 {
927 int i, j, ret, af_mask, num_matches;
928
929 for (i = 0; i < conf.filter_given; i++) {
930 char *arg;
931 ret = parse_stream_command(conf.filter_arg[i], &arg);
932 if (ret < 0)
933 goto out;
934 af_mask = ret;
935 num_matches = 0;
936 FOR_EACH_AUDIO_FORMAT(j) {
937 if ((af_mask & (1 << j)) == 0) /* no match */
938 continue;
939 ret = add_filter(j, arg);
940 if (ret < 0)
941 goto out;
942 num_matches++;
943 }
944 if (num_matches == 0)
945 PARA_WARNING_LOG("ignoring filter spec: %s\n",
946 conf.filter_arg[i]);
947 }
948 ret = init_default_filters(); /* use default values for the rest */
949 out:
950 return ret;
951 }
952
953 static int parse_stream_args(void)
954 {
955 int ret;
956
957 ret = parse_receiver_args();
958 if (ret < 0)
959 return ret;
960 ret = parse_filter_args();
961 if (ret < 0)
962 return ret;
963 ret = parse_writer_args();
964 if (ret < 0)
965 return ret;
966 return 1;
967 }
968
969 /* does not unlink socket on errors */
970 static int audiod_get_socket(void)
971 {
972 struct sockaddr_un unix_addr;
973 int ret, fd;
974
975 if (conf.socket_given)
976 socket_name = para_strdup(conf.socket_arg);
977 else {
978 char *hn = para_hostname();
979 socket_name = make_message("/var/paraslash/audiod_socket.%s",
980 hn);
981 free(hn);
982 }
983 PARA_NOTICE_LOG("local socket: %s\n", socket_name);
984 if (conf.force_given)
985 unlink(socket_name);
986 ret = create_local_socket(socket_name, &unix_addr,
987 S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IWOTH);
988 if (ret < 0)
989 goto err;
990 fd = ret;
991 if (listen(fd , 5) < 0) {
992 ret = -ERRNO_TO_PARA_ERROR(errno);
993 goto err;
994 }
995 ret = mark_fd_nonblocking(fd);
996 if (ret < 0)
997 goto err;
998 return fd;
999 err:
1000 PARA_EMERG_LOG("%s\n", para_strerror(-ret));
1001 exit(EXIT_FAILURE);
1002 }
1003
1004 static void signal_pre_select(struct sched *s, void *context)
1005 {
1006 struct signal_task *st = context;
1007 para_fd_set(st->fd, &s->rfds, &s->max_fileno);
1008 }
1009
1010 static int signal_post_select(struct sched *s, void *context)
1011 {
1012 struct signal_task *st = context;
1013 int ret, signum;
1014
1015 ret = task_get_notification(st->task);
1016 if (ret < 0)
1017 return ret;
1018 signum = para_next_signal(&s->rfds);
1019 switch (signum) {
1020 case SIGINT:
1021 case SIGTERM:
1022 case SIGHUP:
1023 PARA_NOTICE_LOG("received signal %d\n", signum);
1024 task_notify_all(s, E_AUDIOD_SIGNAL);
1025 return -E_AUDIOD_SIGNAL;
1026 }
1027 return 0;
1028 }
1029
1030 static void command_pre_select(struct sched *s, void *context)
1031 {
1032 struct command_task *ct = context;
1033 para_fd_set(ct->fd, &s->rfds, &s->max_fileno);
1034 }
1035
1036 static int command_post_select(struct sched *s, void *context)
1037 {
1038 int ret;
1039 struct command_task *ct = context;
1040 static struct timeval last_status_dump;
1041 struct timeval tmp, delay;
1042 bool force = true;
1043
1044 ret = task_get_notification(ct->task);
1045 if (ret < 0)
1046 return ret;
1047 ret = handle_connect(ct->fd, &s->rfds);
1048 if (ret < 0) {
1049 PARA_ERROR_LOG("%s\n", para_strerror(-ret));
1050 if (ret == -E_AUDIOD_TERM) {
1051 task_notify_all(s, -ret);
1052 return ret;
1053 }
1054 } else if (ret > 0)
1055 goto dump;
1056
1057 /* if last status dump was less than 500ms ago, do nothing */
1058 delay.tv_sec = 0;
1059 delay.tv_usec = 500 * 1000;
1060 tv_add(&last_status_dump, &delay, &tmp);
1061 if (tv_diff(now, &tmp, NULL) < 0)
1062 return 0;
1063
1064 /*
1065 * If last status dump was more than 5s ago, force update. Otherwise,
1066 * update only those items that have changed.
1067 */
1068 delay.tv_sec = 5;
1069 delay.tv_usec = 0;
1070 tv_add(&last_status_dump, &delay, &tmp);
1071 if (tv_diff(now, &tmp, NULL) < 0)
1072 force = false;
1073 dump:
1074 audiod_status_dump(force);
1075 last_status_dump = *now;
1076 return 1;
1077 }
1078
1079 static void init_command_task(struct command_task *ct)
1080 {
1081 ct->fd = audiod_get_socket(); /* doesn't return on errors */
1082
1083 ct->task = task_register(&(struct task_info) {
1084 .name = "command",
1085 .pre_select = command_pre_select,
1086 .post_select = command_post_select,
1087 .context = ct,
1088 }, &sched);
1089 }
1090
1091 static void close_stat_pipe(void)
1092 {
1093 if (!stat_task->ct)
1094 return;
1095 task_reap(&stat_task->ct->task);
1096 client_close(stat_task->ct);
1097 stat_task->ct = NULL;
1098 clear_and_dump_items();
1099 stat_task->length_seconds = 0;
1100 stat_task->offset_seconds = 0;
1101 stat_task->vss_status = 0;
1102 stat_task->current_audio_format_num = -1;
1103 audiod_status_dump(true);
1104 }
1105
1106 /* avoid busy loop if server is down */
1107 static void set_stat_task_restart_barrier(unsigned seconds)
1108 {
1109 struct timeval delay = {seconds, 0};
1110 tv_add(now, &delay, &stat_task->restart_barrier);
1111 }
1112
1113 static bool must_close_slot(int slot_num)
1114 {
1115 struct slot_info *s = &slot[slot_num];
1116 struct audio_format_info *a = afi + s->format;
1117 int i;
1118
1119 if (s->format < 0)
1120 return false;
1121 if (s->receiver_node && task_status(s->receiver_node->task) >= 0)
1122 return false;
1123 for (i = 0; i < a->num_filters; i++)
1124 if (s->fns && task_status(s->fns[i].task) >= 0)
1125 return false;
1126 if (a->num_writers > 0) {
1127 for (i = 0; i < a->num_writers; i++)
1128 if (s->wns && task_status(s->wns[i].task) >= 0)
1129 return false;
1130 } else {
1131 if (s->wns && task_status(s->wns[0].task) >= 0)
1132 return false;
1133 }
1134 return true;
1135 }
1136
1137 static void close_slot(int slot_num)
1138 {
1139 struct slot_info *s = slot + slot_num;
1140
1141 PARA_INFO_LOG("closing slot %d\n", slot_num);
1142 close_writers(s);
1143 close_filters(s);
1144 close_receiver(slot_num);
1145 clear_slot(slot_num);
1146 }
1147
1148 static void close_unused_slots(void)
1149 {
1150 int i;
1151
1152 FOR_EACH_SLOT(i)
1153 if (must_close_slot(i))
1154 close_slot(i);
1155 }
1156
1157 /*
1158 * Cleanup all resources.
1159 *
1160 * This performs various cleanups, removes the audiod socket and closes the
1161 * connection to para_server.
1162 */
1163 static void audiod_cleanup(void)
1164 {
1165 if (socket_name)
1166 unlink(socket_name);
1167 close_stat_pipe();
1168 close_unused_slots();
1169 audiod_cmdline_parser_free(&conf);
1170 close_stat_clients();
1171 }
1172
1173 /*
1174 * Check if any receivers/filters/writers need to be started and do so if
1175 * necessary.
1176 */
1177 static void start_stop_decoders(void)
1178 {
1179 int ret;
1180 struct slot_info *sl;
1181
1182 close_unused_slots();
1183 if (audiod_status != AUDIOD_ON ||
1184 !(stat_task->vss_status & VSS_STATUS_FLAG_PLAYING))
1185 return notify_receivers(E_NOT_PLAYING);
1186 if (!must_start_decoder())
1187 return;
1188 ret = open_receiver(stat_task->current_audio_format_num);
1189 if (ret < 0) {
1190 PARA_ERROR_LOG("%s\n", para_strerror(-ret));
1191 return;
1192 }
1193 sl = slot + ret;
1194 open_filters(sl);
1195 open_writers(sl);
1196 activate_grab_clients(&sched);
1197 btr_log_tree(sl->receiver_node->btrn, LL_NOTICE);
1198 }
1199
1200 static void status_pre_select(struct sched *s, void *context)
1201 {
1202 struct status_task *st = context;
1203 int i, ret, cafn = stat_task->current_audio_format_num;
1204
1205 if (must_start_decoder())
1206 goto min_delay;
1207 FOR_EACH_SLOT(i)
1208 if (must_close_slot(i))
1209 goto min_delay;
1210 ret = btr_node_status(st->btrn, st->min_iqs, BTR_NT_LEAF);
1211 if (ret > 0)
1212 goto min_delay;
1213 if (st->ct && audiod_status == AUDIOD_OFF)
1214 goto min_delay;
1215 if (!st->ct && audiod_status != AUDIOD_OFF)
1216 sched_request_barrier_or_min_delay(&st->restart_barrier, s);
1217 if (cafn >= 0)
1218 sched_request_barrier(&afi[cafn].restart_barrier, s);
1219 /*
1220 * If para_server is playing we'd like to have a smooth time display
1221 * even if we are running in standby mode. So we request a timeout that
1222 * expires at the next full second.
1223 */
1224 if (stat_task->vss_status & VSS_STATUS_FLAG_PLAYING)
1225 sched_request_timeout_ms(1000 - now->tv_usec / 1000, s);
1226 return;
1227 min_delay:
1228 sched_min_delay(s);
1229 }
1230
1231 /* restart the client task if necessary */
1232 static int status_post_select(struct sched *s, void *context)
1233 {
1234 struct status_task *st = context;
1235 int ret;
1236
1237 ret = task_get_notification(st->task);
1238 if (ret < 0)
1239 return ret;
1240 if (audiod_status == AUDIOD_OFF) {
1241 if (!st->ct)
1242 goto out;
1243 if (task_status(st->ct->task) >= 0) {
1244 task_notify(st->ct->task, E_AUDIOD_OFF);
1245 goto out;
1246 }
1247 close_stat_pipe();
1248 st->clock_diff_count = conf.clock_diff_count_arg;
1249 goto out;
1250 }
1251 if (st->ct) {
1252 char *buf;
1253 size_t sz;
1254
1255 ret = btr_node_status(st->btrn, st->min_iqs, BTR_NT_LEAF);
1256 if (ret < 0) {
1257 close_stat_pipe();
1258 goto out;
1259 }
1260 if (st->ct->status != CL_EXECUTING)
1261 goto out;
1262 if (ret == 0) {
1263 struct timeval diff;
1264 tv_diff(now, &st->last_status_read, &diff);
1265 if (diff.tv_sec > 61)
1266 task_notify(st->ct->task, E_STATUS_TIMEOUT);
1267 goto out;
1268 }
1269 btr_merge(st->btrn, st->min_iqs);
1270 sz = btr_next_buffer(st->btrn, &buf);
1271 ret = for_each_stat_item(buf, sz, update_item);
1272 if (ret < 0) {
1273 task_notify(st->ct->task, -ret);
1274 goto out;
1275 }
1276 if (sz != ret) {
1277 btr_consume(st->btrn, sz - ret);
1278 st->last_status_read = *now;
1279 st->min_iqs = 0;
1280 } else /* current status item crosses buffers */
1281 st->min_iqs = sz + 1;
1282 goto out;
1283 }
1284 btr_drain(st->btrn);
1285 st->current_audio_format_num = -1;
1286 if (tv_diff(now, &st->restart_barrier, NULL) < 0)
1287 goto out;
1288 if (st->clock_diff_count) { /* get status only one time */
1289 char *argv[] = {"audiod", "--", "stat", "-p", "-n=1", NULL};
1290 int argc = 5;
1291 PARA_INFO_LOG("clock diff count: %d\n", st->clock_diff_count);
1292 st->clock_diff_count--;
1293 client_open(argc, argv, &st->ct, NULL, NULL, st->btrn, s);
1294 set_stat_task_restart_barrier(2);
1295
1296 } else {
1297 char *argv[] = {"audiod", "--", "stat", "-p", NULL};
1298 int argc = 4;
1299 client_open(argc, argv, &st->ct, NULL, NULL, st->btrn, s);
1300 set_stat_task_restart_barrier(5);
1301 }
1302 free(stat_item_values[SI_BASENAME]);
1303 stat_item_values[SI_BASENAME] = para_strdup(
1304 "no connection to para_server");
1305 stat_client_write_item(SI_BASENAME);
1306 st->last_status_read = *now;
1307 out:
1308 start_stop_decoders();
1309 return 0;
1310 }
1311
1312 static void init_status_task(struct status_task *st)
1313 {
1314 memset(st, 0, sizeof(struct status_task));
1315 st->sa_time_diff_sign = 1;
1316 st->clock_diff_count = conf.clock_diff_count_arg;
1317 st->current_audio_format_num = -1;
1318 st->btrn = btr_new_node(&(struct btr_node_description)
1319 EMBRACE(.name = "stat"));
1320
1321 stat_task->task = task_register(&(struct task_info) {
1322 .name = "stat",
1323 .pre_select = status_pre_select,
1324 .post_select = status_post_select,
1325 .context = stat_task,
1326 }, &sched);
1327 }
1328
1329 static void set_initial_status(void)
1330 {
1331 audiod_status = AUDIOD_ON;
1332 if (!conf.mode_given)
1333 return;
1334 if (!strcmp(conf.mode_arg, "sb")) {
1335 audiod_status = AUDIOD_STANDBY;
1336 return;
1337 }
1338 if (!strcmp(conf.mode_arg, "off")) {
1339 audiod_status = AUDIOD_OFF;
1340 return;
1341 }
1342 if (strcmp(conf.mode_arg, "on"))
1343 PARA_WARNING_LOG("invalid mode\n");
1344 }
1345
1346 __noreturn static void print_help_and_die(void)
1347 {
1348 struct ggo_help h = DEFINE_GGO_HELP(audiod);
1349 bool d = conf.detailed_help_given;
1350 unsigned flags;
1351
1352 flags = d? GPH_STANDARD_FLAGS_DETAILED : GPH_STANDARD_FLAGS;
1353 ggo_print_help(&h, flags);
1354
1355 flags = d? GPH_MODULE_FLAGS_DETAILED : GPH_MODULE_FLAGS;
1356 print_receiver_helps(flags);
1357 print_filter_helps(flags);
1358 print_writer_helps(flags);
1359 exit(0);
1360 }
1361
1362 static void init_colors_or_die(void)
1363 {
1364 int i;
1365
1366 if (!want_colors())
1367 return;
1368 daemon_set_default_log_colors();
1369 daemon_set_flag(DF_COLOR_LOG);
1370 for (i = 0; i < conf.log_color_given; i++)
1371 daemon_set_log_color_or_die(conf.log_color_arg[i]);
1372 }
1373
1374 /**
1375 * the main function of para_audiod
1376 *
1377 * \param argc usual argument count
1378 * \param argv usual argument vector
1379 *
1380 * \return EXIT_SUCCESS or EXIT_FAILURE
1381 *
1382 * \sa para_audiod(1)
1383 * */
1384 int main(int argc, char *argv[])
1385 {
1386 int ret, i;
1387 struct command_task command_task_struct, *cmd_task = &command_task_struct;
1388 struct audiod_cmdline_parser_params params = {
1389 .override = 0,
1390 .initialize = 1,
1391 .check_required = 0,
1392 .check_ambiguity = 0,
1393 .print_errors = 1
1394 };
1395
1396 valid_fd_012();
1397 audiod_cmdline_parser_ext(argc, argv, &conf, &params);
1398 daemon_set_loglevel(conf.loglevel_arg);
1399 version_handle_flag("audiod", conf.version_given);
1400 /* init receivers/filters/writers early to make help work */
1401 recv_init();
1402 filter_init();
1403 writer_init();
1404 if (conf.help_given || conf.detailed_help_given)
1405 print_help_and_die();
1406 daemon_drop_privileges_or_die(conf.user_arg, conf.group_arg);
1407 parse_config_or_die();
1408 init_colors_or_die();
1409 init_random_seed_or_die();
1410 daemon_set_flag(DF_LOG_TIME);
1411 daemon_set_flag(DF_LOG_HOSTNAME);
1412 daemon_set_flag(DF_LOG_LL);
1413 if (conf.log_timing_given)
1414 daemon_set_flag(DF_LOG_TIMING);
1415 if (conf.logfile_given) {
1416 daemon_set_logfile(conf.logfile_arg);
1417 daemon_open_log_or_die();
1418 }
1419 ret = parse_stream_args();
1420 if (ret < 0) {
1421 PARA_EMERG_LOG("%s\n", para_strerror(-ret));
1422 exit(EXIT_FAILURE);
1423 }
1424 daemon_log_welcome("para_audiod");
1425 daemon_set_start_time();
1426 set_initial_status();
1427 FOR_EACH_SLOT(i)
1428 clear_slot(i);
1429 setup_signal_handling();
1430
1431 init_status_task(stat_task);
1432 init_command_task(cmd_task);
1433
1434 if (conf.daemon_given)
1435 daemonize(false /* parent exits immediately */);
1436
1437 sig_task->task = task_register(&(struct task_info) {
1438 .name = "signal",
1439 .pre_select = signal_pre_select,
1440 .post_select = signal_post_select,
1441 .context = sig_task,
1442 }, &sched);
1443
1444 sched.default_timeout.tv_sec = 2;
1445 sched.default_timeout.tv_usec = 999 * 1000;
1446 ret = schedule(&sched);
1447 audiod_cleanup();
1448 sched_shutdown(&sched);
1449
1450 if (ret < 0)
1451 PARA_EMERG_LOG("%s\n", para_strerror(-ret));
1452 return ret < 0? EXIT_FAILURE : EXIT_SUCCESS;
1453 }