document scriptcmd

commands/script/index.rst

@@ -18,4 +18,5 @@ This section contains various commands that are only used or available in a scri
    printstack
    ret
    scriptload
-   scriptdll
+   scriptdll
+   scriptcmd

commands/script/scriptcmd.md

@@ -0,0 +1,29 @@
+# scriptcmd
+
+Execute a command in the context of a running script.
+
+## arguments
+
+Unlike other commands this command forwards everything after `scriptcmd ` directly to the command processor.
+
+For example `scriptcmd add rax, 0x1245` will execute the command `add rax, 0x1234`.
+
+## result
+
+This command does not set any result variables.
+
+## example
+
+This command can be used in combination with [SetBreakpointCommand](../conditional-breakpoint-control/SetBreakpointCommand.md) to execute scripts on breakpoint callbacks:
+
+```
+fn_addr = module.dll:$0x1234 // module.dll RVA 0x1234
+bp fn_addr
+SetBreakpointCommand fn_addr, "scriptcmd call mycallback"
+
+// make sure the script is not unloaded
+
+mycallback:
+log "fn({arg.get(0)}, {arg.get(1)})"
+ret
+```