Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



   tmux    ( 1 )

оконечный мультиплексор (terminal multiplexer)

Формат (Format)

Certain commands accept the -F flag with a format argument.  This
     is a string which controls the output format of the command.
     Format variables are enclosed in '#{' and '}', for example
     '#{session_name}'.  The possible variables are listed in the table
     below, or the name of a tmux option may be used for an option's
     value.  Some variables have a shorter alias such as '#S'; '##' is
     replaced by a single '#', '#,' by a ',' and '#}' by a '}'.

Conditionals are available by prefixing with '?' and separating two alternatives with a comma; if the specified variable exists and is not zero, the first alternative is chosen, otherwise the second is used. For example '#{?session_attached,attached,not attached}' will include the string 'attached' if the session is attached and the string 'not attached' if it is unattached, or '#{?automatic-rename,yes,no}' will include 'yes' if automatic-rename is enabled, or 'no' if not. Conditionals can be nested arbitrarily. Inside a conditional, ',' and '}' must be escaped as '#,' and '#}', unless they are part of a '#{...}' replacement. For example:

#{?pane_in_mode,#[fg=white#,bg=red],#[fg=red#,bg=white]}#W .

String comparisons may be expressed by prefixing two comma- separated alternatives by '==', '!=', '<', '>', '<=' or '>=' and a colon. For example '#{==:#{host},myhost}' will be replaced by '1' if running on 'myhost', otherwise by '0'. '||' and '&&' evaluate to true if either or both of two comma-separated alternatives are true, for example '#{||:#{pane_in_mode},#{alternate_on}}'.

An 'm' specifies an fnmatch(3) or regular expression comparison. The first argument is the pattern and the second the string to compare. An optional argument specifies flags: 'r' means the pattern is a regular expression instead of the default fnmatch(3) pattern, and 'i' means to ignore case. For example: '#{m:*foo*,#{host}}' or '#{m/ri:^A,MYVAR}'. A 'C' performs a search for an fnmatch(3) pattern or regular expression in the pane content and evaluates to zero if not found, or a line number if found. Like 'm', an 'r' flag means search for a regular expression and 'i' ignores case. For example: '#{C/r:^Start}'

Numeric operators may be performed by prefixing two comma-separated alternatives with an 'e' and an operator. An optional 'f' flag may be given after the operator to use floating point numbers, otherwise integers are used. This may be followed by a number giving the number of decimal places to use for the result. The available operators are: addition '+', subtraction '-', multiplication '*', division '/', modulus 'm' or '%' (note that '%' must be escaped as '%%' in formats which are also expanded by strftime(3)) and numeric comparison operators '==', '!=', '<', '<=', '>' and '>='. For example, '#{e|*|f|4:5.5,3}' multiplies 5.5 by 3 for a result with four decimal places and '#{e|%%:7,3}' returns the modulus of 7 and 3. 'a' replaces a numeric argument by its ASCII equivalent, so '#{a:98}' results in 'b'.

A limit may be placed on the length of the resultant string by prefixing it by an '=', a number and a colon. Positive numbers count from the start of the string and negative from the end, so '#{=5:pane_title}' will include at most the first five characters of the pane title, or '#{=-5:pane_title}' the last five characters. A suffix or prefix may be given as a second argument - if provided then it is appended or prepended to the string if the length has been trimmed, for example '#{=/5/...:pane_title}' will append '...' if the pane title is more than five characters. Similarly, 'p' pads the string to a given width, for example '#{p10:pane_title}' will result in a width of at least 10 characters. A positive width pads on the left, a negative on the right. 'n' expands to the length of the variable and 'w' to its width when displayed, for example '#{n:window_name}'.

Prefixing a time variable with 't:' will convert it to a string, so if '#{window_activity}' gives '1445765102', '#{t:window_activity}' gives 'Sun Oct 25 09:25:02 2015'. Adding 'p (' '`t/p`') will use shorter but less accurate time format for times in the past. A custom format may be given using an 'f' suffix (note that '%' must be escaped as '%%' if the format is separately being passed through strftime(3), for example in the status-left option): '#{t/f/%%H#:%%M:window_activity}', see strftime(3).

