tmux switch-client
Switch the current session for client target-client to target-session.
Syntax¶
tmux switch-client [-ElnprZ] [-c target-client] [-t target-session] [-T key-table]Alias: switchc.
Behavior¶
Switch the current session for client target-client
to target-session. As a special case,
-t may refer to a pane (a target that contains
‘:’,
‘.’ or
‘%’), to change session, window and
pane. In that case, -Z keeps the window zoomed if
it was zoomed. If -l, -n
or -p is used, the client is moved to the last,
next or previous session respectively. -r toggles
the client read-only and
ignore-size flags (see the
attach-session command).
If -E is used,
update-environment option will not be
applied.
-T sets the client's key table; the
next key from the client will be interpreted from
key-table. This may be used to configure multiple
prefix keys, or to bind commands to sequences of keys. For example, to
make typing ‘abc’ run the
list-keys command:
bind-key -Ttable2 c list-keys
bind-key -Ttable1 b switch-client -Ttable2
bind-key -Troot a switch-client -Ttable1C implementation¶
Internal declarations in tmux 3.2a:
Use from a library¶
Each API describes its own defaults, errors and execution model.
tmux sources and license
Syntax comes from tmux 3.2a list-commands. See the global options for sockets and configuration, and command syntax and targets.
Behavior is taken from the tmux 3.2a manual.
Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com> Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.