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