X-Git-Url: https://plomlompom.com/repos/foo.html?a=blobdiff_plain;f=src%2Fserver%2Frun.h;h=6b823c4b713d27f688e30924a217af3dc816f530;hb=d304b75ee742d50b6cfa9ad81c44d37fb84a4b5a;hp=877d2fb2b263d2b28ff73aab121661104bc3e539;hpb=dd9d65ee727ac7e95801da0f8b5bae7009811802;p=plomrogue
diff --git a/src/server/run.h b/src/server/run.h
index 877d2fb..6b823c4 100644
--- a/src/server/run.h
+++ b/src/server/run.h
@@ -10,14 +10,25 @@
-/* Try parsing "msg" into a server or player command to run. Player commands are
- * are recorded into the record file at world.path_record if "do_record" is set.
+/* Record save and record file data. Both are only written if "force" is set, or
+ * on the first run with unset "force", or if 15 seconds have passed since the
+ * last file writing. "msg" is appended to the record file if it is set.
*/
-extern void obey_msg(char * msg, uint8_t do_record);
+extern void record(char * msg, uint8_t force);
+
+/* Try parsing "msg" into a command to apply, and apply it. Output commands to
+ * stdout if "do_verbose" and world.is_verbose are set. If "do_record" is set,
+ * record commands to record file, and run save_world() if the last call to it
+ * via this function has not happened yet or is at least one minute in the past.
+ */
+extern void obey_msg(char * msg, uint8_t do_record, uint8_t do_verbose);
/* Loop for receiving commands via io_round() and acting on them. Exits with 1
* on "QUIT" command. In replay mode, exits with 0 on each non-"QUIT" command.
- * In play mode, processes incomming commands via obey_msg().
+ * Writes a "PONG" line to server output file on "PING" command. In play mode,
+ * processes further incomming commands via obey_msg(). Compares the first line
+ * of the server out file with world.server_test to ensure that the current
+ * server process has not been superseded by a new one.
*/
extern uint8_t io_loop();