* AUTHORS: Add Richard D. Worth

[ttt] / src / ttt-server.h

diff --git a/src/ttt-server.h b/src/ttt-server.h
index 7cf3d9707ecc95aec9bbfa8e02dc8a20ea9d1137..fef70308dbb59b91df593de7b7fc39c2ba1d85e3 100644 (file)
--- a/src/ttt-server.h
+++ b/src/ttt-server.h
@@ -59,6 +59,20 @@ ttt_server_unregister_client (ttt_server_t *server, ttt_client_t *client);
 void
 ttt_server_broadcast (ttt_server_t *server, const char *message);
 
 void
 ttt_server_broadcast (ttt_server_t *server, const char *message);
 

+
+/* Returns the WHO response. The return string is allocated in this
+ * function and will need to be free'd by the caller.
+ *
+ * Locking: The server mutex will be acquired and held throughout the
+ * execution of this function. Each client mutex may also be acquired
+ * and held by functions called during the execution of this function.
+ *
+ * Errors: If an error such as an IO error occurs, this function will
+ * not return.
+ */
+const char*
+ttt_server_who (ttt_server_t *server);
+

 /* Gets the server hostname.
  *
  */
 /* Gets the server hostname.
  *
  */