The 'b:' and 'd:' prefixes are basename(3) and dirname(3) of the variable respectively. 'q:' will escape sh(1) special characters or with a 'h' suffix, escape hash characters (so '#' becomes '##'). 'E:' will expand the format twice, for example '#{E:status-left}' is the result of expanding the content of the status-left option rather than the option itself. 'T:' is like 'E:' but also expands strftime(3) specifiers. 'S:', 'W:' or 'P:' will loop over each session, window or pane and insert the format once for each. For windows and panes, two comma-separated formats may be given: the second is used for the current window or active pane. For example, to get a list of windows formatted like the status line:

#{W:#{E:window-status-format} ,#{E:window-status-current-format} }

'N:' checks if a window (without any suffix or with the 'w' suffix) or a session (with the 's' suffix) name exists, for example '`N/w:foo`' is replaced with 1 if a window named 'foo' exists.

A prefix of the form 's/foo/bar/:' will substitute 'foo' with 'bar' throughout. The first argument may be an extended regular expression and a final argument may be 'i' to ignore case, for example 's/a(.)/\1x/i:' would change 'abABab' into 'bxBxbx'.

In addition, the last line of a shell command's output may be inserted using '#()'. For example, '#(uptime)' will insert the system's uptime. When constructing formats, tmux does not wait for '#()' commands to finish; instead, the previous result from running the same command is used, or a placeholder if the command has not been run before. If the command hasn't exited, the most recent line of output will be used, but the status line will not be updated more than once a second. Commands are executed with the tmux global environment set (see the GLOBAL AND SESSION ENVIRONMENT section).

An 'l' specifies that a string should be interpreted literally and not expanded. For example '#{l:#{?pane_in_mode,yes,no}}' will be replaced by '#{?pane_in_mode,yes,no}'.

The following variables are available, where appropriate:

