Server.session
Find the session with this exact name.
Source and package
- Qualified name
-
libtmux::server:: Server:: session - Module
- server
- Declared in
Server- Package
- libtmux
- Source
- crates/libtmux/src/server/discovery.rs
- Other languages
- Perlmethod Erlang PowerShell Julia Elixir Haskell Common Lisp Python Ruby Lua TypeScript Go Java C#C++ Swift Kotlin Scala OCamlfunction F# Clojure
-
Description#
Names are compared as bytes, because tmux permits names that are not valid UTF-8.
The comparison happens here rather than through tmux's
-f, which would filter server-side but requires building a format string around the name. A name containing#,}, or a comma would change the predicate's meaning, and tmux documents no escaping for those values, so a lookup would be an injection point.This also finds a session whose name holds
:or., which-t nameand-t =nameboth misread as a window or pane separator on every tmux release,=included: tmux splits a target on:/.before it looks for=.docs/findings.mdhas the detail, including thename:spelling that tmux 3.7a and later do accept for such a name. PreferSession::id()over the name for any target built after this call; an ID target parses with no split at all.Errors
Returns an error when the session listing fails.
In other ports#
Look one session up by target
| Language | Equivalent |
|---|---|
| Python | no equivalent on Server |
| Ruby | Lib |
| Erlang | tmux |
| Haskell | No public Haskell equivalent is implemented; the current modules expose scalar values and version parsing. |
| TypeScript | no equivalent on Server |
| Go | tmux |
| Java | no equivalent on Server |
| C# | Lib |
| C++ | libtmux:: |
| Swift | no equivalent on Server |
| OCaml | Libtmux Exact opaque-ID lookup in an existing snapshot, without I/O or tmux target expansion. |
| Perl | Lib Captured stable-ID lookup returns an entity or undef. Use Selection::one for strict criteria/name lookup. |
No equivalent is recorded in Lua, PowerShell, Julia, Elixir, Common Lisp, Clojure, Kotlin, Scala or F#.