Core Library0.xAPI Reference

Choose documentation 1

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.

module libtmux-raku latest

LibTmux.Engine

Source and package
Qualified name
LibTmux::Engine
Declared in
LibTmux
Package
LibTmux
Source
lib/LibTmux/Engine.rakumod
Anonymous module

Description#

Daemon identity and explicit effects

Endpoint captures argv scope and sanitized environment without I/O. Runtime owns its executor; Observation and Incarnation retain values only. Observing capabilities reads the daemon's version separately from the client executable. Prepared projections and references are bound to that daemon incarnation.

Managed commands check Linux boot ID and process start ticks, then enter one tmux command-list branch fenced by PID and tmux start time. A replacement between those steps is refused unless it reuses the same PID and the same second-resolution start time. That narrow race remains outside this guarantee. Persistent control connections provide a separate, connection-bound lifetime.

Identity probes use a nonce-bearing invalid command with an equals sign and hyphen. They cannot match tmux command-alias keys or trigger display-message hooks. Normal dispatch of canonical built-in commands is assumed; this is not a protocol for authenticating a hostile daemon or rewriting its configuration.

Closing Runtime stops its owned clients. It does not stop the tmux daemon or undo effects already performed. raw preserves execution bounds but provides no managed identity or compatibility guarantee. Text passed to a command may still have command-specific FORMAT semantics beyond command-language quoting.

Members3#

  • Endpoint class Immutable connection settings. Construction performs no tmux operation.
  • Incarnation class Value-only daemon identity. Retaining it keeps no process or executor alive.
  • Observation class One immutable pairing of daemon identity and capability evidence.
Esc

Type to search.

Reference previewOpen reference