libtmux
Go

Choose a port 22

Scripting & web

PythonNo matching page
RubyNo matching page
LuaNo matching page
JuliaNo matching page
TypeScriptNo matching page
PerlNo matching page

Compiled & native

RustNo matching page
Go
C++No matching page
Common LispNo matching page
SwiftNo matching page
OCamlNo matching page
HaskellNo matching page

JVM

JavaNo matching page
KotlinNo matching page
ScalaNo matching page
ClojureNo matching page

.NET

C#No matching page
F#No matching page
PowerShellNo matching page

BEAM

ErlangNo matching page
ElixirNo matching page

tmux

tmux CLI

GitHub pkg.go.dev
Packages

Packages and source 16

Source

tmuxpackage · tmux libtmux-golibtmux/libtmux-go tmuxqpackage · tmuxq tmux/tmuxtestpackage · tmux/tmuxtest mcpmodule · mcp libtmux-mcpcommand · mcp/cmd/libtmux-mcp workspacemodule · workspace tmux-workspacecommand · workspace/cmd/tmux-workspace

Packages

tmuxpackage · libtmux-go/tmux libtmux-gomodule · libtmux-go tmuxqpackage · libtmux-go/tmuxq tmux/tmuxtestpackage · libtmux-go/tmux/tmuxtest mcpmodule · libtmux-go/mcp libtmux-mcpcommand · libtmux-go/mcp/cmd/libtmux-mcp workspacemodule · libtmux-go/workspace tmux-workspacecommand · libtmux-go/workspace/cmd/tmux-workspace

Go · libtmux/libtmux-go
Search
Colour scheme
Menu
Reference MCP
GitHub pkg.go.dev
Packages

Packages and source 16

Source

tmuxpackage · tmux libtmux-golibtmux/libtmux-go tmuxqpackage · tmuxq tmux/tmuxtestpackage · tmux/tmuxtest mcpmodule · mcp libtmux-mcpcommand · mcp/cmd/libtmux-mcp workspacemodule · workspace tmux-workspacecommand · workspace/cmd/tmux-workspace

Packages

tmuxpackage · libtmux-go/tmux libtmux-gomodule · libtmux-go tmuxqpackage · libtmux-go/tmuxq tmux/tmuxtestpackage · libtmux-go/tmux/tmuxtest mcpmodule · libtmux-go/mcp libtmux-mcpcommand · libtmux-go/mcp/cmd/libtmux-mcp workspacemodule · libtmux-go/workspace tmux-workspacecommand · libtmux-go/workspace/cmd/tmux-workspace

Go · libtmux/libtmux-go
Core Library0.xAPI Reference

Choose documentation 3

Go · latest · en
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.

method libtmux-go latest

Server.SessionByName

SessionByName performs a live lookup of the session tmux knows by name and returns a newly materialized record. A name no session holds reports ErrNotFound.

Source and package
Qualified name
tmux.Server.SessionByName
Package
tmux
Declared in
Server
Distribution
github.com/libtmux/libtmux-go/tmux
Source
tmux/lookup.go
func (s Server) SessionByName( ctx context.Context, name string, ) (Session, error)
method [source]

Description#

tmux keeps session names unique, so a name identifies one session for as long as it keeps it. A SessionID does not change, which is why the records this package hands back carry one and Server.Session takes one; a name is what a person types and what a workspace file records.

Parameters

tmux command#

The tmux commands behind SessionByName.

list-sessions run-shell (the Server has no daemon identity)

tmux C API#

The C declarations in tmux that implement these commands.

cmd_list_sessions_entry cmd_list_sessions_exec cmd_run_shell_entry cmd_run_shell_exec

Related types#

Server

Server is an immutable handle to one tmux configuration. Its zero value is invalid. Copying a configured Server preserves its configuration and shares its mutex-guarded version cache and checked daemon identity, so a Server and the values derived from it are safe for concurrent method calls (see the package documentation).

Session

Session is one materialized tmux session record. It is normally returned by Server.Snapshot, Server.Session, or Session.Refresh. A zero Session is not a usable tmux target.

Esc

Type to search.

 Reference previewOpen reference