diff options
Diffstat (limited to 'doc/screen.info-1')
| -rw-r--r-- | doc/screen.info-1 | 180 |
1 files changed, 46 insertions, 134 deletions
diff --git a/doc/screen.info-1 b/doc/screen.info-1 index 63a2c6a..ece1aba 100644 --- a/doc/screen.info-1 +++ b/doc/screen.info-1 @@ -1,4 +1,4 @@ -This is screen.info, produced by makeinfo version 4.0 from +This is screen.info, produced by makeinfo version 4.5 from ./screen.texinfo. INFO-DIR-SECTION General Commands @@ -8,7 +8,7 @@ END-INFO-DIR-ENTRY This file documents the `Screen' virtual terminal manager. - Copyright (c) 1993-2002 Free Software Foundation, Inc. + Copyright (c) 1993-2003 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -31,7 +31,7 @@ Screen ****** This file documents the `Screen' virtual terminal manager, version -3.9.11. +4.0.2. * Menu: @@ -156,7 +156,7 @@ Another section (*note Customization::) deals with the contents of your If your terminal is a "true" auto-margin terminal (it doesn't allow the last position on the screen to be updated without scrolling the -screen) consider to use a version of your terminal's termcap that has +screen) consider using a version of your terminal's termcap that has automatic margins turned _off_. This will ensure an accurate and optimal update of the screen in all circumstances. Most terminals nowadays have "magic" margins (automatic margins plus usable last @@ -235,7 +235,7 @@ Invoking `Screen' literal command character (when typed after the command character) to Y. The defaults are `C-a' and `a', which can be specified as `-e^Aa'. When creating a `screen' session, this option sets the - default command caracter. In a multiuser session all users added + default command character. In a multiuser session all users added will start off with this command character. But when attaching to an already running session, this option only changes the command character of the attaching user. This option is equivalent to the @@ -281,10 +281,7 @@ Invoking `Screen' `-wipe' option. `-L' - Tell `screen' that your auto-margin terminal allows programs to - write to the last column of the last row of the screen without - scrolling. This can also be set in your `.screenrc' by specifying - `xn' in a `termcap' command (*note Termcap::). + Tell `screen' to turn on automatic output logging for the windows. `-m' Tell `screen' to ignore the `$STY' environment variable. When @@ -301,6 +298,13 @@ Invoking `Screen' This also starts `screen' in _detached_ mode, but doesn't fork a new process. The command exits if the session terminates. +`-p NAME_OR_NUMBER' + Preselect a window. This is usefull when you want to reattach to a + specific windor or you want to send a command via the `-X' option + to a specific window. As with screen's select commant, `-' selects + the blank window. As a special case for reattach, `=' brings up + the windowlist on the blank window. + `-q' Suppress printing of error messages. In combination with `-ls' the exit value is set as follows: 9 indicates a directory without @@ -373,6 +377,7 @@ Invoking `Screen' or detached screen sessions. Note that this command doesn't work if the session is password protected. + File: screen.info, Node: Customization, Next: Commands, Prev: Invoking Screen, Up: Top @@ -430,9 +435,10 @@ Source (none) Read and execute commands from file FILE. Source commands may be nested to a maximum recursion level of ten. If FILE is not an - absolute path and screen already processes a source command, - the parent directory of the running source command file is used to - search for the new command file before screen's current directory. + absolute path and screen is already processing a source + command, the parent directory of the running source command file + is used to search for the new command file before screen's + current directory. Note that termcap/terminfo/termcapinfo commands only work at startup and reattach time, so they must be reached via the @@ -785,6 +791,10 @@ Command Summary `allpartial STATE' Set all windows to partial refresh. *Note Redisplay::. +`altscreen STATE' + Enables support for the "alternate screen" terminal capability. + *Note Redisplay::. + `at [IDENT][#|*|%] COMMAND [ARGS]' Execute a command at other displays or windows. *Note At::. @@ -798,6 +808,9 @@ Command Summary Enable a clear screen to discard unwritten output. *Note Autonuke::. +`backtick ID LIFESPAN AUTOREFRESH COMMAND [ARGS]' + Define a command for the backtick string escape. *Note Backtick::. + `bce [STATE]' Change background color erase. *Note Character Processing::. @@ -810,6 +823,12 @@ Command Summary `bindkey [OPTS] [STRING [CMD ARGS]]' Bind a string to a series of keystrokes. *Note Bindkey::. +`blanker' + Blank the screen. *Note Screen Saver::. + +`blankerprg' + Define a blanker program. *Note Screen Saver::. + `break [DURATION]' Send a break signal to the current window. *Note Break::. @@ -908,6 +927,9 @@ Command Summary `defmonitor STATE' Select default activity monitoring behavior. *Note Monitor::. +`defnonblock STATE|NUMSECS' + Select default nonblock mode. *Note Nonblock::. + `defobuflimit LIMIT' Select default output buffer limit. *Note Obuflimit::. @@ -1002,6 +1024,9 @@ Command Summary `hstatus STATUS' Change the window's hardstatus line. *Note Hardstatus::. +`idle [TIMEOUT [CMD ARGS]]' + Define a screen saver command. *Note Screen Saver::. + `ignorecase [STATE]' Ignore character case in searches. *Note Searching::. @@ -1050,6 +1075,9 @@ Command Summary `markkeys STRING' Rebind keys in copy mode. *Note Copy Mode Keys::. +`maxwin N' + Set the maximum window number. *Note Maxwin::. + `meta' Insert the command character. *Note Command Character::. @@ -1071,8 +1099,9 @@ Command Summary `next' Switch to the next window. *Note Selecting::. -`nonblock STATE' - Disable flow control to the current display. *Note Nonblock::. +`nonblock [STATE|NUMSECS]' + Disable flow control to the current display. *Note + Nonblock::.|NUMSECS] `number [N]' Change/display the current window's number. *Note Number::. @@ -1271,6 +1300,9 @@ Command Summary `xon' Send an XON character. *Note XON/XOFF::. +`zmodem [off|auto|catch|pass]' + Define how screen treats zmodem requests. *Note Zmodem::. + `zombie [KEYS]' Keep dead windows. *Note Zombie::. @@ -1413,123 +1445,3 @@ Term command `screen -T vt100 rlogin othermachine' rather than setting and resetting the default. - -File: screen.info, Node: Window Types, Prev: Term, Up: New Window - -Window Types -============ - - Screen provides three different window types. New windows are created -with `screen''s `screen' command (*note Screen Command::). The first -parameter to the `screen' command defines which type of window is -created. The different window types are all special cases of the normal -type. They have been added in order to allow `screen' to be used -efficiently as a console with 100 or more windows. - * The normal window contains a shell (default, if no parameter is - given) or any other system command that could be executed from a - shell. (e.g. `slogin', etc...). - - * If a tty (character special device) name (e.g. `/dev/ttya') is - specified as the first parameter, then the window is directly - connected to this device. This window type is similar to `screen - cu -l /dev/ttya'. Read and write access is required on the device - node, an exclusive open is attempted on the node to mark the - connection line as busy. An optional parameter is allowed - consisting of a comma separated list of flags in the notation used - by `stty(1)': - `<baud_rate>' - Usually 300, 1200, 9600 or 19200. This affects transmission - as well as receive speed. - - `cs8 or cs7' - Specify the transmission of eight (or seven) bits per byte. - - `ixon or -ixon' - Enables (or disables) software flow-control (CTRL-S/CTRL-Q) - for sending data. - - `ixoff or -ixoff' - Enables (or disables) software flow-control for receiving - data. - - `istrip or -istrip' - Clear (or keep) the eight bit in each received byte. - - You may want to specify as many of these options as applicable. - Unspecified options cause the terminal driver to make up the - parameter values of the connection. These values are system - dependant and may be in defaults or values saved from a previous - connection. - - For tty windows, the `info' command shows some of the modem - control lines in the status line. These may include `RTS', `CTS', - `DTR', `CD' and more. This depends rather on on the available - `ioctl()''s and system header files than on the physical - capabilities of the serial board. The name of a logical low - (inactive) signal is preceded by an exclamation mark (`!'), - otherwise the signal is logical high (active). Unsupported but - shown signals are usually shown low. When the `CLOCAL' status bit - is true, the whole set of modem signals is placed inside curly - braces (`{' and `}'). When the `CRTSCTS' or `TIOCSOFTCAR' bit is - true, the signals `CTS' or `CD' are shown in parenthesis, - respectively. - - For tty windows, the command `break' causes the Data transmission - line (TxD) to go low for a specified period of time. This is - expected to be interpreted as break signal on the other side. No - data is sent and no modem control line is changed when a `break' - is issued. - - * If the first parameter is `//telnet', the second parameter is - expected to be a host name, and an optional third parameter may - specify a TCP port number (default decimal 23). Screen will - connect to a server listening on the remote host and use the - telnet protocol to communicate with that server. - - For telnet windows, the command `info' shows details about the - connection in square brackets (`[' and `]') at the end of the - status line. - `b' - BINARY. The connection is in binary mode. - - `e' - ECHO. Local echo is disabled. - - `c' - SGA. The connection is in `character mode' (default: `line - mode'). - - `t' - TTYPE. The terminal type has been requested by the remote - host. Screen sends the name `screen' unless instructed - otherwise (see also the command `term'). - - `w' - NAWS. The remote site is notified about window size changes. - - `f' - LFLOW. The remote host will send flow control information. - (Ignored at the moment.) Additional flags for debugging are - `x', `t' and `n' (XDISPLOC, TSPEED and NEWENV). - - For telnet windows, the command `break' sends the telnet code `IAC - BREAK' (decimal 243) to the remote host. - - - -File: screen.info, Node: Selecting, Next: Session Management, Prev: New Window, Up: Top - -Selecting a Window -****************** - - This section describes the commands for switching between windows in -an `screen' session. The windows are numbered from 0 to 9, and are -created in that order by default (*note New Window::). - -* Menu: - -* Next and Previous:: Forward or back one window. -* Other Window:: Switch back and forth between two windows. -* Select:: Switch to a window (and to one after `kill'). -* Windowlist:: Present a list of all windows for selection. - |