FreeBSD Manual Pages
MTM(1) General Commands Manual MTM(1) NAME mtm -- a micro-terminal multiplexer SYNOPSIS mtm [-T HOST] [-t TERM] [-c CHARACTER] DESCRIPTION mtm is a terminal multiplexer, a program that allows multiple terminal ses- sions to run within a single (physical or virtual) terminal session. The options are -T HOST Assume that the host terminal (i.e. the terminal under which mtm is running) is of type HOST. By default, the contents of the TERM en- vironment variable are used. -t TERM Set the TERM environment variable within the mtm session to TERM. By default, this is screen-bce, or screen-256color-bce if mtm de- tects that the host terminal supports 256 colors. Note that this default can be changed at compile time, and thus may differ in your installation. -c CHARACTER Commands are prefixed using CHARACTER in combination with the "control" key. By default this is "g". Note that this default can be changed at compile time, and thus may differ in your installa- tion. Usage mtm divides the screen into multiple virtual terminals. Each virtual ter- minal is updated and accessed independently. At any given time, exactly one virtual terminal is "focused", meaning that it receives any typed char- acters. The currently-focused terminal is indicated by the location of the cursor. While running, the following keys are recognized as commands to mtm when prefixed with the command character: Up/Down/Right/Left Arrow Select the terminal above/below/to the right of/to the left of the currently focused one. o (the letter oh) Switch to the last-focused terminal. h or v Split the focused terminal in half and stack horizontally (for 'h') or stack vertically (for 'v'); the newly-created terminal will be focused. w Delete the currently focused terminal. l (the letter ell) Redraw the screen. PgUp/PgDown/End Scroll the terminal up/down/to the bottom. By default, mtm stores up to 1000 lines of scrolling history. Note that if the screen is currently scrolled back (that is, the scrollback buffer is not at the bottom) these keys need not be prefixed with the command key. mtm will also scroll to the bottom on user input. Note that these command keys can be changed at compile time, and therefore may be different for this installation of mtm. mtm will exit when its last virtual terminal is closed. The Value of -t The terminal name passed to -t does not change how mtm interprets command sequences, but rather changes what kind of terminal mtm claims to be. Safe bets for this value are mtm This is the terminal described by the mtm.ti terminfo(5) descrip- tion that shipped with mtm. It is not necessarily installed on your system, but if it is, it will tell terminfo(5) -aware programs how to use all of the mtm features. Note that there aren't any user-visible features added here, but mtm supports some extra cur- sor-movement commands, and thus using this terminal type where available may result in slightly speedier screen updates. mtm-256color This is the same as the mtm terminal type, but advertising 256-color support. This can be used if the mtm terminfo(5) de- scription is installed and the host terminal supports 256 or more colors. screen-bce This is the default if 256-color support is not detected. It is widely supported and its description is installed by default on most systems. This is a good choice if the mtm terminfo(5) de- scription is not installed everywhere you expect to use mtm. screen-bce-256color This is the default if 256-color support is detected. The same ad- vice given for screen-bce above applies here too. The mtm Environment mtm sets the MTM environment variable to its process ID (see getpid(2)). Programs can test for the presence of this variable to determine if they are running inside of a mtm instance. ENVIRONMENT The following environment variables affect the operation of mtm: TERM Names the hosting terminal's type. This can be overridden using the -T option. ESCDELAY This variable specifies the number of milliseconds mtm will wait after seeing an escape character for a special character sequence to complete. By default this is 1000 (one second). LC_CTYPE LC_ALL LANG These variables are consulted to determine the encoding used for textual data. SHELL If set, mtm will launch the program named by this command in new virtual terminals. If this is unset, mtm will use the value of the "command interpreter" field of the password database (see passwd(5)) if available, and will finally fall back to /bin/sh. SEE ALSO sh(1) terminfo(5) BUGS mtm will attempt to fit all virtual terminals in the window at once. If many terminals are created and the containing window is shrunk too small, the display will be suboptimal. The only human language in which output is generated and in which documen- tation is available is English, regardless of the user's preferred lan- guage. FreeBSD ports 15.quarterly $Mdocdate$ MTM(1)
NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | SEE ALSO | BUGS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mtm&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>