On this page
libtmux::Server::control
- Module
- libtmux
- Declared in
- Server
- Package
- libtmux-cxx
- Source
- include/libtmux/server.hpp
- control ( session : std::string_view ) expected< Connection, ProtocolError >
-
Open a control-mode connection to one session.
This is the streaming half of the transport: a control connection stays open, exposes guarded reply blocks in wire order, and delivers events outside those blocks. The synchronous surface above is unaffected — a caller who never opens one never pays for it. A guarded block is not a final result for commands whose work tmux completes asynchronously.
Fails with
ProtocolError, notCommandFailure, because that is what theConnectionit returns speaks: an error type here that the value's own surface does not use would make the doorway disagree with the room.Discussed in Control mode vs one-shot
0 declared, 0 inherited