]> git.xonotic.org Git - xonotic/darkplaces.git/blobdiff - cmd.h
cmd: Re-re-re-re-implement the command parser. Allocate text only as needed.
[xonotic/darkplaces.git] / cmd.h
diff --git a/cmd.h b/cmd.h
index c8bf80ca4b6a1647040d8d716805c2b362b4b22d..c04e6c361b204fdbb0775c52f5ecce730d1e12df 100644 (file)
--- a/cmd.h
+++ b/cmd.h
@@ -37,32 +37,165 @@ The game starts with a Cbuf_AddText ("exec quake.rc\n"); Cbuf_Execute ();
 #ifndef CMD_H
 #define CMD_H
 
-/// allocates an initial text buffer that will grow as needed
-void Cbuf_Init (void);
+#include "thread.h"
 
-void Cmd_Init_Commands (void);
+struct cmd_state_s;
 
-void Cbuf_Shutdown (void);
+// Command flags
+#define CMD_CLIENT                             (1<<0)
+#define CMD_SERVER                             (1<<1)
+#define CMD_CLIENT_FROM_SERVER (1<<2)
+#define CMD_SERVER_FROM_CLIENT (1<<3)
+#define CMD_USERINFO                   (1<<4)
+#define CMD_CHEAT                              (1<<5)
+
+
+#define CMD_SHARED 3
+
+typedef void(*xcommand_t) (struct cmd_state_s *cmd);
+
+typedef enum
+{
+       src_client,             ///< came in over a net connection as a clc_stringcmd
+                                       ///< host_client will be valid during this state.
+       src_local               ///< from the command buffer
+} cmd_source_t;
+
+typedef struct cmd_alias_s
+{
+       struct cmd_alias_s *next;
+       char name[MAX_ALIAS_NAME];
+       char *value;
+       qbool initstate; // indicates this command existed at init
+       char *initialvalue; // backup copy of value at init
+} cmd_alias_t;
+
+typedef struct cmd_function_s
+{
+       int flags;
+       struct cmd_function_s *next;
+       const char *name;
+       const char *description;
+       xcommand_t function;
+       qbool csqcfunc;
+       qbool autofunc;
+       qbool initstate; // indicates this command existed at init
+} cmd_function_t;
+
+typedef struct cmddeferred_s
+{
+       struct cmddeferred_s *next;
+       char *value;
+       double delay;
+} cmddeferred_t;
+
+/// container for user-defined QC functions and aliases, shared between different command interpreters
+typedef struct cmd_userdefined_s
+{
+       // csqc functions - this is a mess
+       cmd_function_t *csqc_functions;
+
+       // aliases
+       cmd_alias_t *alias;
+}
+cmd_userdefined_t;
+
+/// command interpreter state - the tokenizing and execution of commands, as well as pointers to which cvars and aliases they can access
+typedef struct cmd_state_s
+{
+       mempool_t *mempool;
+
+       int argc;
+       const char *argv[MAX_ARGS];
+       const char *null_string;
+       const char *args;
+       cmd_source_t source;
+
+       struct cbuf_s *cbuf;
+
+       cmd_userdefined_t *userdefined; // possible csqc functions and aliases to execute
+
+       cmd_function_t *engine_functions;
+
+       cvar_state_t *cvars; // which cvar system is this cmd state able to access? (&cvars_all or &cvars_null)
+       int cvars_flagsmask; // which CVAR_* flags should be visible to this interpreter? (CVAR_CLIENT | CVAR_SERVER, or just CVAR_SERVER)
+
+       int cmd_flags; // cmd flags that identify this interpreter
+
+       /*
+        * If a requested flag matches auto_flags, a command will be
+        * added to a given interpreter with auto_function. For example,
+        * a CMD_SERVER_FROM_CLIENT command should be automatically added
+        * to the client interpreter as CL_ForwardToServer_f. It can be
+        * overridden at any time.
+        */
+       int auto_flags;
+       xcommand_t auto_function;
+}
+cmd_state_t;
+
+typedef struct cmd_input_s
+{
+       llist_t list;
+       cmd_state_t *source;
+       double delay;
+       size_t size;
+       size_t length;
+       char *text;
+       qbool pending;
+} cmd_input_t;
+
+typedef struct cbuf_s
+{
+       llist_t start;
+       llist_t deferred;
+       llist_t free;
+       qbool wait;
+       size_t maxsize;
+       size_t size;
+       char tokenizebuffer[CMD_TOKENIZELENGTH];
+       int tokenizebufferpos;
+       double deferred_oldtime;
+       void *lock;
+} cbuf_t;
+
+extern cmd_userdefined_t cmd_userdefined_all; // aliases and csqc functions
+extern cmd_userdefined_t cmd_userdefined_null; // intentionally empty
+
+// command interpreter for client commands injected by CSQC, MQC or client engine code
+// uses cmddefs_all
+extern cmd_state_t cmd_client;
+// command interpreter for server commands injected by MQC, SVQC, menu engine code or server engine code
+// uses cmddefs_all
+extern cmd_state_t cmd_server;
+// command interpreter for server commands received over network from clients
+// uses cmddefs_null
+extern cmd_state_t cmd_serverfromclient;
+
+extern qbool host_stuffcmdsrun;
+
+void Cbuf_Lock(cbuf_t *cbuf);
+void Cbuf_Unlock(cbuf_t *cbuf);
 
 /*! as new commands are generated from the console or keybindings,
  * the text is added to the end of the command buffer.
  */
