# tmux_buffer:list/1

- **Package:** libtmux_erlang
- **Language:** Erlang
- **Kind:** function
- **Source:** https://github.com/libtmux/libtmux-erlang/blob/d1b6308440cf9eb8f6647e7ae434bce60e849368/apps/libtmux_erlang/src/tmux_buffer.erl#L106
- **Page:** https://libtmux.org/en/erlang/latest/reference/tmux_buffer-list-1/

```
list(Server)
-spec list(tmux_server:t()) ->
              {ok, [info()]} | {error, map()}.
```

Capture metadata in tmux's newest-first insertion order. Renaming preserves position; replacing data through `load/3` inserts a new buffer. Length frames preserve names containing delimiters, newlines or invalid UTF-8 on releases that permit them. Returns an ordinary list, bounded to 4096 rows and 1 MiB of encoded output. No payloads, hidden refresh or atomic snapshot is provided.

## Parameters

- `Server` (`tmux_server:t()`)

## tmux command

The tmux commands behind `list/1`.

- [`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)

## In other ports

List the paste buffers

| Language | Equivalent |
| --- | --- |
| Python | [`libtmux.Server.list_buffers`](/en/py/latest/reference/libtmux-server-list_buffers/) (method) |
| Ruby | [`LibTmux::Server#list_buffers`](/en/ruby/latest/reference/libtmux-server-list_buffers/) (method) |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | [`server.Server.listBuffers`](/en/ts/latest/reference/server-server-listbuffers/) (method) |
| Rust | [`server.Server.buffer_names`](/en/rs/latest/reference/server-server-buffer_names/) (method) |
| Go | [`tmux.Server.ListBuffers`](/en/go/latest/reference/tmux-server-listbuffers/) (method) |
| Java | [`io.github.libtmux.Server.buffers`](/en/java/latest/reference/io-github-libtmux-server-server-buffers/) (method) |
| C# | [`LibTmux.TmuxBuffers.GetAllAsync`](/en/csharp/latest/reference/libtmux-tmuxbuffers-getallasync/) (method) |
| C++ | [`libtmux::Server::buffers`](/en/cxx/latest/reference/libtmux-server-buffers/) (method) |
| Swift | [`Server.buffers()`](/en/swift/latest/reference/server-buffers()/) (method) |
| OCaml | No direct public OCaml equivalent is recorded for this operation. |
| Perl | No dedicated equivalent in the selected Perl surface. Explicit Server::cmd remains available for native tmux commands. |

No equivalent is recorded in Lua, PowerShell, Julia, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.