cmd.c

   1 /*
   2 Copyright (C) 1996-1997 Id Software, Inc.
   3
   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.
   8
   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.
  12
  13 See the GNU General Public License for more details.
  14
  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.
  18
  19 */
  20 // cmd.c -- Quake script command processing module
  21
  22 #include "quakedef.h"
  23
  24 #define MAX_ALIAS_NAME  32
  25 // this is the largest script file that can be executed in one step
  26 // LordHavoc: inreased this from 8192 to 32768
  27 #define CMDBUFSIZE 32768
  28 // maximum number of parameters to a command
  29 #define MAX_ARGS 80
  30 // maximum tokenizable commandline length (counting NUL terminations)
  31 #define CMD_TOKENIZELENGTH (MAX_INPUTLINE + 80)
  32
  33 typedef struct cmdalias_s
  34 {
  35         struct cmdalias_s *next;
  36         char name[MAX_ALIAS_NAME];
  37         char *value;
  38 } cmdalias_t;
  39
  40 static cmdalias_t *cmd_alias;
  41
  42 static qboolean cmd_wait;
  43
  44 static mempool_t *cmd_mempool;
  45
  46 static char cmd_tokenizebuffer[CMD_TOKENIZELENGTH];
  47 static int cmd_tokenizebufferpos = 0;
  48
  49 //=============================================================================
  50
  51 /*
  52 ============
  53 Cmd_Wait_f
  54
  55 Causes execution of the remainder of the command buffer to be delayed until
  56 next frame.  This allows commands like:
  57 bind g "impulse 5 ; +attack ; wait ; -attack ; impulse 2"
  58 ============
  59 */
  60 static void Cmd_Wait_f (void)
  61 {
  62         cmd_wait = true;
  63 }
  64
  65 /*
  66 =============================================================================
  67
  68                                                 COMMAND BUFFER
  69
  70 =============================================================================
  71 */
  72
  73 static sizebuf_t        cmd_text;
  74 static unsigned char            cmd_text_buf[CMDBUFSIZE];
  75
  76 /*
  77 ============
  78 Cbuf_AddText
  79
  80 Adds command text at the end of the buffer
  81 ============
  82 */
  83 void Cbuf_AddText (const char *text)
  84 {
  85         int             l;
  86
  87         l = (int)strlen (text);
  88
  89         if (cmd_text.cursize + l >= cmd_text.maxsize)
  90         {
  91                 Con_Print("Cbuf_AddText: overflow\n");
  92                 return;
  93         }
  94
  95         SZ_Write (&cmd_text, (const unsigned char *)text, (int)strlen (text));
  96 }
  97
  98
  99 /*
 100 ============
 101 Cbuf_InsertText
 102
 103 Adds command text immediately after the current command
 104 Adds a \n to the text
 105 FIXME: actually change the command buffer to do less copying
 106 ============
 107 */
 108 void Cbuf_InsertText (const char *text)
 109 {
 110         char    *temp;
 111         int             templen;
 112
 113         // copy off any commands still remaining in the exec buffer
 114         templen = cmd_text.cursize;
 115         if (templen)
 116         {
 117                 temp = (char *)Mem_Alloc (tempmempool, templen);
 118                 memcpy (temp, cmd_text.data, templen);
 119                 SZ_Clear (&cmd_text);
 120         }
 121         else
 122                 temp = NULL;
 123
 124         // add the entire text of the file
 125         Cbuf_AddText (text);
 126
 127         // add the copied off data
 128         if (temp != NULL)
 129         {
 130                 SZ_Write (&cmd_text, (const unsigned char *)temp, templen);
 131                 Mem_Free (temp);
 132         }
 133 }
 134
 135 /*
 136 ============
 137 Cbuf_Execute
 138 ============
 139 */
 140 static void Cmd_PreprocessString( const char *intext, char *outtext, unsigned maxoutlen, cmdalias_t *alias );
 141 void Cbuf_Execute (void)
 142 {
 143         int i;
 144         char *text;
 145         char line[MAX_INPUTLINE];
 146         char preprocessed[MAX_INPUTLINE];
 147         int quotes;
 148
 149         // LordHavoc: making sure the tokenizebuffer doesn't get filled up by repeated crashes
 150         cmd_tokenizebufferpos = 0;
 151
 152         while (cmd_text.cursize)
 153         {
 154 // find a \n or ; line break
 155                 text = (char *)cmd_text.data;
 156
 157                 quotes = 0;
 158                 for (i=0 ; i< cmd_text.cursize ; i++)
 159                 {
 160                         if (text[i] == '"')
 161                                 quotes ^= 1;
 162                         if (text[i] == '\\' && text[i+1] == '"')
 163                                 i++;
 164                         if ( !quotes &&  text[i] == ';')
 165                                 break;  // don't break if inside a quoted string
 166                         if (text[i] == '\r' || text[i] == '\n')
 167                                 break;
 168                 }
 169
 170                 memcpy (line, text, i);
 171                 line[i] = 0;
 172
 173 // delete the text from the command buffer and move remaining commands down
 174 // this is necessary because commands (exec, alias) can insert data at the
 175 // beginning of the text buffer
 176
 177                 if (i == cmd_text.cursize)
 178                         cmd_text.cursize = 0;
 179                 else
 180                 {
 181                         i++;
 182                         cmd_text.cursize -= i;
 183                         memcpy (cmd_text.data, text+i, cmd_text.cursize);
 184                 }
 185
 186 // execute the command line
 187                 Cmd_PreprocessString( line, preprocessed, sizeof(preprocessed), NULL );
 188                 Cmd_ExecuteString (preprocessed, src_command);
 189
 190                 if (cmd_wait)
 191                 {       // skip out while text still remains in buffer, leaving it
 192                         // for next frame
 193                         cmd_wait = false;
 194                         break;
 195                 }
 196         }
 197 }
 198
 199 /*
 200 ==============================================================================
 201
 202                                                 SCRIPT COMMANDS
 203
 204 ==============================================================================
 205 */
 206
 207 /*
 208 ===============
 209 Cmd_StuffCmds_f
 210
 211 Adds command line parameters as script statements
 212 Commands lead with a +, and continue until a - or another +
 213 quake +prog jctest.qp +cmd amlev1
 214 quake -nosound +cmd amlev1
 215 ===============
 216 */
 217 qboolean host_stuffcmdsrun = false;
 218 void Cmd_StuffCmds_f (void)
 219 {
 220         int             i, j, l;
 221         // this is for all commandline options combined (and is bounds checked)
 222         char    build[MAX_INPUTLINE];
 223
 224         if (Cmd_Argc () != 1)
 225         {
 226                 Con_Print("stuffcmds : execute command line parameters\n");
 227                 return;
 228         }
 229
 230         // no reason to run the commandline arguments twice
 231         if (host_stuffcmdsrun)
 232                 return;
 233
 234         host_stuffcmdsrun = true;
 235         build[0] = 0;
 236         l = 0;
 237         for (i = 0;i < com_argc;i++)
 238         {
 239                 if (com_argv[i] && com_argv[i][0] == '+' && (com_argv[i][1] < '0' || com_argv[i][1] > '9') && l + strlen(com_argv[i]) - 1 <= sizeof(build) - 1)
 240                 {
 241                         j = 1;
 242                         while (com_argv[i][j])
 243                                 build[l++] = com_argv[i][j++];
 244                         i++;
 245                         for (;i < com_argc;i++)
 246                         {
 247                                 if (!com_argv[i])
 248                                         continue;
 249                                 if ((com_argv[i][0] == '+' || com_argv[i][0] == '-') && (com_argv[i][1] < '0' || com_argv[i][1] > '9'))
 250                                         break;
 251                                 if (l + strlen(com_argv[i]) + 4 > sizeof(build) - 1)
 252                                         break;
 253                                 build[l++] = ' ';
 254                                 if (strchr(com_argv[i], ' '))
 255                                         build[l++] = '\"';
 256                                 for (j = 0;com_argv[i][j];j++)
 257                                         build[l++] = com_argv[i][j];
 258                                 if (strchr(com_argv[i], ' '))
 259                                         build[l++] = '\"';
 260                         }
 261                         build[l++] = '\n';
 262                         i--;
 263                 }
 264         }
 265         // now terminate the combined string and prepend it to the command buffer
 266         // we already reserved space for the terminator
 267         build[l++] = 0;
 268         Cbuf_InsertText (build);
 269 }
 270
 271
 272 /*
 273 ===============
 274 Cmd_Exec_f
 275 ===============
 276 */
 277 static void Cmd_Exec_f (void)
 278 {
 279         char *f;
 280
 281         if (Cmd_Argc () != 2)
 282         {
 283                 Con_Print("exec <filename> : execute a script file\n");
 284                 return;
 285         }
 286
 287         f = (char *)FS_LoadFile (Cmd_Argv(1), tempmempool, false, NULL);
 288         if (!f)
 289         {
 290                 Con_Printf("couldn't exec %s\n",Cmd_Argv(1));
 291                 return;
 292         }
 293         Con_DPrintf("execing %s\n",Cmd_Argv(1));
 294
 295         // if executing default.cfg for the first time, lock the cvar defaults
 296         // it may seem backwards to insert this text BEFORE the default.cfg
 297         // but Cbuf_InsertText inserts before, so this actually ends up after it.
 298         if (!strcmp(Cmd_Argv(1), "default.cfg"))
 299                 Cbuf_InsertText("\ncvar_lockdefaults\n");
 300
 301         // insert newline after the text to make sure the last line is terminated (some text editors omit the trailing newline)
 302         // (note: insertion order here is backwards from execution order, so this adds it after the text, by calling it before...)
 303         Cbuf_InsertText ("\n");
 304         Cbuf_InsertText (f);
 305         Mem_Free(f);
 306 }
 307
 308
 309 /*
 310 ===============
 311 Cmd_Echo_f
 312
 313 Just prints the rest of the line to the console
 314 ===============
 315 */
 316 static void Cmd_Echo_f (void)
 317 {
 318         int             i;
 319
 320         for (i=1 ; i<Cmd_Argc() ; i++)
 321                 Con_Printf("%s ",Cmd_Argv(i));
 322         Con_Print("\n");
 323 }
 324
 325 // DRESK - 5/14/06
 326 // Support Doom3-style Toggle Console Command
 327 /*
 328 ===============
 329 Cmd_Toggle_f
 330
 331 Toggles a specified console variable amongst the values specified (default is 0 and 1)
 332 ===============
 333 */
 334 static void Cmd_Toggle_f(void)
 335 {
 336         // Acquire Number of Arguments
 337         int nNumArgs = Cmd_Argc();
 338
 339         if(nNumArgs == 1)
 340                 // No Arguments Specified; Print Usage
 341                 Con_Print("Toggle Console Variable - Usage\n  toggle <variable> - toggles between 0 and 1\n  toggle <variable> <value> - toggles between 0 and <value>\n  toggle <variable> [string 1] [string 2]...[string n] - cycles through all strings\n");
 342         else
 343         { // Correct Arguments Specified
 344                 // Acquire Potential CVar
 345                 cvar_t* cvCVar = Cvar_FindVar( Cmd_Argv(1) );
 346
 347                 if(cvCVar != NULL)
 348                 { // Valid CVar
 349                         if(nNumArgs == 2)
 350                         { // Default Usage
 351                                 if(cvCVar->integer)
 352                                         Cvar_SetValueQuick(cvCVar, 0);
 353                                 else
 354                                         Cvar_SetValueQuick(cvCVar, 1);
 355                         }
 356                         else
 357                         if(nNumArgs == 3)
 358                         { // 0 and Specified Usage
 359                                 if(cvCVar->integer == atoi(Cmd_Argv(2) ) )
 360                                         // CVar is Specified Value; // Reset to 0
 361                                         Cvar_SetValueQuick(cvCVar, 0);
 362                                 else
 363                                 if(cvCVar->integer == 0)
 364                                         // CVar is 0; Specify Value
 365                                         Cvar_SetQuick(cvCVar, Cmd_Argv(2) );
 366                                 else
 367                                         // CVar does not match; Reset to 0
 368                                         Cvar_SetValueQuick(cvCVar, 0);
 369                         }
 370                         else
 371                         { // Variable Values Specified
 372                                 int nCnt;
 373                                 int bFound = 0;
 374
 375                                 for(nCnt = 2; nCnt < nNumArgs; nCnt++)
 376                                 { // Cycle through Values
 377                                         if( strcmp(cvCVar->string, Cmd_Argv(nCnt) ) == 0)
 378                                         { // Current Value Located; Increment to Next
 379                                                 if( (nCnt + 1) == nNumArgs)
 380                                                         // Max Value Reached; Reset
 381                                                         Cvar_SetQuick(cvCVar, Cmd_Argv(2) );
 382                                                 else
 383                                                         // Next Value
 384                                                         Cvar_SetQuick(cvCVar, Cmd_Argv(nCnt + 1) );
 385
 386                                                 // End Loop
 387                                                 nCnt = nNumArgs;
 388                                                 // Assign Found
 389                                                 bFound = 1;
 390                                         }
 391                                 }
 392                                 if(!bFound)
 393                                         // Value not Found; Reset to Original
 394                                         Cvar_SetQuick(cvCVar, Cmd_Argv(2) );
 395                         }
 396
 397                 }
 398                 else
 399                 { // Invalid CVar
 400                         Con_Printf("ERROR : CVar '%s' not found\n", Cmd_Argv(2) );
 401                 }
 402         }
 403 }
 404
 405 /*
 406 ===============
 407 Cmd_Alias_f
 408
 409 Creates a new command that executes a command string (possibly ; seperated)
 410 ===============
 411 */
 412 static void Cmd_Alias_f (void)
 413 {
 414         cmdalias_t      *a;
 415         char            cmd[MAX_INPUTLINE];
 416         int                     i, c;
 417         const char              *s;
 418         size_t          alloclen;
 419
 420         if (Cmd_Argc() == 1)
 421         {
 422                 Con_Print("Current alias commands:\n");
 423                 for (a = cmd_alias ; a ; a=a->next)
 424                         Con_Printf("%s : %s\n", a->name, a->value);
 425                 return;
 426         }
 427
 428         s = Cmd_Argv(1);
 429         if (strlen(s) >= MAX_ALIAS_NAME)
 430         {
 431                 Con_Print("Alias name is too long\n");
 432                 return;
 433         }
 434
 435         // if the alias already exists, reuse it
 436         for (a = cmd_alias ; a ; a=a->next)
 437         {
 438                 if (!strcmp(s, a->name))
 439                 {
 440                         Z_Free (a->value);
 441                         break;
 442                 }
 443         }
 444
 445         if (!a)
 446         {
 447                 cmdalias_t *prev, *current;
 448
 449                 a = (cmdalias_t *)Z_Malloc (sizeof(cmdalias_t));
 450                 strlcpy (a->name, s, sizeof (a->name));
 451                 // insert it at the right alphanumeric position
 452                 for( prev = NULL, current = cmd_alias ; current && strcmp( current->name, a->name ) < 0 ; prev = current, current = current->next )
 453                         ;
 454                 if( prev ) {
 455                         prev->next = a;
 456                 } else {
 457                         cmd_alias = a;
 458                 }
 459                 a->next = current;
 460         }
 461
 462
 463 // copy the rest of the command line
 464         cmd[0] = 0;             // start out with a null string
 465         c = Cmd_Argc();
 466         for (i=2 ; i< c ; i++)
 467         {
 468                 strlcat (cmd, Cmd_Argv(i), sizeof (cmd));
 469                 if (i != c)
 470                         strlcat (cmd, " ", sizeof (cmd));
 471         }
 472         strlcat (cmd, "\n", sizeof (cmd));
 473
 474         alloclen = strlen (cmd) + 1;
 475         a->value = (char *)Z_Malloc (alloclen);
 476         memcpy (a->value, cmd, alloclen);
 477 }
 478
 479 /*
 480 =============================================================================
 481
 482                                         COMMAND EXECUTION
 483
 484 =============================================================================
 485 */
 486
 487 typedef struct cmd_function_s
 488 {
 489         struct cmd_function_s *next;
 490         const char *name;
 491         const char *description;
 492         xcommand_t consolefunction;
 493         xcommand_t clientfunction;
 494         qboolean csqcfunc;
 495 } cmd_function_t;
 496
 497 static int cmd_argc;
 498 static const char *cmd_argv[MAX_ARGS];
 499 static const char *cmd_null_string = "";
 500 static const char *cmd_args;
 501 cmd_source_t cmd_source;
 502
 503
 504 static cmd_function_t *cmd_functions;           // possible commands to execute
 505
 506 /*
 507 Cmd_PreprocessString
 508
 509 Preprocesses strings and replaces $*, $param#, $cvar accordingly
 510 */
 511 static void Cmd_PreprocessString( const char *intext, char *outtext, unsigned maxoutlen, cmdalias_t *alias ) {
 512         const char *in;
 513         unsigned outlen;
 514         int inquote;
 515
 516         // don't crash if there's no room in the outtext buffer
 517         if( maxoutlen == 0 ) {
 518                 return;
 519         }
 520         maxoutlen--; // because of \0
 521
 522         in = intext;
 523         outlen = 0;
 524         inquote = 0;
 525
 526         while( *in && outlen < maxoutlen ) {
 527                 if( *in == '$' && !inquote ) {
 528                         // this is some kind of expansion, see what comes after the $
 529                         in++;
 530                         // replacements that can always be used:
 531                         // $$ is replaced with $, to allow escaping $
 532                         // $<cvarname> is replaced with the contents of the cvar
 533                         //
 534                         // the following can be used in aliases only:
 535                         // $* is replaced with all formal parameters (including name of the alias - this probably is not desirable)
 536                         // $0 is replaced with the name of this alias
 537                         // $<number> is replaced with an argument to this alias (or copied as-is if no such parameter exists), can be multiple digits
 538                         if( *in == '$' ) {
 539                                 outtext[outlen++] = *in++;
 540                         } else if( *in == '*' && alias ) {
 541                                 const char *linein = Cmd_Args();
 542
 543                                 // include all parameters
 544                                 if (linein) {
 545                                         while( *linein && outlen < maxoutlen ) {
 546                                                 outtext[outlen++] = *linein++;
 547                                         }
 548                                 }
 549
 550                                 in++;
 551                         } else if( '0' <= *in && *in <= '9' && alias ) {
 552                                 char *nexttoken;
 553                                 int argnum;
 554
 555                                 argnum = strtol( in, &nexttoken, 10 );
 556
 557                                 if( 0 <= argnum && argnum < Cmd_Argc() ) {
 558                                         const char *param = Cmd_Argv( argnum );
 559                                         while( *param && outlen < maxoutlen ) {
 560                                                 outtext[outlen++] = *param++;
 561                                         }
 562                                         in = nexttoken;
 563                                 } else if( argnum >= Cmd_Argc() ) {
 564                                         Con_Printf( "Warning: Not enough parameters passed to alias '%s', at least %i expected:\n    %s\n", alias->name, argnum, alias->value );
 565                                         outtext[outlen++] = '$';
 566                                 }
 567                         } else {
 568                                 cvar_t *cvar;
 569                                 const char *tempin = in;
 570
 571                                 COM_ParseToken_Console( &tempin );
 572                                 // don't expand rcon_password or similar cvars (CVAR_PRIVATE flag)
 573                                 if ((cvar = Cvar_FindVar(&com_token[0])) && !(cvar->flags & CVAR_PRIVATE)) {
 574                                         const char *cvarcontent = cvar->string;
 575                                         while( *cvarcontent && outlen < maxoutlen ) {
 576                                                 outtext[outlen++] = *cvarcontent++;
 577                                         }
 578                                         in = tempin;
 579                                 } else {
 580                                         if( alias ) {
 581                                                 Con_Printf( "Warning: could not find cvar %s when expanding alias %s\n    %s\n", com_token, alias->name, alias->value );
 582                                         } else {
 583                                                 Con_Printf( "Warning: could not find cvar %s\n", com_token );
 584                                         }
 585                                         outtext[outlen++] = '$';
 586                                 }
 587                         }
 588                 } else {
 589                         if( *in == '"' ) {
 590                                 inquote ^= 1;
 591                         }
 592                         outtext[outlen++] = *in++;
 593                 }
 594         }
 595         outtext[outlen] = 0;
 596 }
 597
 598 /*
 599 ============
 600 Cmd_ExecuteAlias
 601
 602 Called for aliases and fills in the alias into the cbuffer
 603 ============
 604 */
 605 static void Cmd_ExecuteAlias (cmdalias_t *alias)
 606 {
 607         static char buffer[ MAX_INPUTLINE + 2 ];
 608         Cmd_PreprocessString( alias->value, buffer, sizeof(buffer) - 2, alias );
 609         // insert at start of command buffer, so that aliases execute in order
 610         // (fixes bug introduced by Black on 20050705)
 611         Cbuf_InsertText( buffer );
 612 }
 613
 614 /*
 615 ========
 616 Cmd_List
 617
 618         CmdList Added by EvilTypeGuy eviltypeguy@qeradiant.com
 619         Thanks to Matthias "Maddes" Buecher, http://www.inside3d.com/qip/
 620
 621 ========
 622 */
 623 static void Cmd_List_f (void)
 624 {
 625         cmd_function_t *cmd;
 626         const char *partial;
 627         int len, count;
 628
 629         if (Cmd_Argc() > 1)
 630         {
 631                 partial = Cmd_Argv (1);
 632                 len = (int)strlen(partial);
 633         }
 634         else
 635         {
 636                 partial = NULL;
 637                 len = 0;
 638         }
 639
 640         count = 0;
 641         for (cmd = cmd_functions; cmd; cmd = cmd->next)
 642         {
 643                 if (partial && strncmp(partial, cmd->name, len))
 644                         continue;
 645                 Con_Printf("%s : %s\n", cmd->name, cmd->description);
 646                 count++;
 647         }
 648
 649         if (partial)
 650                 Con_Printf("%i Command%s beginning with \"%s\"\n\n", count, (count > 1) ? "s" : "", partial);
 651         else
 652                 Con_Printf("%i Command%s\n\n", count, (count > 1) ? "s" : "");
 653 }
 654
 655 /*
 656 ============
 657 Cmd_Init
 658 ============
 659 */
 660 void Cmd_Init (void)
 661 {
 662         cmd_mempool = Mem_AllocPool("commands", 0, NULL);
 663         // space for commands and script files
 664         cmd_text.data = cmd_text_buf;
 665         cmd_text.maxsize = sizeof(cmd_text_buf);
 666         cmd_text.cursize = 0;
 667 }
 668
 669 void Cmd_Init_Commands (void)
 670 {
 671 //
 672 // register our commands
 673 //
 674         Cmd_AddCommand ("stuffcmds",Cmd_StuffCmds_f, "execute commandline parameters (must be present in quake.rc script)");
 675         Cmd_AddCommand ("exec",Cmd_Exec_f, "execute a script file");
 676         Cmd_AddCommand ("echo",Cmd_Echo_f, "print a message to the console (useful in scripts)");
 677         Cmd_AddCommand ("alias",Cmd_Alias_f, "create a script function (parameters are passed in as $1 through $9, and $* for all parameters)");
 678         Cmd_AddCommand ("cmd", Cmd_ForwardToServer, "send a console commandline to the server (used by some mods)");
 679         Cmd_AddCommand ("wait", Cmd_Wait_f, "make script execution wait for next rendered frame");
 680         Cmd_AddCommand ("set", Cvar_Set_f, "create or change the value of a console variable");
 681         Cmd_AddCommand ("seta", Cvar_SetA_f, "create or change the value of a console variable that will be saved to config.cfg");
 682
 683         // 2000-01-09 CmdList, CvarList commands By Matthias "Maddes" Buecher
 684         // Added/Modified by EvilTypeGuy eviltypeguy@qeradiant.com
 685         Cmd_AddCommand ("cmdlist", Cmd_List_f, "lists all console commands beginning with the specified prefix");
 686         Cmd_AddCommand ("cvarlist", Cvar_List_f, "lists all console variables beginning with the specified prefix");
 687
 688         Cmd_AddCommand ("cvar_lockdefaults", Cvar_LockDefaults_f, "stores the current values of all cvars into their default values, only used once during startup after parsing default.cfg");
 689         Cmd_AddCommand ("cvar_resettodefaults_all", Cvar_ResetToDefaults_All_f, "sets all cvars to their locked default values");
 690         Cmd_AddCommand ("cvar_resettodefaults_nosaveonly", Cvar_ResetToDefaults_NoSaveOnly_f, "sets all non-saved cvars to their locked default values (variables that will not be saved to config.cfg)");
 691         Cmd_AddCommand ("cvar_resettodefaults_saveonly", Cvar_ResetToDefaults_SaveOnly_f, "sets all saved cvars to their locked default values (variables that will be saved to config.cfg)");
 692
 693         // DRESK - 5/14/06
 694         // Support Doom3-style Toggle Command
 695         Cmd_AddCommand( "toggle", Cmd_Toggle_f, "toggles a console variable's values (use for more info)");
 696 }
 697
 698 /*
 699 ============
 700 Cmd_Shutdown
 701 ============
 702 */
 703 void Cmd_Shutdown(void)
 704 {
 705         Mem_FreePool(&cmd_mempool);
 706 }
 707
 708 /*
 709 ============
 710 Cmd_Argc
 711 ============
 712 */
 713 int             Cmd_Argc (void)
 714 {
 715         return cmd_argc;
 716 }
 717
 718 /*
 719 ============
 720 Cmd_Argv
 721 ============
 722 */
 723 const char *Cmd_Argv (int arg)
 724 {
 725         if (arg >= cmd_argc )
 726                 return cmd_null_string;
 727         return cmd_argv[arg];
 728 }
 729
 730 /*
 731 ============
 732 Cmd_Args
 733 ============
 734 */
 735 const char *Cmd_Args (void)
 736 {
 737         return cmd_args;
 738 }
 739
 740
 741 /*
 742 ============
 743 Cmd_TokenizeString
 744
 745 Parses the given string into command line tokens.
 746 ============
 747 */
 748 // AK: This function should only be called from ExcuteString because the current design is a bit of an hack
 749 static void Cmd_TokenizeString (const char *text)
 750 {
 751         int l;
 752
 753         cmd_argc = 0;
 754         cmd_args = NULL;
 755
 756         while (1)
 757         {
 758                 // skip whitespace up to a /n
 759                 while (*text && *text <= ' ' && *text != '\r' && *text != '\n')
 760                         text++;
 761
 762                 // line endings:
 763                 // UNIX: \n
 764                 // Mac: \r
 765                 // Windows: \r\n
 766                 if (*text == '\n' || *text == '\r')
 767                 {
 768                         // a newline separates commands in the buffer
 769                         if (*text == '\r' && text[1] == '\n')
 770                                 text++;
 771                         text++;
 772                         break;
 773                 }
 774
 775                 if (!*text)
 776                         return;
 777
 778                 if (cmd_argc == 1)
 779                         cmd_args = text;
 780
 781                 if (!COM_ParseToken_Console(&text))
 782                         return;
 783
 784                 if (cmd_argc < MAX_ARGS)
 785                 {
 786                         l = (int)strlen(com_token) + 1;
 787                         if (cmd_tokenizebufferpos + l > CMD_TOKENIZELENGTH)
 788                         {
 789                                 Con_Printf("Cmd_TokenizeString: ran out of %i character buffer space for command arguements\n", CMD_TOKENIZELENGTH);
 790                                 break;
 791                         }
 792                         memcpy (cmd_tokenizebuffer + cmd_tokenizebufferpos, com_token, l);
 793                         cmd_argv[cmd_argc] = cmd_tokenizebuffer + cmd_tokenizebufferpos;
 794                         cmd_tokenizebufferpos += l;
 795                         cmd_argc++;
 796                 }
 797         }
 798 }
 799
 800
 801 /*
 802 ============
 803 Cmd_AddCommand
 804 ============
 805 */
 806 void Cmd_AddCommand_WithClientCommand (const char *cmd_name, xcommand_t consolefunction, xcommand_t clientfunction, const char *description)
 807 {
 808         cmd_function_t *cmd;
 809         cmd_function_t *prev, *current;
 810
 811 // fail if the command is a variable name
 812         if (Cvar_FindVar( cmd_name ))
 813         {
 814                 Con_Printf("Cmd_AddCommand: %s already defined as a var\n", cmd_name);
 815                 return;
 816         }
 817
 818 // fail if the command already exists
 819         for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
 820         {
 821                 if (!strcmp (cmd_name, cmd->name))
 822                 {
 823                         if (consolefunction || clientfunction)
 824                         {
 825                                 Con_Printf("Cmd_AddCommand: %s already defined\n", cmd_name);
 826                                 return;
 827                         }
 828                         else    //[515]: csqc
 829                         {
 830                                 cmd->csqcfunc = true;
 831                                 return;
 832                         }
 833                 }
 834         }
 835
 836         cmd = (cmd_function_t *)Mem_Alloc(cmd_mempool, sizeof(cmd_function_t));
 837         cmd->name = cmd_name;
 838         cmd->consolefunction = consolefunction;
 839         cmd->clientfunction = clientfunction;
 840         cmd->description = description;
 841         if(!consolefunction && !clientfunction)                 //[515]: csqc
 842                 cmd->csqcfunc = true;
 843         cmd->next = cmd_functions;
 844
 845 // insert it at the right alphanumeric position
 846         for( prev = NULL, current = cmd_functions ; current && strcmp( current->name, cmd->name ) < 0 ; prev = current, current = current->next )
 847                 ;
 848         if( prev ) {
 849                 prev->next = cmd;
 850         } else {
 851                 cmd_functions = cmd;
 852         }
 853         cmd->next = current;
 854 }
 855
 856 void Cmd_AddCommand (const char *cmd_name, xcommand_t function, const char *description)
 857 {
 858         Cmd_AddCommand_WithClientCommand (cmd_name, function, NULL, description);
 859 }
 860
 861 /*
 862 ============
 863 Cmd_Exists
 864 ============
 865 */
 866 qboolean Cmd_Exists (const char *cmd_name)
 867 {
 868         cmd_function_t  *cmd;
 869
 870         for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
 871                 if (!strcmp (cmd_name,cmd->name))
 872                         return true;
 873
 874         return false;
 875 }
 876
 877
 878 /*
 879 ============
 880 Cmd_CompleteCommand
 881 ============
 882 */
 883 const char *Cmd_CompleteCommand (const char *partial)
 884 {
 885         cmd_function_t *cmd;
 886         size_t len;
 887
 888         len = strlen(partial);
 889
 890         if (!len)
 891                 return NULL;
 892
 893 // check functions
 894         for (cmd = cmd_functions; cmd; cmd = cmd->next)
 895                 if (!strncasecmp(partial, cmd->name, len))
 896                         return cmd->name;
 897
 898         return NULL;
 899 }
 900
 901 /*
 902         Cmd_CompleteCountPossible
 903
 904         New function for tab-completion system
 905         Added by EvilTypeGuy
 906         Thanks to Fett erich@heintz.com
 907         Thanks to taniwha
 908
 909 */
 910 int Cmd_CompleteCountPossible (const char *partial)
 911 {
 912         cmd_function_t *cmd;
 913         size_t len;
 914         int h;
 915
 916         h = 0;
 917         len = strlen(partial);
 918
 919         if (!len)
 920                 return 0;
 921
 922         // Loop through the command list and count all partial matches
 923         for (cmd = cmd_functions; cmd; cmd = cmd->next)
 924                 if (!strncasecmp(partial, cmd->name, len))
 925                         h++;
 926
 927         return h;
 928 }
 929
 930 /*
 931         Cmd_CompleteBuildList
 932
 933         New function for tab-completion system
 934         Added by EvilTypeGuy
 935         Thanks to Fett erich@heintz.com
 936         Thanks to taniwha
 937
 938 */
 939 const char **Cmd_CompleteBuildList (const char *partial)
 940 {
 941         cmd_function_t *cmd;
 942         size_t len = 0;
 943         size_t bpos = 0;
 944         size_t sizeofbuf = (Cmd_CompleteCountPossible (partial) + 1) * sizeof (const char *);
 945         const char **buf;
 946
 947         len = strlen(partial);
 948         buf = (const char **)Mem_Alloc(tempmempool, sizeofbuf + sizeof (const char *));
 949         // Loop through the alias list and print all matches
 950         for (cmd = cmd_functions; cmd; cmd = cmd->next)
 951                 if (!strncasecmp(partial, cmd->name, len))
 952                         buf[bpos++] = cmd->name;
 953
 954         buf[bpos] = NULL;
 955         return buf;
 956 }
 957
 958 // written by LordHavoc
 959 void Cmd_CompleteCommandPrint (const char *partial)
 960 {
 961         cmd_function_t *cmd;
 962         size_t len = strlen(partial);
 963         // Loop through the command list and print all matches
 964         for (cmd = cmd_functions; cmd; cmd = cmd->next)
 965                 if (!strncasecmp(partial, cmd->name, len))
 966                         Con_Printf("%s : %s\n", cmd->name, cmd->description);
 967 }
 968
 969 /*
 970         Cmd_CompleteAlias
 971
 972         New function for tab-completion system
 973         Added by EvilTypeGuy
 974         Thanks to Fett erich@heintz.com
 975         Thanks to taniwha
 976
 977 */
 978 const char *Cmd_CompleteAlias (const char *partial)
 979 {
 980         cmdalias_t *alias;
 981         size_t len;
 982
 983         len = strlen(partial);
 984
 985         if (!len)
 986                 return NULL;
 987
 988         // Check functions
 989         for (alias = cmd_alias; alias; alias = alias->next)
 990                 if (!strncasecmp(partial, alias->name, len))
 991                         return alias->name;
 992
 993         return NULL;
 994 }
 995
 996 // written by LordHavoc
 997 void Cmd_CompleteAliasPrint (const char *partial)
 998 {
 999         cmdalias_t *alias;
1000         size_t len = strlen(partial);
1001         // Loop through the alias list and print all matches
1002         for (alias = cmd_alias; alias; alias = alias->next)
1003                 if (!strncasecmp(partial, alias->name, len))
1004                         Con_Printf("%s : %s\n", alias->name, alias->value);
1005 }
1006
1007
1008 /*
1009         Cmd_CompleteAliasCountPossible
1010
1011         New function for tab-completion system
1012         Added by EvilTypeGuy
1013         Thanks to Fett erich@heintz.com
1014         Thanks to taniwha
1015
1016 */
1017 int Cmd_CompleteAliasCountPossible (const char *partial)
1018 {
1019         cmdalias_t      *alias;
1020         size_t          len;
1021         int                     h;
1022
1023         h = 0;
1024
1025         len = strlen(partial);
1026
1027         if (!len)
1028                 return 0;
1029
1030         // Loop through the command list and count all partial matches
1031         for (alias = cmd_alias; alias; alias = alias->next)
1032                 if (!strncasecmp(partial, alias->name, len))
1033                         h++;
1034
1035         return h;
1036 }
1037
1038 /*
1039         Cmd_CompleteAliasBuildList
1040
1041         New function for tab-completion system
1042         Added by EvilTypeGuy
1043         Thanks to Fett erich@heintz.com
1044         Thanks to taniwha
1045
1046 */
1047 const char **Cmd_CompleteAliasBuildList (const char *partial)
1048 {
1049         cmdalias_t *alias;
1050         size_t len = 0;
1051         size_t bpos = 0;
1052         size_t sizeofbuf = (Cmd_CompleteAliasCountPossible (partial) + 1) * sizeof (const char *);
1053         const char **buf;
1054
1055         len = strlen(partial);
1056         buf = (const char **)Mem_Alloc(tempmempool, sizeofbuf + sizeof (const char *));
1057         // Loop through the alias list and print all matches
1058         for (alias = cmd_alias; alias; alias = alias->next)
1059                 if (!strncasecmp(partial, alias->name, len))
1060                         buf[bpos++] = alias->name;
1061
1062         buf[bpos] = NULL;
1063         return buf;
1064 }
1065
1066 void Cmd_ClearCsqcFuncs (void)
1067 {
1068         cmd_function_t *cmd;
1069         for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
1070                 cmd->csqcfunc = false;
1071 }
1072
1073 qboolean CL_VM_ConsoleCommand (const char *cmd);
1074 /*
1075 ============
1076 Cmd_ExecuteString
1077
1078 A complete command line has been parsed, so try to execute it
1079 FIXME: lookupnoadd the token to speed search?
1080 ============
1081 */
1082 void Cmd_ExecuteString (const char *text, cmd_source_t src)
1083 {
1084         int oldpos;
1085         cmd_function_t *cmd;
1086         cmdalias_t *a;
1087
1088         oldpos = cmd_tokenizebufferpos;
1089         cmd_source = src;
1090
1091         Cmd_TokenizeString (text);
1092
1093 // execute the command line
1094         if (!Cmd_Argc())
1095         {
1096                 cmd_tokenizebufferpos = oldpos;
1097                 return;         // no tokens
1098         }
1099
1100 // check functions
1101         for (cmd=cmd_functions ; cmd ; cmd=cmd->next)
1102         {
1103                 if (!strcasecmp (cmd_argv[0],cmd->name))
1104                 {
1105                         if (cmd->csqcfunc && CL_VM_ConsoleCommand (text))       //[515]: csqc
1106                                 return;
1107                         switch (src)
1108                         {
1109                         case src_command:
1110                                 if (cmd->consolefunction)
1111                                         cmd->consolefunction ();
1112                                 else if (cmd->clientfunction)
1113                                 {
1114                                         if (cls.state == ca_connected)
1115                                         {
1116                                                 // forward remote commands to the server for execution
1117                                                 Cmd_ForwardToServer();
1118                                         }
1119                                         else
1120                                                 Con_Printf("Can not send command \"%s\", not connected.\n", Cmd_Argv(0));
1121                                 }
1122                                 else
1123                                         Con_Printf("Command \"%s\" can not be executed\n", Cmd_Argv(0));
1124                                 cmd_tokenizebufferpos = oldpos;
1125                                 return;
1126                         case src_client:
1127                                 if (cmd->clientfunction)
1128                                 {
1129                                         cmd->clientfunction ();
1130                                         cmd_tokenizebufferpos = oldpos;
1131                                         return;
1132                                 }
1133                                 break;
1134                         }
1135                         break;
1136                 }
1137         }
1138
1139         // if it's a client command and no command was found, say so.
1140         if (cmd_source == src_client)
1141         {
1142                 Con_Printf("player \"%s\" tried to %s\n", host_client->name, text);
1143                 return;
1144         }
1145
1146 // check alias
1147         for (a=cmd_alias ; a ; a=a->next)
1148         {
1149                 if (!strcasecmp (cmd_argv[0], a->name))
1150                 {
1151                         Cmd_ExecuteAlias(a);
1152                         cmd_tokenizebufferpos = oldpos;
1153                         return;
1154                 }
1155         }
1156
1157 // check cvars
1158         if (!Cvar_Command () && host_framecount > 0)
1159                 Con_Printf("Unknown command \"%s\"\n", Cmd_Argv(0));
1160
1161         cmd_tokenizebufferpos = oldpos;
1162 }
1163
1164
1165 /*
1166 ===================
1167 Cmd_ForwardStringToServer
1168
1169 Sends an entire command string over to the server, unprocessed
1170 ===================
1171 */
1172 void Cmd_ForwardStringToServer (const char *s)
1173 {
1174         char temp[128];
1175         if (cls.state != ca_connected)
1176         {
1177                 Con_Printf("Can't \"%s\", not connected\n", s);
1178                 return;
1179         }
1180
1181         if (!cls.netcon)
1182                 return;
1183
1184         // LordHavoc: thanks to Fuh for bringing the pure evil of SZ_Print to my
1185         // attention, it has been eradicated from here, its only (former) use in
1186         // all of darkplaces.
1187         if (cls.protocol == PROTOCOL_QUAKEWORLD)
1188                 MSG_WriteByte(&cls.netcon->message, qw_clc_stringcmd);
1189         else
1190                 MSG_WriteByte(&cls.netcon->message, clc_stringcmd);
1191         if ((!strncmp(s, "say ", 4) || !strncmp(s, "say_team ", 9)) && cl_locs_enable.integer)
1192         {
1193                 // say/say_team commands can replace % character codes with status info
1194                 while (*s)
1195                 {
1196                         if (*s == '%' && s[1])
1197                         {
1198                                 // handle proquake message macros
1199                                 temp[0] = 0;
1200                                 switch (s[1])
1201                                 {
1202                                 case 'l': // current location
1203                                         CL_Locs_FindLocationName(temp, sizeof(temp), cl.movement_origin);
1204                                         break;
1205                                 case 'h': // current health
1206                                         dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_HEALTH]);
1207                                         break;
1208                                 case 'a': // current armor
1209                                         dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_ARMOR]);
1210                                         break;
1211                                 case 'x': // current rockets
1212                                         dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_ROCKETS]);
1213                                         break;
1214                                 case 'c': // current cells
1215                                         dpsnprintf(temp, sizeof(temp), "%i", cl.stats[STAT_CELLS]);
1216                                         break;
1217                                 // silly proquake macros
1218                                 case 'd': // loc at last death
1219                                         CL_Locs_FindLocationName(temp, sizeof(temp), cl.lastdeathorigin);
1220                                         break;
1221                                 case 't': // current time
1222                                         dpsnprintf(temp, sizeof(temp), "%.0f:%.0f", floor(cl.time / 60), cl.time - floor(cl.time / 60) * 60);
1223                                         break;
1224                                 case 'r': // rocket launcher status ("I have RL", "I need rockets", "I need RL")
1225                                         if (!(cl.stats[STAT_ITEMS] & IT_ROCKET_LAUNCHER))
1226                                                 dpsnprintf(temp, sizeof(temp), "I need RL");
1227                                         else if (!cl.stats[STAT_ROCKETS])
1228                                                 dpsnprintf(temp, sizeof(temp), "I need rockets");
1229                                         else
1230                                                 dpsnprintf(temp, sizeof(temp), "I have RL");
1231                                         break;
1232                                 case 'p': // powerup status (outputs "quad" "pent" and "eyes" according to status)
1233                                         if (cl.stats[STAT_ITEMS] & IT_QUAD)
1234                                         {
1235                                                 if (temp[0])
1236                                                         strlcat(temp, " ", sizeof(temp));
1237                                                 strlcat(temp, "quad", sizeof(temp));
1238                                         }
1239                                         if (cl.stats[STAT_ITEMS] & IT_INVULNERABILITY)
1240                                         {
1241                                                 if (temp[0])
1242                                                         strlcat(temp, " ", sizeof(temp));
1243                                                 strlcat(temp, "pent", sizeof(temp));
1244                                         }
1245                                         if (cl.stats[STAT_ITEMS] & IT_INVISIBILITY)
1246                                         {
1247                                                 if (temp[0])
1248                                                         strlcat(temp, " ", sizeof(temp));
1249                                                 strlcat(temp, "eyes", sizeof(temp));
1250                                         }
1251                                         break;
1252                                 case 'w': // weapon status (outputs "SSG:NG:SNG:GL:RL:LG" with the text between : characters omitted if you lack the weapon)
1253                                         if (cl.stats[STAT_ITEMS] & IT_SUPER_SHOTGUN)
1254                                                 strlcat(temp, "SSG", sizeof(temp));
1255                                         strlcat(temp, ":", sizeof(temp));
1256                                         if (cl.stats[STAT_ITEMS] & IT_NAILGUN)
1257                                                 strlcat(temp, "NG", sizeof(temp));
1258                                         strlcat(temp, ":", sizeof(temp));
1259                                         if (cl.stats[STAT_ITEMS] & IT_SUPER_NAILGUN)
1260                                                 strlcat(temp, "SNG", sizeof(temp));
1261                                         strlcat(temp, ":", sizeof(temp));
1262                                         if (cl.stats[STAT_ITEMS] & IT_GRENADE_LAUNCHER)
1263                                                 strlcat(temp, "GL", sizeof(temp));
1264                                         strlcat(temp, ":", sizeof(temp));
1265                                         if (cl.stats[STAT_ITEMS] & IT_ROCKET_LAUNCHER)
1266                                                 strlcat(temp, "RL", sizeof(temp));
1267                                         strlcat(temp, ":", sizeof(temp));
1268                                         if (cl.stats[STAT_ITEMS] & IT_LIGHTNING)
1269                                                 strlcat(temp, "LG", sizeof(temp));
1270                                         break;
1271                                 default:
1272                                         // not a recognized macro, print it as-is...
1273                                         temp[0] = s[0];
1274                                         temp[1] = s[1];
1275                                         temp[2] = 0;
1276                                         break;
1277                                 }
1278                                 // write the resulting text
1279                                 SZ_Write(&cls.netcon->message, (unsigned char *)temp, strlen(temp));
1280                                 s += 2;
1281                                 continue;
1282                         }
1283                         MSG_WriteByte(&cls.netcon->message, *s);
1284                         s++;
1285                 }
1286                 MSG_WriteByte(&cls.netcon->message, 0);
1287         }
1288         else // any other command is passed on as-is
1289                 SZ_Write(&cls.netcon->message, (const unsigned char *)s, (int)strlen(s) + 1);
1290 }
1291
1292 /*
1293 ===================
1294 Cmd_ForwardToServer
1295
1296 Sends the entire command line over to the server
1297 ===================
1298 */
1299 void Cmd_ForwardToServer (void)
1300 {
1301         const char *s;
1302         if (!strcasecmp(Cmd_Argv(0), "cmd"))
1303         {
1304                 // we want to strip off "cmd", so just send the args
1305                 s = Cmd_Argc() > 1 ? Cmd_Args() : "";
1306         }
1307         else
1308         {
1309                 // we need to keep the command name, so send Cmd_Argv(0), a space and then Cmd_Args()
1310                 s = va("%s %s", Cmd_Argv(0), Cmd_Argc() > 1 ? Cmd_Args() : "");
1311         }
1312         // don't send an empty forward message if the user tries "cmd" by itself
1313         if (!s || !*s)
1314                 return;
1315         Cmd_ForwardStringToServer(s);
1316 }
1317
1318
1319 /*
1320 ================
1321 Cmd_CheckParm
1322
1323 Returns the position (1 to argc-1) in the command's argument list
1324 where the given parameter apears, or 0 if not present
1325 ================
1326 */
1327
1328 int Cmd_CheckParm (const char *parm)
1329 {
1330         int i;
1331
1332         if (!parm)
1333         {
1334                 Con_Printf ("Cmd_CheckParm: NULL");
1335                 return 0;
1336         }
1337
1338         for (i = 1; i < Cmd_Argc (); i++)
1339                 if (!strcasecmp (parm, Cmd_Argv (i)))
1340                         return i;
1341
1342         return 0;
1343 }
1344