# libtmux:break-pane

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

```
(break-pane client pane source-link session index &key name (detached t) (observe t) cancel-token timeout output-limit)
```

Break PANE from SOURCE-LINK into SESSION's free INDEX; return an outcome.
SOURCE-LINK fixes the session context when breaking the window's only pane;
tmux moves that link instead of creating another physical window. NAME is
literal. DETACHED defaults true. OBSERVE supplies the destination window link.
On tmux 3.7, a new named window requires a following RENAME-WINDOW in the same
guarded request; its configured hooks can run. Failure can leave the pane moved.
The pane keeps its identity. Signals INVALID-ARGUMENT, STALE-TARGET or an
operational condition. Occupied indexes are never overwritten.

## Parameters

- `client`
- `pane`
- `source-link`
- `session`
- `index`
- `name?`
- `detached?`
- `observe?`
- `cancel-token?`
- `timeout?`
- `output-limit?`

## tmux command

The tmux commands behind `break-pane`.

- [`break-pane`](/en/tmux/latest/manual/break-pane/)

## tmux C API

The C declarations in tmux that implement these commands.

- [`cmd_break_pane_entry`](/en/tmux/latest/reference/c-variable-cmd_break_pane_entry/) (attribute)
- [`cmd_break_pane_exec`](/en/tmux/latest/reference/c-function-cmd-break-pane-c-cmd_break_pane_exec/) (function)

## Guides

Pages that discuss `break-pane`.

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