2 Copyright (C) 1996-1997 Id Software, Inc.
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 See the GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 // host.c -- coordinates spawning and killing of local servers
26 #include "taskqueue.h"
31 A server can always be started, even if the system started out as a client
34 A client can NOT be started if the system started as a dedicated server.
36 Memory is cleared / released when a server or client begins, not when they end.
42 // pretend frames take this amount of time (in seconds), 0 = realtime
43 cvar_t host_framerate = {CF_CLIENT | CF_SERVER, "host_framerate","0", "locks frame timing to this value in seconds, 0.05 is 20fps for example, note that this can easily run too fast, use cl_maxfps if you want to limit your framerate instead, or sys_ticrate to limit server speed"};
44 cvar_t cl_maxphysicsframesperserverframe = {CF_CLIENT, "cl_maxphysicsframesperserverframe","10", "maximum number of physics frames per server frame"};
45 // shows time used by certain subsystems
46 cvar_t host_speeds = {CF_CLIENT | CF_SERVER, "host_speeds","0", "reports how much time is used in server/graphics/sound"};
47 cvar_t host_maxwait = {CF_CLIENT | CF_SERVER, "host_maxwait","1000", "maximum sleep time requested from the operating system in millisecond. Larger sleeps will be done using multiple host_maxwait length sleeps. Lowering this value will increase CPU load, but may help working around problems with accuracy of sleep times."};
49 cvar_t developer = {CF_CLIENT | CF_SERVER | CF_ARCHIVE, "developer","0", "shows debugging messages and information (recommended for all developers and level designers); the value -1 also suppresses buffering and logging these messages"};
50 cvar_t developer_extra = {CF_CLIENT | CF_SERVER, "developer_extra", "0", "prints additional debugging messages, often very verbose!"};
51 cvar_t developer_insane = {CF_CLIENT | CF_SERVER, "developer_insane", "0", "prints huge streams of information about internal workings, entire contents of files being read/written, etc. Not recommended!"};
52 cvar_t developer_loadfile = {CF_CLIENT | CF_SERVER, "developer_loadfile","0", "prints name and size of every file loaded via the FS_LoadFile function (which is almost everything)"};
53 cvar_t developer_loading = {CF_CLIENT | CF_SERVER, "developer_loading","0", "prints information about files as they are loaded or unloaded successfully"};
54 cvar_t developer_entityparsing = {CF_CLIENT, "developer_entityparsing", "0", "prints detailed network entities information each time a packet is received"};
56 cvar_t timestamps = {CF_CLIENT | CF_SERVER | CF_ARCHIVE, "timestamps", "0", "prints timestamps on console messages"};
57 cvar_t timeformat = {CF_CLIENT | CF_SERVER | CF_ARCHIVE, "timeformat", "[%Y-%m-%d %H:%M:%S] ", "time format to use on timestamped console messages"};
59 cvar_t sessionid = {CF_CLIENT | CF_SERVER | CF_READONLY, "sessionid", "", "ID of the current session (use the -sessionid parameter to set it); this is always either empty or begins with a dot (.)"};
60 cvar_t locksession = {CF_CLIENT | CF_SERVER, "locksession", "0", "Lock the session? 0 = no, 1 = yes and abort on failure, 2 = yes and continue on failure"};
62 cvar_t host_isclient = {CF_SHARED | CF_READONLY, "_host_isclient", "0", "If 1, clientside is active."};
66 Host_AbortCurrentFrame
68 aborts the current host frame and goes on with the next one
71 void Host_AbortCurrentFrame(void) DP_FUNC_NORETURN;
72 void Host_AbortCurrentFrame(void)
74 // in case we were previously nice, make us mean again
75 Sys_MakeProcessMean();
77 longjmp (host.abortframe, 1);
84 This shuts down both the client and server
87 void Host_Error (const char *error, ...)
89 static char hosterrorstring1[MAX_INPUTLINE]; // THREAD UNSAFE
90 static char hosterrorstring2[MAX_INPUTLINE]; // THREAD UNSAFE
91 static qbool hosterror = false;
94 // turn off rcon redirect if it was active when the crash occurred
95 // to prevent loops when it is a networking problem
96 Con_Rcon_Redirect_Abort();
98 va_start (argptr,error);
99 dpvsnprintf (hosterrorstring1,sizeof(hosterrorstring1),error,argptr);
102 Con_Printf(CON_ERROR "Host_Error: %s\n", hosterrorstring1);
104 // LadyHavoc: if crashing very early, or currently shutting down, do
106 if (host.framecount < 3 || host.state == host_shutdown)
107 Sys_Error ("Host_Error: %s", hosterrorstring1);
110 Sys_Error ("Host_Error: recursively entered (original error was: %s new error is: %s)", hosterrorstring2, hosterrorstring1);
113 strlcpy(hosterrorstring2, hosterrorstring1, sizeof(hosterrorstring2));
115 CL_Parse_DumpPacket();
117 CL_Parse_ErrorCleanUp();
121 // print out where the crash happened, if it was caused by QC (and do a cleanup)
122 PRVM_Crash(SVVM_prog);
123 PRVM_Crash(CLVM_prog);
125 PRVM_Crash(MVM_prog);
128 Cvar_SetValueQuick(&csqc_progcrc, -1);
129 Cvar_SetValueQuick(&csqc_progsize, -1);
131 SV_LockThreadMutex();
133 SV_UnlockThreadMutex();
135 if (cls.state == ca_dedicated)
136 Sys_Error ("Host_Error: %s",hosterrorstring2); // dedicated servers exit
143 Host_AbortCurrentFrame();
151 static void Host_Quit_f(cmd_state_t *cmd)
153 if(host.state == host_shutdown)
154 Con_Printf("shutting down already!\n");
156 host.state = host_shutdown;
159 static void Host_Version_f(cmd_state_t *cmd)
161 Con_Printf("Version: %s build %s\n", gamename, buildstring);
164 static void Host_Framerate_c(cvar_t *var)
166 if (var->value < 0.00001 && var->value != 0)
167 Cvar_SetValueQuick(var, 0);
170 // TODO: Find a better home for this.
171 static void SendCvar_f(cmd_state_t *cmd)
173 if(cmd->source == src_local && host.hook.SV_SendCvar)
175 host.hook.SV_SendCvar(cmd);
178 if(cmd->source == src_client && host.hook.CL_SendCvar)
180 host.hook.CL_SendCvar(cmd);
186 =======================
188 ======================
190 void Host_SaveConfig_f(cmd_state_t *cmd);
191 void Host_LoadConfig_f(cmd_state_t *cmd);
192 extern cvar_t sv_writepicture_quality;
193 extern cvar_t r_texture_jpeg_fastpicmip;
194 static void Host_InitLocal (void)
196 Cmd_AddCommand(CF_SHARED, "quit", Host_Quit_f, "quit the game");
197 Cmd_AddCommand(CF_SHARED, "version", Host_Version_f, "print engine version");
198 Cmd_AddCommand(CF_SHARED, "saveconfig", Host_SaveConfig_f, "save settings to config.cfg (or a specified filename) immediately (also automatic when quitting)");
199 Cmd_AddCommand(CF_SHARED, "loadconfig", Host_LoadConfig_f, "reset everything and reload configs");
200 Cmd_AddCommand(CF_SHARED, "sendcvar", SendCvar_f, "sends the value of a cvar to the server as a sentcvar command, for use by QuakeC");
201 Cvar_RegisterVariable (&cl_maxphysicsframesperserverframe);
202 Cvar_RegisterVariable (&host_framerate);
203 Cvar_RegisterCallback (&host_framerate, Host_Framerate_c);
204 Cvar_RegisterVariable (&host_speeds);
205 Cvar_RegisterVariable (&host_maxwait);
206 Cvar_RegisterVariable (&host_isclient);
208 Cvar_RegisterVariable (&developer);
209 Cvar_RegisterVariable (&developer_extra);
210 Cvar_RegisterVariable (&developer_insane);
211 Cvar_RegisterVariable (&developer_loadfile);
212 Cvar_RegisterVariable (&developer_loading);
213 Cvar_RegisterVariable (&developer_entityparsing);
215 Cvar_RegisterVariable (×tamps);
216 Cvar_RegisterVariable (&timeformat);
218 Cvar_RegisterVariable (&sv_writepicture_quality);
219 Cvar_RegisterVariable (&r_texture_jpeg_fastpicmip);
227 Writes key bindings and archived cvars to config.cfg
230 static void Host_SaveConfig_to(const char *file)
234 // dedicated servers initialize the host but don't parse and set the
236 // LadyHavoc: don't save a config if it crashed in startup
237 if (host.framecount >= 3 && cls.state != ca_dedicated && !Sys_CheckParm("-benchmark") && !Sys_CheckParm("-capturedemo"))
239 f = FS_OpenRealFile(file, "wb", false);
242 Con_Printf(CON_ERROR "Couldn't write %s.\n", file);
246 Key_WriteBindings (f);
247 Cvar_WriteVariables (&cvars_all, f);
252 void Host_SaveConfig(void)
254 Host_SaveConfig_to(CONFIGFILENAME);
256 void Host_SaveConfig_f(cmd_state_t *cmd)
258 const char *file = CONFIGFILENAME;
260 if(Cmd_Argc(cmd) >= 2) {
261 file = Cmd_Argv(cmd, 1);
262 Con_Printf("Saving to %s\n", file);
265 Host_SaveConfig_to(file);
268 static void Host_AddConfigText(cmd_state_t *cmd)
270 // set up the default startmap_sp and startmap_dm aliases (mods can
271 // override these) and then execute the quake.rc startup script
272 if (gamemode == GAME_NEHAHRA)
273 Cbuf_InsertText(cmd, "alias startmap_sp \"map nehstart\"\nalias startmap_dm \"map nehstart\"\nexec " STARTCONFIGFILENAME "\n");
274 else if (gamemode == GAME_TRANSFUSION)
275 Cbuf_InsertText(cmd, "alias startmap_sp \"map e1m1\"\n""alias startmap_dm \"map bb1\"\nexec " STARTCONFIGFILENAME "\n");
276 else if (gamemode == GAME_TEU)
277 Cbuf_InsertText(cmd, "alias startmap_sp \"map start\"\nalias startmap_dm \"map start\"\nexec teu.rc\n");
279 Cbuf_InsertText(cmd, "alias startmap_sp \"map start\"\nalias startmap_dm \"map start\"\nexec " STARTCONFIGFILENAME "\n");
280 Cbuf_Execute(cmd->cbuf);
287 Resets key bindings and cvars to defaults and then reloads scripts
290 void Host_LoadConfig_f(cmd_state_t *cmd)
292 // reset all cvars, commands and aliases to init values
293 Cmd_RestoreInitState();
295 // prepend a menu restart command to execute after the config
296 Cbuf_InsertText(cmd_client, "\nmenu_restart\n");
298 // reset cvars to their defaults, and then exec startup scripts again
299 Host_AddConfigText(cmd_client);
302 //============================================================================
306 Host_GetConsoleCommands
308 Add them exactly as if they had been typed at the console
311 static void Host_GetConsoleCommands (void)
315 while ((line = Sys_ConsoleInput()))
317 if (cls.state == ca_dedicated)
318 Cbuf_AddText(cmd_server, line);
320 Cbuf_AddText(cmd_client, line);
328 Returns a time report string, for example for
331 const char *Host_TimingReport(char *buf, size_t buflen)
333 return va(buf, buflen, "%.1f%% CPU, %.2f%% lost, offset avg %.1fms, max %.1fms, sdev %.1fms", svs.perf_cpuload * 100, svs.perf_lost * 100, svs.perf_offset_avg * 1000, svs.perf_offset_max * 1000, svs.perf_offset_sdev * 1000);
340 Runs all active servers
343 static void Host_Init(void);
344 double Host_Frame(double time)
350 TaskQueue_Frame(false);
352 // keep the random time dependent, but not when playing demos/benchmarking
353 if(!*sv_random_seed.string && !host.restless)
356 NetConn_UpdateSockets();
358 Log_DestBuffer_Flush();
362 // check for commands typed to the host
363 Host_GetConsoleCommands();
365 // process console commands
366 // R_TimeReport("preconsole");
368 Cbuf_Frame(host.cbuf);
370 // R_TimeReport("console");
372 //Con_Printf("%6.0f %6.0f\n", cl_timer * 1000000.0, sv_timer * 1000000.0);
376 sv_timer = SV_Frame(time);
377 cl_timer = CL_Frame(time);
379 Mem_CheckSentinelsGlobal();
381 // if the accumulators haven't become positive yet, wait a while
382 if (cls.state == ca_dedicated)
383 wait = sv_timer * -1000000.0; // dedicated
384 else if (!sv.active || svs.threaded)
385 wait = cl_timer * -1000000.0; // connected to server, main menu, or server is on different thread
387 wait = max(cl_timer, sv_timer) * -1000000.0; // listen server or singleplayer
389 if (!host.restless && wait >= 1)
395 static inline void Host_Sleep(double time)
399 if(host_maxwait.value <= 0)
400 time = min(time, 1000000.0);
402 time = min(time, host_maxwait.value * 1000.0);
404 time = 1; // because we cast to int
406 time0 = Sys_DirtyTime();
407 if (sv_checkforpacketsduringsleep.integer && !sys_usenoclockbutbenchmark.integer && !svs.threaded) {
408 NetConn_SleepMicroseconds((int)time);
409 if (cls.state != ca_dedicated)
410 NetConn_ClientFrame(); // helps server browser get good ping values
411 // TODO can we do the same for ServerFrame? Probably not.
414 Sys_Sleep((int)time);
415 delta = Sys_DirtyTime() - time0;
416 if (delta < 0 || delta >= 1800)
418 host.sleeptime += delta;
419 // R_TimeReport("sleep");
423 // Cloudwalk: Most overpowered function declaration...
424 static inline double Host_UpdateTime (double newtime, double oldtime)
426 double time = newtime - oldtime;
430 // warn if it's significant
432 Con_Printf(CON_WARN "Host_UpdateTime: time stepped backwards (went from %f to %f, difference %f)\n", oldtime, newtime, time);
435 else if (time >= 1800)
437 Con_Printf(CON_WARN "Host_UpdateTime: time stepped forward (went from %f to %f, difference %f)\n", oldtime, newtime, time);
446 double time, newtime, oldtime, sleeptime;
448 Host_Init(); // Start!
451 oldtime = Sys_DirtyTime();
454 while(host.state != host_shutdown)
456 // Something bad happened, or the server disconnected
457 if (setjmp(host.abortframe))
459 host.state = host_active; // In case we were loading
463 newtime = host.dirtytime = Sys_DirtyTime();
464 host.realtime += time = Host_UpdateTime(newtime, oldtime);
466 sleeptime = Host_Frame(time);
471 Host_Sleep(sleeptime);
481 //============================================================================
483 char engineversion[128];
485 qbool sys_nostdout = false;
487 static qfile_t *locksession_fh = NULL;
488 static qbool locksession_run = false;
489 static void Host_InitSession(void)
493 Cvar_RegisterVariable(&sessionid);
494 Cvar_RegisterVariable(&locksession);
496 // load the session ID into the read-only cvar
497 if ((i = Sys_CheckParm("-sessionid")) && (i + 1 < sys.argc))
499 if(sys.argv[i+1][0] == '.')
500 Cvar_SetQuick(&sessionid, sys.argv[i+1]);
503 buf = (char *)Z_Malloc(strlen(sys.argv[i+1]) + 2);
504 dpsnprintf(buf, sizeof(buf), ".%s", sys.argv[i+1]);
505 Cvar_SetQuick(&sessionid, buf);
509 void Host_LockSession(void)
513 locksession_run = true;
514 if(locksession.integer != 0 && !Sys_CheckParm("-readonly"))
517 char *p = va(vabuf, sizeof(vabuf), "%slock%s", *fs_userdir ? fs_userdir : fs_basedir, sessionid.string);
519 locksession_fh = FS_SysOpen(p, "wl", false);
520 // TODO maybe write the pid into the lockfile, while we are at it? may help server management tools
523 if(locksession.integer == 2)
525 Con_Printf(CON_WARN "WARNING: session lock %s could not be acquired. Please run with -sessionid and an unique session name. Continuing anyway.\n", p);
529 Sys_Error("session lock %s could not be acquired. Please run with -sessionid and an unique session name.\n", p);
534 void Host_UnlockSession(void)
538 locksession_run = false;
542 FS_Close(locksession_fh);
543 // NOTE: we can NOT unlink the lock here, as doing so would
544 // create a race condition if another process created it
545 // between our close and our unlink
546 locksession_fh = NULL;
555 static void Host_Init (void)
561 host.hook.ConnectLocal = NULL;
562 host.hook.Disconnect = NULL;
563 host.hook.ToggleMenu = NULL;
564 host.hook.CL_Intermission = NULL;
565 host.hook.SV_CanSave = NULL;
567 host.state = host_init;
569 if (setjmp(host.abortframe)) // Huh?!
570 Sys_Error("Engine initialization failed. Check the console (if available) for additional information.\n");
572 if (Sys_CheckParm("-profilegameonly"))
573 Sys_AllowProfiling(false);
575 // LadyHavoc: quake never seeded the random number generator before... heh
576 if (Sys_CheckParm("-benchmark"))
577 srand(0); // predictable random sequence for -benchmark
579 srand((unsigned int)time(NULL));
581 // FIXME: this is evil, but possibly temporary
582 // LadyHavoc: doesn't seem very temporary...
583 // LadyHavoc: made this a saved cvar
584 // COMMANDLINEOPTION: Console: -developer enables warnings and other notices (RECOMMENDED for mod developers)
585 if (Sys_CheckParm("-developer"))
587 developer.value = developer.integer = 1;
588 developer.string = "1";
591 if (Sys_CheckParm("-developer2") || Sys_CheckParm("-developer3"))
593 developer.value = developer.integer = 1;
594 developer.string = "1";
595 developer_extra.value = developer_extra.integer = 1;
596 developer_extra.string = "1";
597 developer_insane.value = developer_insane.integer = 1;
598 developer_insane.string = "1";
599 developer_memory.value = developer_memory.integer = 1;
600 developer_memory.string = "1";
601 developer_memorydebug.value = developer_memorydebug.integer = 1;
602 developer_memorydebug.string = "1";
605 if (Sys_CheckParm("-developer3"))
607 gl_paranoid.integer = 1;gl_paranoid.string = "1";
608 gl_printcheckerror.integer = 1;gl_printcheckerror.string = "1";
611 // COMMANDLINEOPTION: Console: -nostdout disables text output to the terminal the game was launched from
612 if (Sys_CheckParm("-nostdout"))
615 // initialize console command/cvar/alias/command execution systems
618 // initialize memory subsystem cvars/commands
619 Memory_Init_Commands();
621 // initialize console and logging and its cvars/commands
624 // initialize various cvars that could not be initialized earlier
626 Curl_Init_Commands();
630 // initialize filesystem (including fs_basedir, fs_gamedir, -game, scr_screenshot_name)
633 // construct a version string for the corner of the console
635 dpsnprintf (engineversion, sizeof (engineversion), "%s %s %s", gamename, os, buildstring);
636 Con_Printf("%s\n", engineversion);
638 // initialize process nice level
639 Sys_InitProcessNice();
641 // initialize ixtable
644 // register the cvars for session locking
647 // must be after FS_Init
649 Crypto_Init_Commands();
664 // save off current state of aliases, commands and cvars for later restore if FS_GameDir_f is called
665 // NOTE: menu commands are freed by Cmd_RestoreInitState
668 // FIXME: put this into some neat design, but the menu should be allowed to crash
669 // without crashing the whole game, so this should just be a short-time solution
671 // here comes the not so critical stuff
673 Host_AddConfigText(cmd_client);
675 // if quake.rc is missing, use default
676 if (!FS_FileExists("quake.rc"))
678 Cbuf_AddText(cmd_client, "exec default.cfg\nexec " CONFIGFILENAME "\nexec autoexec.cfg\n");
679 Cbuf_Execute(cmd_client->cbuf);
682 host.state = host_active;
688 // put up the loading image so the user doesn't stare at a black screen...
689 SCR_BeginLoadingPlaque(true);
691 if (cls.state != ca_dedicated)
694 // check for special benchmark mode
695 // COMMANDLINEOPTION: Client: -benchmark <demoname> runs a timedemo and quits, results of any timedemo can be found in gamedir/benchmark.log (for example id1/benchmark.log)
696 i = Sys_CheckParm("-benchmark");
697 if (i && i + 1 < sys.argc)
698 if (!sv.active && !cls.demoplayback && !cls.connect_trying)
700 Cbuf_AddText(cmd_client, va(vabuf, sizeof(vabuf), "timedemo %s\n", sys.argv[i + 1]));
701 Cbuf_Execute(cmd_client->cbuf);
704 // check for special demo mode
705 // COMMANDLINEOPTION: Client: -demo <demoname> runs a playdemo and quits
706 i = Sys_CheckParm("-demo");
707 if (i && i + 1 < sys.argc)
708 if (!sv.active && !cls.demoplayback && !cls.connect_trying)
710 Cbuf_AddText(cmd_client, va(vabuf, sizeof(vabuf), "playdemo %s\n", sys.argv[i + 1]));
711 Cbuf_Execute(cmd_client->cbuf);
714 #ifdef CONFIG_VIDEO_CAPTURE
715 // COMMANDLINEOPTION: Client: -capturedemo <demoname> captures a playdemo and quits
716 i = Sys_CheckParm("-capturedemo");
717 if (i && i + 1 < sys.argc)
718 if (!sv.active && !cls.demoplayback && !cls.connect_trying)
720 Cbuf_AddText(cmd_client, va(vabuf, sizeof(vabuf), "playdemo %s\ncl_capturevideo 1\n", sys.argv[i + 1]));
721 Cbuf_Execute((cmd_client)->cbuf);
725 if (cls.state == ca_dedicated || Sys_CheckParm("-listen"))
726 if (!sv.active && !cls.demoplayback && !cls.connect_trying)
728 Cbuf_AddText(cmd_client, "startmap_dm\n");
729 Cbuf_Execute(cmd_client->cbuf);
732 if (!sv.active && !cls.demoplayback && !cls.connect_trying)
735 Cbuf_AddText(cmd_client, "togglemenu 1\n");
737 Cbuf_Execute(cmd_client->cbuf);
740 Con_DPrint("========Initialized=========\n");
742 if (cls.state != ca_dedicated)
751 FIXME: this is a callback from Sys_Quit and Sys_Error. It would be better
752 to run quit through here before the final handoff to the sys code.
755 void Host_Shutdown(void)
757 static qbool isdown = false;
761 Con_Print("recursive shutdown\n");
764 if (setjmp(host.abortframe))
766 Con_Print("aborted the quitting frame?!?\n");
771 if(cls.state != ca_dedicated)
774 // end the server thread
778 // shut down local server if active
779 SV_LockThreadMutex();
781 SV_UnlockThreadMutex();
784 // AK hmm, no PRVM_Shutdown(); yet
792 TaskQueue_Shutdown();
799 Host_UnlockSession();
805 void Host_NoOperation_f(cmd_state_t *cmd)