X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=server.h;h=8de691ca321bd49db2d7c25398537f31b7d03a0c;hp=a814aff07d0285aa666872b5158ea3f278b41faf;hb=b2e4347baf722d13e4936cf2138750f05c43c3da;hpb=d5d96c6c65b47a34136bc04420bffd38e947bfea

diff --git a/server.h b/server.h
index a814aff0..8de691ca 100644
--- a/server.h
+++ b/server.h
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 1997-2009 Andre Noll <maan@systemlinux.org>
+ * Copyright (C) 1997 Andre Noll <maan@tuebingen.mpg.de>
  *
  * Licensed under the GPL v2. For licencing details see COPYING.
  */
@@ -10,12 +10,12 @@
 #define MMD_INFO_SIZE 16384
 
 /** The maximum length of the host component in an URL */
-#define MAX_HOSTLEN	256
+#define MAX_HOSTLEN 256
 
 
-/** Holds the arguments for the para_server's sender command. */
-struct sender_command_data{
-	/** Greater than 0 indicates that a sender cmd is already queued. */
+/** Arguments for the sender command. */
+struct sender_command_data {
+	/** Greater than zero indicates that a sender cmd is already queued. */
 	int cmd_num;
 	/** The number of the sender in question. */
 	int sender_num;
@@ -34,35 +34,31 @@ struct sender_command_data{
 };
 
 /**
- * Used for parent-child communication.
+ * Miscellaneous data for communication between server and command handlers.
  *
- * There's only one struct of this type which lives in shared memory
- * for communication between the server instances. Access to this
- * area is serialized via mmd_lock() and mmd_unlock(). There are two
- * reasons for a variable to be included here:
+ * There's only one instance of this structure which lives in a shared memory
+ * area. Command handlers communicate with the server process through this
+ * area. Changes made by the command handlers stay after the command handler
+ * exits. Conversely, changes made by the server process propagate to the
+ * command handlers. Access to this area is serialized via mmd_lock() and
+ * mmd_unlock().
  *
- *  	- At least one command (i.e. child of the server) must be able to
- *  	change its value.
- *
- * or
- *
- *	- The contents are listed in the stat command and have to be up to
- *	date.
+ * There are two reasons for a variable to be included here: (a) at least one
+ * command handler changes its value, or (b) updates by the server must
+ * propagate to the stat command handlers.
  */
 struct misc_meta_data {
 	/** The size of the current audio file in bytes. */
 	size_t size;
-	/** The last modification time of the current audio file. */
-	time_t mtime;
 	/** The "old" status flags -- commands may only read them. */
 	unsigned int vss_status_flags;
 	/** The new status flags -- commands may set them. */
 	unsigned int new_vss_status_flags;
-	/** The number of data chunks sent for the current audio file. */
+	/** The number of data chunks sent so far. */
 	long unsigned chunks_sent;
 	/** Set by the jmp/ff commands to the new position in chunks. */
 	long unsigned repos_request;
-	/** The number of the chunk currently sent out. */
+	/** The number of the chunk currently being sent. */
 	long unsigned current_chunk;
 	/** The milliseconds that have been skipped of the current audio file. */
 	long offset;
@@ -71,8 +67,8 @@ struct misc_meta_data {
 	/**
 	 * The event counter.
 	 *
-	 * Commands may increase this to force a status update to be sent to all
-	 * connected clients.
+	 * Commands may increase this to force a status update to be sent to
+	 * all connected stat clients.
 	 */
 	unsigned int events;
 	/** The number of audio files already sent. */
@@ -98,3 +94,4 @@ extern struct server_args_info conf;
 
 __noreturn void handle_connect(int fd, const char *peername);
 void parse_config_or_die(int override);
+char *server_get_tasks(void);