version 1.28, 2009/07/12 23:45:03 |
version 1.29, 2009/07/13 17:47:46 |
|
|
.Ar target-client |
.Ar target-client |
is the name of the |
is the name of the |
.Xr pty 4 |
.Xr pty 4 |
file to which the client is connected, for example |
file to which the client is connected, for example either of |
|
.Pa /dev/ttyp1 |
|
or |
|
.Pa ttyp1 |
|
for the client attached to |
.Pa /dev/ttyp1 . |
.Pa /dev/ttyp1 . |
|
If no client is specified, the current client is chosen, if possible, or an |
|
error is reported. |
Clients may be listed with the |
Clients may be listed with the |
.Ic list-clients |
.Ic list-clients |
command. |
command. |
|
|
.Ar target-session |
.Ar target-session |
is either the name of a session (as listed by the |
is either the name of a session (as listed by the |
.Ic list-sessions |
.Ic list-sessions |
command) or the name of a client, |
command) or the name of a client with the same syntax as |
.Ar target-client , |
.Ar target-client , |
in which case the session attached to the client is used. |
in which case the session attached to the client is used. |
An |
When looking for the session name, |
|
.Nm |
|
initially searches for an exact match; if none is found, the session names |
|
are checked for any for which |
|
.Ar target-session |
|
is a prefix or for which it matches as an |
.Xr fnmatch 3 |
.Xr fnmatch 3 |
pattern may be used to match the session name. |
pattern. |
If a session is omitted when required, |
If a single match is found, it is used as the target session; multiple matches |
.Nm tmux |
produce an error |
attempts to use the current session; if no current session is available, the |
If a session is omitted, the current session is used if available; if no |
most recently created is chosen. |
current session is available, the most recently created is chosen. |
If no client is specified, the current client is chosen, if possible, or an |
|
error is reported. |
|
.Pp |
.Pp |
.Ar target-window |
.Ar target-window |
specifies a window in the form |
specifies a window in the form |
.Em session Ns \&: Ns Em index , |
.Em session Ns \&: Ns Em window , |
for example mysession:1. |
where |
|
.Em window |
|
is a window index, for example mysession:1, or a window name, |
|
.Xr fnmatch 3 |
|
pattern, or prefix, such as mysession:mywin[0-3]. |
|
If the latter, the window is looked up in a similar fashion to session name |
|
searches described above. |
The session is in the same form as for |
The session is in the same form as for |
.Ar target-session . |
.Ar target-session . |
.Em session , |
.Em session , |
|
|
is omitted, the same rules as for |
is omitted, the same rules as for |
.Ar target-session |
.Ar target-session |
are followed; if |
are followed; if |
.Em index |
.Em window |
is not present, the current window for the given session is used. |
is not present, the current window for the given session is used. |
When the argument does not contain a colon, |
When the argument does not contain a colon, |
.Nm |
.Nm |