errors.TmuxServerRestartedError

class errors.TmuxServerRestartedError

class [source] ¶

class [source] ¶

class errors.TmuxServerRestartedError

A handle outlived the daemon that issued its id.

tmux numbers a restarted daemon's objects from the start, so %1 from before the restart names a pane that exists and belongs to somebody else. Raised from two places for one reason: the local check, when an acquisition has already seen the new daemon, and tmux itself, when it has not — the command carries a condition on the daemon's pid and start time and takes a branch that refuses instead of running.

delivery is always not_started: the whole point of the condition is that a refused command never ran, so retrying against a fresh handle is safe.

Examples

try {
  await pane.kill();
} catch (error) {
  if (error instanceof TmuxServerRestartedError) {
    // Read the server again; this pane's id belongs to another daemon now.
  }
}

Discussed in Socket and servers

Members

• code attribute
• constructor method
• delivery attribute How far the refused command got, which is nowhere.