# libtmux::Pane::enter_copy_mode

- **Module:** libtmux::Pane
- **Package:** libtmux-cxx
- **Language:** C++
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-cxx/blob/85e8bd603a322dc32bb8b9aeb1a72bcf36945f1d/include/libtmux/entities.hpp#L660
- **Page:** https://libtmux.org/reference/cxx/libtmux-pane-enter_copy_mode/

```
libtmux::Pane::enter_copy_mode() -> expected< void, CommandFailure >
```

Forget the scrollback, which is the only way to bound a pane's memory without restarting what is running in it.

Put this pane into copy mode, where its contents can be scrolled and selected rather than typed into.

Needs no attached client: the mode is pane state, which `in_mode` reports. Entering twice is harmless.
