Core LibraryunreleasedAPI Reference

Choose documentation 2

latest

Current version

latest
English

Unreleased libtmux has not been released. Its API may change during development. This site's structure and URLs may change too.

function libtmux-lisp latest

libtmux:new-session

Create a detached session on the selected live daemon; return a COMMAND-OUTCOME. NAME, WINDOW-NAME and CWD are literal. WIDTH/HEIGHT are positive initial cell dimensions through 65535. ENVIRONMENT, COMMAND and SHELL-COMMAND follow NEW-WINDOW. OUTCOME-VALUE supplies the created session; acquisition failure is retained separately. This operation requires an existing daemon and never silently starts or replaces one. A separate bootstrap path remains in development.

Source and package
Qualified name
libtmux:new-session
Declared in
libtmux
Package
libtmux
Source
src/creation.lisp
(new-session client &key name window-name width height cwd environment (command nil command-p) (shell-command nil shell-command-p) cancel-token timeout output-limit)

Public owner: libtmux

tmux command#

The tmux commands behind new-session.

tmux C API#

The C declarations in tmux that implement these commands.

Each path starts at a function a command runs, which is degree 1. The degree counts steps from there along the path, and each step is a call or a reference: degree 2 is reached from that function, degree 3 from the next, and so on.

Create a session and its first pane

  1. 1 cmd_new_session_exec
  2. calls → 2 spawn_window
  3. calls → 3 spawn_pane
  4. calls → 4 window_add_pane
  5. calls → 5 window_pane_create

Guides#

Pages that discuss new-session.

Esc

Type to search.

Reference previewOpen reference