-void Cbuf_AddText (const char *text);
+void Cbuf_AddText (cmd_state_t *cmd, const char *text);
 
 /*! when a command wants to issue other commands immediately, the text is
  * inserted at the beginning of the buffer, before any remaining unexecuted
  * commands.
  */
-void Cbuf_InsertText (const char *text);
+void Cbuf_InsertText (cmd_state_t *cmd, const char *text);
 
 /*! Pulls off terminated lines of text from the command buffer and sends
  * them through Cmd_ExecuteString.  Stops when the buffer is empty.
  * Normally called once per frame, but may be explicitly invoked.
  * \note Do not call inside a command function!
  */
-void Cbuf_Execute (void);
-/*! Performs deferred commands and runs Cbuf_Execute, called by Host_Main */
-void Cbuf_Frame (void);
+void Cbuf_Execute (cbuf_t *cbuf);
+/*! Performs deferred commands and runs Cbuf_Execute, called by Host_Frame */
+void Cbuf_Frame (cbuf_t *cbuf);
 
 //===========================================================================
 
@@ -77,66 +210,56 @@ not apropriate.
 
 */
 
-typedef void (*xcommand_t) (void);
-
-typedef enum
-{
-       src_client,             ///< came in over a net connection as a clc_stringcmd
-                                       ///< host_client will be valid during this state.
-       src_command             ///< from the command buffer
-} cmd_source_t;
-
-extern cmd_source_t cmd_source;
-
-void Cmd_Init (void);
-void Cmd_Shutdown (void);
+void Cmd_Init(void);
+void Cmd_Shutdown(void);
 
 // called by Host_Init, this marks cvars, commands and aliases with their init values
-void Cmd_SaveInitState (void);
+void Cmd_SaveInitState(void);
 // called by FS_GameDir_f, this restores cvars, commands and aliases to init values
-void Cmd_RestoreInitState (void);
+void Cmd_RestoreInitState(void);
 
-void Cmd_AddCommand_WithClientCommand (const char *cmd_name, xcommand_t consolefunction, xcommand_t clientfunction, const char *description);
-void Cmd_AddCommand (const char *cmd_name, xcommand_t function, const char *description);
+void Cmd_AddCommand(int flags, const char *cmd_name, xcommand_t function, const char *description);
 // called by the init functions of other parts of the program to
 // register commands and functions to call for them.
 // The cmd_name is referenced later, so it should not be in temp memory
 
+cmd_function_t *Cmd_GetCommand(cmd_state_t *cmd, const char *partial, size_t len, qbool casesensitive);
+
 /// used by the cvar code to check for cvar / command name overlap
-qboolean Cmd_Exists (const char *cmd_name);
+qbool Cmd_Exists (cmd_state_t *cmd, const char *cmd_name);
 
 /// attempts to match a partial command for automatic command line completion
 /// returns NULL if nothing fits