Variable name Alias Replaced with active_window_index Index of active window in session alternate_on 1 if pane is in alternate screen alternate_saved_x Saved cursor X in alternate screen alternate_saved_y Saved cursor Y in alternate screen buffer_created Time buffer created buffer_name Name of buffer buffer_sample Sample of start of buffer buffer_size Size of the specified buffer in bytes client_activity Time client last had activity client_cell_height Height of each client cell in pixels client_cell_width Width of each client cell in pixels client_control_mode 1 if client is in control mode client_created Time client created client_discarded Bytes discarded when client behind client_flags List of client flags client_height Height of client client_key_table Current key table client_last_session Name of the client's last session client_name Name of client client_pid PID of client process client_prefix 1 if prefix key has been pressed client_readonly 1 if client is readonly client_session Name of the client's session client_termfeatures Terminal features of client, if any client_termname Terminal name of client client_termtype Terminal type of client, if available client_tty Pseudo terminal of client client_utf8 1 if client supports UTF-8 client_width Width of client client_written Bytes written to client command Name of command in use, if any command_list_alias Command alias if listing commands command_list_name Command name if listing commands command_list_usage Command usage if listing commands config_files List of configuration files loaded copy_cursor_line Line the cursor is on in copy mode copy_cursor_word Word under cursor in copy mode copy_cursor_x Cursor X position in copy mode copy_cursor_y Cursor Y position in copy mode current_file Current configuration file cursor_character Character at cursor in pane cursor_flag Pane cursor flag cursor_x Cursor X position in pane cursor_y Cursor Y position in pane history_bytes Number of bytes in window history history_limit Maximum window history lines history_size Size of history in lines hook Name of running hook, if any hook_client Name of client where hook was run, if any hook_pane ID of pane where hook was run, if any hook_session ID of session where hook was run, if any hook_session_name Name of session where hook was run, if any hook_window ID of window where hook was run, if any hook_window_name Name of window where hook was run, if any host #H Hostname of local host host_short #h Hostname of local host (no domain name) insert_flag Pane insert flag keypad_cursor_flag Pane keypad cursor flag keypad_flag Pane keypad flag last_window_index Index of last window in session line Line number in the list mouse_all_flag Pane mouse all flag mouse_any_flag Pane mouse any flag mouse_button_flag Pane mouse button flag mouse_line Line under mouse, if any mouse_sgr_flag Pane mouse SGR flag mouse_standard_flag Pane mouse standard flag mouse_utf8_flag Pane mouse UTF-8 flag mouse_word Word under mouse, if any mouse_x Mouse X position, if any mouse_y Mouse Y position, if any origin_flag Pane origin flag pane_active 1 if active pane pane_at_bottom 1 if pane is at the bottom of window pane_at_left 1 if pane is at the left of window pane_at_right 1 if pane is at the right of window pane_at_top 1 if pane is at the top of window pane_bg Pane background colour pane_bottom Bottom of pane pane_current_command Current command if available pane_current_path Current path if available pane_dead 1 if pane is dead pane_dead_status Exit status of process in dead pane pane_fg Pane foreground colour pane_format 1 if format is for a pane pane_height Height of pane pane_id #D Unique pane ID pane_in_mode 1 if pane is in a mode pane_index #P Index of pane pane_input_off 1 if input to pane is disabled pane_last 1 if last pane pane_left Left of pane pane_marked 1 if this is the marked pane pane_marked_set 1 if a marked pane is set pane_mode Name of pane mode, if any pane_path Path of pane (can be set by application) pane_pid PID of first process in pane pane_pipe 1 if pane is being piped pane_right Right of pane pane_search_string Last search string in copy mode pane_start_command Command pane started with pane_synchronized 1 if pane is synchronized pane_tabs Pane tab positions pane_title #T Title of pane (can be set by application) pane_top Top of pane pane_tty Pseudo terminal of pane pane_width Width of pane pid Server PID rectangle_toggle 1 if rectangle selection is activated scroll_position Scroll position in copy mode scroll_region_lower Bottom of scroll region in pane scroll_region_upper Top of scroll region in pane search_match Search match if any search_present 1 if search started in copy mode selection_active 1 if selection started and changes with the cursor in copy mode selection_end_x X position of the end of the selection selection_end_y Y position of the end of the selection selection_present 1 if selection started in copy mode selection_start_x X position of the start of the selection selection_start_y Y position of the start of the selection session_activity Time of session last activity session_alerts List of window indexes with alerts session_attached Number of clients session is attached to session_attached_list List of clients session is attached to session_created Time session created session_format 1 if format is for a session session_group Name of session group session_group_attached Number of clients sessions in group are attached to session_group_attached_list List of clients sessions in group are attached to session_group_list List of sessions in group session_group_many_attached 1 if multiple clients attached to sessions in group session_group_size Size of session group session_grouped 1 if session in a group session_id Unique session ID session_last_attached Time session last attached session_many_attached 1 if multiple clients attached session_marked 1 if this session contains the marked pane session_name #S Name of session session_path Working directory of session session_stack Window indexes in most recent order session_windows Number of windows in session socket_path Server socket path start_time Server start time version Server version window_active 1 if window active window_active_clients Number of clients viewing this window window_active_clients_list List of clients viewing this window window_active_sessions Number of sessions on which this window is active window_active_sessions_list List of sessions on which this window is active window_activity Time of window last activity window_activity_flag 1 if window has activity window_bell_flag 1 if window has bell window_bigger 1 if window is larger than client window_cell_height Height of each cell in pixels window_cell_width Width of each cell in pixels window_end_flag 1 if window has the highest index window_flags #F Window flags with # escaped as ## window_raw_flags Window flags with nothing escaped window_format 1 if format is for a window window_height Height of window window_id Unique window ID window_index #I Index of window window_last_flag 1 if window is the last used window_layout Window layout description, ignoring zoomed window panes window_linked 1 if window is linked across sessions window_linked_sessions Number of sessions this window is linked to window_linked_sessions_list List of sessions this window is linked to window_marked_flag 1 if window contains the marked pane window_name #W Name of window window_offset_x X offset into window if larger than client window_offset_y Y offset into window if larger than client window_panes Number of panes in window window_silence_flag 1 if window has silence alert window_stack_index Index in session most recent stack window_start_flag 1 if window has the lowest index window_visible_layout Window layout description, respecting zoomed window panes window_width Width of window window_zoomed_flag 1 if window is zoomed wrap_flag Pane wrap flag