# libtmux:refresh-client

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/client-operations.lisp#L78
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-refresh-client/

```
(refresh-client client target &key status-only cancel-token timeout output-limit)
```

Request a redraw of captured terminal TARGET; return a COMMAND-OUTCOME.
STATUS-ONLY requests only the status line; NIL requests the whole display.
Success acknowledges scheduling, not completed terminal rendering. This is an
external operation; REFRESH instead acquires a replacement observation.
CLIENT must own TARGET. Blocks under shared preflight/dispatch limits. A stale
or foreign target signals STALE-TARGET; other failures retain their outcome.
The client fingerprint is checked before dispatch, with a remaining replacement
race. Returns no replacement and never retries the request.

See also: `libtmux:fetch-clients`, `libtmux:outcome-status`, `libtmux:refresh`.

## Parameters

- `client`
- `target`
- `status-only?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## tmux command

The tmux commands behind `refresh-client`.

- [`refresh-client`](/en/tmux/latest/manual/refresh-client/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_refresh_client_entry`](/en/tmux/latest/reference/c-variable-cmd_refresh_client_entry/) (attribute)
- [`cmd_refresh_client_exec`](/en/tmux/latest/reference/c-function-cmd-refresh-client-c-cmd_refresh_client_exec/) (function)

## Guides

Pages that discuss `refresh-client`.

- [Explicit operations](/en/lisp/latest/guides/operations/)