# tmux_buffer:show/3

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

```
show(Server, Buffer, Options)
-spec show(tmux_server:t(), target(), read_options()) ->
              {ok, binary()} | {error, map()}.
```

Read exact payload bytes from an unattached one-shot client. No print decoding or newline removal applies. max_bytes is 0 through 1 MiB; exceeding it returns output_limit with partial command evidence, never a successful truncated value. deadline_ms is 1 through 600000. Missing buffers return buffer_not_found.

## Parameters

- `Server` (`tmux_server:t()`)
- `Buffer` (`target()`)
- `Options` (`read_options()`)

## tmux command

The tmux commands behind `show/3`.

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

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_show_buffer_entry`](/en/tmux/latest/reference/c-variable-cmd_show_buffer_entry/) (attribute)
- [`cmd_save_buffer_exec`](/en/tmux/latest/reference/c-function-cmd-save-buffer-c-cmd_save_buffer_exec/) (function)
