# libtmux.control:submit-command

- **Package:** libtmux/control
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/control.lisp#L261
- **Public owner:** libtmux.control
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-control-submit-command/

```
(submit-command connection argv &key effect (timeout 30))
```

Queue copied tmux ARGV and return a REQUEST without waiting for its reply.
EFFECT must explicitly be :READ or :MUTATION; it records caller intent, not a
command restriction. TIMEOUT is a nonnegative real deadline budget starting at
submission, including queue time. A zero budget can expire before dispatch.
Commands execute serially. Full queues signal CONNECTION-BUSY; closing ones
signal CONNECTION-CLOSED. Use argv for tmux syntax, not shell interpolation.
This raw path does not validate or refresh captured operational targets.

See also: `libtmux.control:await-request`, `libtmux.control:cancel-request`, `libtmux.control:request-state`.

## Parameters

- `connection`
- `argv`
- `effect?`
- `timeout?`

## Guides

Pages that discuss `submit-command`.

- [Getting started](/en/lisp/latest/guides/getting-started/)