audiod.h

   1 /*
   2  * Copyright (C) 2006-2009 Andre Noll <maan@systemlinux.org>
   3  *
   4  * Licensed under the GPL v2. For licencing details see COPYING.
   5  */
   6
   7 /** \file audiod.h symbols exported from audiod.c */
   8
   9
  10 int num_filters(int audio_format_num);
  11 int get_audio_format_num(const char *name);
  12
  13 /** enum of audio formats supported by para_audiod */
  14 enum {AUDIOD_AUDIO_FORMATS_ENUM};
  15
  16 /** array of audio format names supported by para_audiod */
  17 extern const char *audio_formats[];
  18
  19 /** maximal number of simultaneous instances */
  20 #define MAX_STREAM_SLOTS 5
  21
  22 /**
  23  * the possible modes of operation
  24  *
  25  * - off: disconnect from para_server
  26  * - on: receive status information from para_server and play the audio stream
  27  * - sb: only receive status information but not the audio stream
  28  */
  29 enum audiod_status_info {AUDIOD_OFF, AUDIOD_ON, AUDIOD_STANDBY};
  30
  31 /** defines one command of para_audiod */
  32 struct audiod_command {
  33         /** the name of the command */
  34         const char *name;
  35         /** pointer to the function that handles the command */
  36         int (*handler)(int, int, char**);
  37         /** one-line description of the command */
  38         const char *description;
  39         /** summary of the command line options */
  40         const char *usage;
  41         /** the long help text */
  42         const char *help;
  43 };
  44
  45 /**
  46  * Describes one instance of a receiver-filter-writer chain.
  47  *
  48  * \sa receiver_node, receiver, filter, filter_node, filter_chain, writer,
  49  * writer_node, writer_node_group.
  50  */
  51 struct slot_info {
  52         /** Number of the audio format in this slot. */
  53         int format;
  54         /** Receiver start time. */
  55         struct timeval rstime;
  56         /** Writer start time. */
  57         struct timeval wstime;
  58         /** The stream_start status item announced by para_server.  */
  59         struct timeval server_stream_start;
  60         /** The offset status item announced by para_server. */
  61         unsigned offset_seconds;
  62         /** The seconds_total status item announced by para_server. */
  63         unsigned seconds_total;
  64         /** The receiver info associated with this slot. */
  65         struct receiver_node *receiver_node;
  66         /** The active filter chain. */
  67         struct filter_chain *fc;
  68         /** The active writer node group. */
  69         struct writer_node_group *wng;
  70 };
  71
  72 extern struct slot_info slot[MAX_STREAM_SLOTS];
  73 extern struct audiod_args_info conf;
  74 extern int audiod_status;
  75
  76 void __noreturn clean_exit(int status, const char *msg);
  77 int handle_connect(int accept_fd);
  78 void audiod_status_dump(void);
  79 char *get_time_string(int slot_num);
  80
  81 void stat_client_write_item(int item_num);
  82 void clear_and_dump_items(void);
  83
  84 /** iterate over all slots */
  85 #define FOR_EACH_SLOT(_slot) for (_slot = 0; _slot < MAX_STREAM_SLOTS; _slot++)