X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=audiod.h;h=856bc05126dbcb54a24a311a2f0eb19b42060d95;hp=7e2e2769985f08efcf3227db068e2d7b155ab564;hb=98d0c34a0377546a4ed0062ad32e8161d611d6e6;hpb=7d1805d1559e08e0af701155574aef220925d411

diff --git a/audiod.h b/audiod.h
index 7e2e2769..856bc051 100644
--- a/audiod.h
+++ b/audiod.h
@@ -1,15 +1,16 @@
 /** \file audiod.h symbols exported from audiod.c */
 int num_filters(int audio_format_num);
 int get_audio_format_num(char *name);
-enum {
-	AUDIO_FORMAT_MP3,
-	AUDIO_FORMAT_OGG,
-	AUDIO_FORMAT_AAC,
-	NUM_AUDIO_FORMATS
-};
+
+/** enum of audio formats supported by para_audiod */
+enum {AUDIOD_AUDIO_FORMATS_ENUM};
+
+/** array of audio format names supported by para_audiod */
 extern const char *audio_formats[];
-#define DEFINE_AUDIO_FORMAT_ARRAY const char *audio_formats[] = {"mp3", "ogg", "aac", NULL}
+
+/** maximal number of simultaneous instances */
 #define MAX_STREAM_SLOTS 5
+
 /**
  * the possible modes of operation
  *
@@ -37,6 +38,7 @@ struct slot_info {
 	/** the active writer node group */
 	struct writer_node_group *wng;
 };
+
 /**
  * the main task of audiod
  *
@@ -46,39 +48,46 @@ struct audiod_task {
 	struct timeval *now;
 	struct task task;
 };
+
 /**
  * the task for audiod's child (para_client stat)
  *
  * \sa struct task, struct sched
  */
 struct status_task {
-	/** the output of the stat command is read from this fd */
-	int fd;
-	/** stat data is stored here */
-	char buf[STRINGSIZE];
-	/** number of bytes loaded in \a buf */
-	unsigned loaded;
-	/** the associated task structure */
+	/** the associated task structure of audiod */
 	struct task task;
+	struct private_client_data *pcd;
+	/** the array of status items sent by para_server */
+	char *stat_item_values[NUM_STAT_ITEMS];
 	/** do not restart client command until this time */
 	struct timeval restart_barrier;
-	int playing;
+	/** last time we received status data from para_server */
+	struct timeval last_status_read;
+	/** the offset value announced by para_server */
 	int offset_seconds;
+	/** the length of the current audio file as announced by para_server */
 	int length_seconds;
-	int sa_time_diff_sign;
-	char *stat_item_values[NUM_STAT_ITEMS];
+	/** the start of the current stream from the view of para_server */
 	struct timeval server_stream_start;
+	/** the averaged time deviation between para_server and para_audiod */
 	struct timeval sa_time_diff;
+	/** whether client time is ahead of server time */
+	int sa_time_diff_sign;
+	/** non-zero if \a af_status is "playing" */
+	int playing;
 };
+
 extern struct status_task *stat_task;
 extern struct slot_info slot[MAX_STREAM_SLOTS];
-extern struct gengetopt_args_info conf;
+extern struct audiod_args_info conf;
 extern int audiod_status;
 extern const char *status_item_list[NUM_STAT_ITEMS];
 
 void __noreturn clean_exit(int status, const char *msg);
 int handle_connect(int accept_fd);
 void audiod_status_dump(void);
+void dump_empty_status(void);
 
 /** iterate over all slots */
 #define FOR_EACH_SLOT(_slot) for (_slot = 0; _slot < MAX_STREAM_SLOTS; _slot++)