# libtmux:list-buffers

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

```
(list-buffers client &key (row-limit 10000) cancel-token timeout output-limit)
```

Acquire buffer metadata; return a fresh simple vector of owned plists and an outcome.
Each plist has :BUFFER/NAME, :BUFFER/SIZE (bytes) and :BUFFER/CREATED (Unix
seconds). Preserve tmux's listing order; buffer names are mutable locators,
not captured entity identities. Empty listing returns #(). ROW-LIMIT bounds
decoding. Signals an operational or decoding condition with the raw outcome.

## Parameters

- `client`
- `row-limit?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## tmux command

The tmux commands behind `list-buffers`.

- [`list-buffers`](/en/tmux/latest/manual/list-buffers/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_list_buffers_entry`](/en/tmux/latest/reference/c-variable-cmd_list_buffers_entry/) (attribute)
- [`cmd_list_buffers_exec`](/en/tmux/latest/reference/c-function-cmd-list-buffers-c-cmd_list_buffers_exec/) (function)

## Guides

Pages that discuss `list-buffers`.

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