-const char *Cmd_CompleteCommand (const char *partial);
+const char *Cmd_CompleteCommand (cmd_state_t *cmd, const char *partial);
 
-int Cmd_CompleteAliasCountPossible (const char *partial);
+int Cmd_CompleteAliasCountPossible (cmd_state_t *cmd, const char *partial);
 
-const char **Cmd_CompleteAliasBuildList (const char *partial);
+const char **Cmd_CompleteAliasBuildList (cmd_state_t *cmd, const char *partial);
 
-int Cmd_CompleteCountPossible (const char *partial);
+int Cmd_CompleteCountPossible (cmd_state_t *cmd, const char *partial);
 
-const char **Cmd_CompleteBuildList (const char *partial);
+const char **Cmd_CompleteBuildList (cmd_state_t *cmd, const char *partial);
 
-void Cmd_CompleteCommandPrint (const char *partial);
+void Cmd_CompleteCommandPrint (cmd_state_t *cmd, const char *partial);
 
-const char *Cmd_CompleteAlias (const char *partial);
+const char *Cmd_CompleteAlias (cmd_state_t *cmd, const char *partial);
 
-void Cmd_CompleteAliasPrint (const char *partial);
+void Cmd_CompleteAliasPrint (cmd_state_t *cmd, const char *partial);
 
 // Enhanced console completion by Fett erich@heintz.com
 
 // Added by EvilTypeGuy eviltypeguy@qeradiant.com
 
-int Cmd_Argc (void);
-const char *Cmd_Argv (int arg);
-const char *Cmd_Args (void);
+int Cmd_Argc (cmd_state_t *cmd);
+const char *Cmd_Argv (cmd_state_t *cmd, int arg);
+const char *Cmd_Args (cmd_state_t *cmd);
 // The functions that execute commands get their parameters with these
-// functions. Cmd_Argv () will return an empty string, not a NULL
+// functions. Cmd_Argv(cmd, ) will return an empty string, not a NULL
 // if arg > argc, so string operations are always safe.
 
 /// Returns the position (1 to argc-1) in the command's argument list
 /// where the given parameter apears, or 0 if not present
-int Cmd_CheckParm (const char *parm);
+int Cmd_CheckParm (cmd_state_t *cmd, const char *parm);
 
 //void Cmd_TokenizeString (char *text);
 // Takes a null terminated string.  Does not need to be /n terminated.
@@ -144,20 +267,7 @@ int Cmd_CheckParm (const char *parm);
 
 /// Parses a single line of text into arguments and tries to execute it.
 /// The text can come from the command buffer, a remote client, or stdin.
-void Cmd_ExecuteString (const char *text, cmd_source_t src, qboolean lockmutex);
-
-/// adds the string as a clc_stringcmd to the client message.
-/// (used when there is no reason to generate a local command to do it)
-void Cmd_ForwardStringToServer (const char *s);
-
-/// adds the current command line as a clc_stringcmd to the client message.
-/// things like godmode, noclip, etc, are commands directed to the server,
-/// so when they are typed in at the console, they will need to be forwarded.
-void Cmd_ForwardToServer (void);
-
-/// used by command functions to send output to either the graphics console or
-/// passed as a print message to the client
-void Cmd_Print(const char *text);
+void Cmd_ExecuteString (cmd_state_t *cmd, const char *text, cmd_source_t src, qbool lockmutex);
 
 /// quotes a string so that it can be used as a command argument again;
 /// quoteset is a string that contains one or more of ", \, $ and specifies
@@ -165,9 +275,9 @@ void Cmd_Print(const char *text);
 /// "\"\\$"). Returns true on success, and false on overrun (in which case out
 /// will contain a part of the quoted string). If putquotes is set, the
 /// enclosing quote marks are also put.
-qboolean Cmd_QuoteString(char *out, size_t outlen, const char *in, const char *quoteset, qboolean putquotes);
+qbool Cmd_QuoteString(char *out, size_t outlen, const char *in, const char *quoteset, qbool putquotes);
 
-void Cmd_ClearCsqcFuncs (void);
+void Cmd_ClearCSQCCommands (cmd_state_t *cmd);
 
 #endif