# libtmux:paste-buffer

- **Package:** libtmux
- **Language:** Common Lisp
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-lisp/blob/c2e5fc4ed3befda21f45dfa5d5868c38fd138311/src/buffers.lisp#L123
- **Public owner:** libtmux
- **Page:** https://libtmux.org/en/lisp/latest/reference/libtmux-paste-buffer/

```
(paste-buffer client pane &key name separator raw bracketed verbatim delete cancel-token timeout output-limit)
```

Paste a named or top buffer into PANE; return a COMMAND-OUTCOME.
Newlines become Return by default. RAW preserves newlines; SEPARATOR explicitly
replaces each newline with literal text and is mutually exclusive with RAW.
VERBATIM preserves every byte, implies RAW and disables tmux's newer control-byte
sanitization; it cannot be combined with a separator or bracket markers.
BRACKETED uses bracketed paste when the pane enabled it. DELETE removes the
selected buffer afterward. Tmux may accept without sending when input is
disabled; success does not prove application consumption. Signals STALE-TARGET
or an operational condition.

## Parameters

- `client`
- `pane`
- `name?`
- `separator?`
- `raw?`
- `bracketed?`
- `verbatim?`
- `delete?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## tmux command

The tmux commands behind `paste-buffer`.

- [`paste-buffer`](/en/tmux/latest/manual/paste-buffer/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_paste_buffer_entry`](/en/tmux/latest/reference/c-variable-cmd_paste_buffer_entry/) (attribute)
- [`cmd_paste_buffer_exec`](/en/tmux/latest/reference/c-function-cmd-paste-buffer-c-cmd_paste_buffer_exec/) (function)

## Guides

Pages that discuss `paste-buffer`.

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