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 // cmd.c -- Quake script command processing module
24 void Cmd_ForwardToServer (void);
26 #define MAX_ALIAS_NAME 32
28 typedef struct cmdalias_s
30 struct cmdalias_s *next;
31 char name[MAX_ALIAS_NAME];
35 cmdalias_t *cmd_alias;
42 //=============================================================================
48 Causes execution of the remainder of the command buffer to be delayed until
49 next frame. This allows commands like:
50 bind g "impulse 5 ; +attack ; wait ; -attack ; impulse 2"
53 void Cmd_Wait_f (void)
59 =============================================================================
63 =============================================================================
75 SZ_Alloc (&cmd_text, 8192); // space for commands and script files
83 Adds command text at the end of the buffer
86 void Cbuf_AddText (char *text)
92 if (cmd_text.cursize + l >= cmd_text.maxsize)
94 Con_Printf ("Cbuf_AddText: overflow\n");
98 SZ_Write (&cmd_text, text, strlen (text));
106 Adds command text immediately after the current command
107 Adds a \n to the text
108 FIXME: actually change the command buffer to do less copying
111 void Cbuf_InsertText (char *text)
116 // copy off any commands still remaining in the exec buffer
117 templen = cmd_text.cursize;
120 temp = Z_Malloc (templen);
121 memcpy (temp, cmd_text.data, templen);
122 SZ_Clear (&cmd_text);
125 temp = NULL; // shut up compiler
127 // add the entire text of the file
130 // add the copied off data
133 SZ_Write (&cmd_text, temp, templen);
143 void Cbuf_Execute (void)
150 while (cmd_text.cursize)
152 // find a \n or ; line break
153 text = (char *)cmd_text.data;
156 for (i=0 ; i< cmd_text.cursize ; i++)
160 if ( !(quotes&1) && text[i] == ';')
161 break; // don't break if inside a quoted string
167 memcpy (line, text, i);
170 // delete the text from the command buffer and move remaining commands down
171 // this is necessary because commands (exec, alias) can insert data at the
172 // beginning of the text buffer
174 if (i == cmd_text.cursize)
175 cmd_text.cursize = 0;
179 cmd_text.cursize -= i;
180 memcpy (text, text+i, cmd_text.cursize);
183 // execute the command line
184 Cmd_ExecuteString (line, src_command);
187 { // skip out while text still remains in buffer, leaving it
196 ==============================================================================
200 ==============================================================================
207 Adds command line parameters as script statements
208 Commands lead with a +, and continue until a - or another +
209 quake +prog jctest.qp +cmd amlev1
210 quake -nosound +cmd amlev1
213 void Cmd_StuffCmds_f (void)
217 char *text, *build, c;
219 if (Cmd_Argc () != 1)
221 Con_Printf ("stuffcmds : execute command line parameters\n");
225 // build the combined string to parse from
227 for (i=1 ; i<com_argc ; i++)
230 continue; // NEXTSTEP nulls out -NXHost
231 s += strlen (com_argv[i]) + 1;
236 text = Z_Malloc (s+1);
238 for (i=1 ; i<com_argc ; i++)
241 continue; // NEXTSTEP nulls out -NXHost
242 strcat (text,com_argv[i]);
247 // pull out the commands
248 build = Z_Malloc (s+1);
251 for (i=0 ; i<s-1 ; i++)
257 for (j=i ; (text[j] != '+') && (text[j] != '-') && (text[j] != 0) ; j++)
263 strcat (build, text+i);
264 strcat (build, "\n");
271 Cbuf_InsertText (build);
283 void Cmd_Exec_f (void)
288 if (Cmd_Argc () != 2)
290 Con_Printf ("exec <filename> : execute a script file\n");
294 mark = Hunk_LowMark ();
295 f = (char *)COM_LoadHunkFile (Cmd_Argv(1), false);
298 Con_Printf ("couldn't exec %s\n",Cmd_Argv(1));
301 Con_Printf ("execing %s\n",Cmd_Argv(1));
304 Hunk_FreeToLowMark (mark);
312 Just prints the rest of the line to the console
315 void Cmd_Echo_f (void)
319 for (i=1 ; i<Cmd_Argc() ; i++)
320 Con_Printf ("%s ",Cmd_Argv(i));
328 Creates a new command that executes a command string (possibly ; seperated)
332 char *CopyString (char *in)
336 out = Z_Malloc (strlen(in)+1);
341 void Cmd_Alias_f (void)
350 Con_Printf ("Current alias commands:\n");
351 for (a = cmd_alias ; a ; a=a->next)
352 Con_Printf ("%s : %s\n", a->name, a->value);
357 if (strlen(s) >= MAX_ALIAS_NAME)
359 Con_Printf ("Alias name is too long\n");
363 // if the alias already exists, reuse it
364 for (a = cmd_alias ; a ; a=a->next)
366 if (!strcmp(s, a->name))
375 a = Z_Malloc (sizeof(cmdalias_t));
381 // copy the rest of the command line
382 cmd[0] = 0; // start out with a null string
384 for (i=2 ; i< c ; i++)
386 strcat (cmd, Cmd_Argv(i));
392 a->value = CopyString (cmd);
396 =============================================================================
400 =============================================================================
403 typedef struct cmd_function_s
405 struct cmd_function_s *next;
414 static char *cmd_argv[MAX_ARGS];
415 static char *cmd_null_string = "";
416 static char *cmd_args = NULL;
418 cmd_source_t cmd_source;
421 static cmd_function_t *cmd_functions; // possible commands to execute
431 // register our commands
433 Cmd_AddCommand ("stuffcmds",Cmd_StuffCmds_f);
434 Cmd_AddCommand ("exec",Cmd_Exec_f);
435 Cmd_AddCommand ("echo",Cmd_Echo_f);
436 Cmd_AddCommand ("alias",Cmd_Alias_f);
437 Cmd_AddCommand ("cmd", Cmd_ForwardToServer);
438 Cmd_AddCommand ("wait", Cmd_Wait_f);
456 char *Cmd_Argv (int arg)
458 if (arg >= cmd_argc )
459 return cmd_null_string;
460 return cmd_argv[arg];
468 char *Cmd_Args (void)
478 Parses the given string into command line tokens.
481 void Cmd_TokenizeString (char *text)
485 // clear the args from the last string
486 for (i=0 ; i<cmd_argc ; i++)
487 Z_Free (cmd_argv[i]);
494 // skip whitespace up to a /n
495 while (*text && *text <= ' ' && *text != '\n')
501 { // a newline seperates commands in the buffer
512 text = COM_Parse (text);
516 if (cmd_argc < MAX_ARGS)
518 cmd_argv[cmd_argc] = Z_Malloc (strlen(com_token)+1);
519 strcpy (cmd_argv[cmd_argc], com_token);
532 void Cmd_AddCommand (char *cmd_name, xcommand_t function)
536 if (host_initialized) // because hunk allocation would get stomped
537 Sys_Error ("Cmd_AddCommand after host_initialized");
539 // fail if the command is a variable name
540 if (Cvar_VariableString(cmd_name)[0])
542 Con_Printf ("Cmd_AddCommand: %s already defined as a var\n", cmd_name);
546 // fail if the command already exists
547 for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
549 if (!strcmp (cmd_name, cmd->name))
551 Con_Printf ("Cmd_AddCommand: %s already defined\n", cmd_name);
556 cmd = Hunk_AllocName (sizeof(cmd_function_t), "commands");
557 cmd->name = cmd_name;
558 cmd->function = function;
559 cmd->next = cmd_functions;
568 qboolean Cmd_Exists (char *cmd_name)
572 for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
574 if (!strcmp (cmd_name,cmd->name))
588 char *Cmd_CompleteCommand (char *partial)
593 len = strlen(partial);
599 for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
600 if (!strncmp (partial,cmd->name, len))
610 A complete command line has been parsed, so try to execute it
611 FIXME: lookupnoadd the token to speed search?
614 void Cmd_ExecuteString (char *text, cmd_source_t src)
620 Cmd_TokenizeString (text);
622 // execute the command line
627 for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
629 if (!Q_strcasecmp (cmd_argv[0],cmd->name))
637 for (a=cmd_alias ; a ; a=a->next)
639 if (!Q_strcasecmp (cmd_argv[0], a->name))
641 Cbuf_InsertText (a->value);
647 if (!Cvar_Command ())
648 Con_Printf ("Unknown command \"%s\"\n", Cmd_Argv(0));
657 Sends the entire command line over to the server
660 void Cmd_ForwardToServer (void)
662 if (cls.state != ca_connected)
664 Con_Printf ("Can't \"%s\", not connected\n", Cmd_Argv(0));
668 if (cls.demoplayback)
669 return; // not really connected
671 MSG_WriteByte (&cls.message, clc_stringcmd);
672 if (Q_strcasecmp(Cmd_Argv(0), "cmd") != 0)
674 SZ_Print (&cls.message, Cmd_Argv(0));
675 SZ_Print (&cls.message, " ");
678 SZ_Print (&cls.message, Cmd_Args());
680 SZ_Print (&cls.message, "\n");
688 Returns the position (1 to argc-1) in the command's argument list
689 where the given parameter apears, or 0 if not present
693 int Cmd_CheckParm (char *parm)
698 Sys_Error ("Cmd_CheckParm: NULL");
700 for (i = 1; i < Cmd_Argc (); i++)
701 if (!Q_strcasecmp (parm, Cmd_Argv (i)))