Core Library0.xAPI Reference

Choose documentation 3

latest

Current version

latest
English

Early release libtmux is released, and its APIs may still change between releases. This site's structure and URLs may change too.

struct libtmux-rs latest

PaneOutput

What one pane writes, as it writes it.

Source and package
Qualified name
libtmux::control::PaneOutput
Module
control
Package
libtmux
Source
crates/libtmux/src/control.rs
struct control.PaneOutput

Description#

Built by crate::Pane::stream_output(). This is a Stream of the bytes that pane produced, in order. Its infallible items combine normal termination, connection failure, and the watched pane being killed into None, once whatever was already buffered has drained. Call Self::shutdown() to observe a connection error, or use ControlEvents to receive errors during iteration; a killed pane is not an error either way, since ending is the correct answer once nothing more will arrive.

tmux is told to send this connection nothing but the watched pane. A neighbouring pane running yes otherwise moves tens of megabytes a second through it, and the watched pane's output queues behind that.

Each of these owns a control-mode connection, so a caller watching many panes at once is better served by ControlEvents and one connection, narrowed with ControlSender::watch_only().

Members5#

Common operations1#

  • snapshot method Capture the pane's visible screen at an ordered point in this stream.

Other members4#

  • next_chunk method Return the next chunk this pane wrote, or None once it stops.
  • pane method Return the pane being watched.
  • sender method Return the connection this stream reads, to mute or resume panes on it.
  • shutdown method End the connection and report how it went.
Esc

Type to search.

Reference previewOpen reference