# LibTmux::Server#attach

- **Module:** LibTmux::Server#
- **Package:** libtmux
- **Language:** Ruby
- **Kind:** method
- **Source:** https://github.com/libtmux/libtmux-ruby/blob/c6d9d21771828e583692ca899ed817f9640d6a55/gems/libtmux/lib/libtmux/terminal.rb#L47
- **Page:** https://libtmux.org/en/ruby/latest/reference/libtmux-server-attach/

```
LibTmux::Server#attach(session: ::LibTmux::EntityRef, terminal: ::IO, term: ::String, read_only: bool = nil, timeout: ::Numeric? = nil, cancel: untyped = nil) -> ::LibTmux::TerminalResult
```

Blocks until the owned interactive client exits. The caller supplies and
retains its TTY. Cancellation detaches this client, not pane commands.

Behavior contract: Terminal attachment.

## Raises

- `ArgumentError`