diff options
Diffstat (limited to 'doc/screen.info-5')
| -rw-r--r-- | doc/screen.info-5 | 545 |
1 files changed, 545 insertions, 0 deletions
diff --git a/doc/screen.info-5 b/doc/screen.info-5 new file mode 100644 index 0000000..e45ab2b --- /dev/null +++ b/doc/screen.info-5 @@ -0,0 +1,545 @@ +This is Info file screen.info, produced by Makeinfo-1.55 from the input +file ./screen.texinfo. + + This file documents the `Screen' virtual terminal manager. + + Copyright (c) 1993-1995 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 +preserved on all copies. + + Permission is granted to copy and distribute modified versions of +this manual under the conditions for verbatim copying, provided that +the entire resulting derived work is distributed under the terms of a +permission notice identical to this one. + + Permission is granted to copy and distribute translations of this +manual into another language, under the above conditions for modified +versions, except that this permission notice may be stated in a +translation approved by the Foundation. + + +File: screen.info, Node: Credits, Next: Bugs, Prev: Files, Up: Top + +Credits +******* + + Authors + ======= + + Originally created by Oliver Laumann, this +latest version was produced by Wayne Davison, Juergen Weigert and +Michael Schroeder. + + Contributors + ============ + + Ken Beal (kbeal@amber.ssd.csd.harris.com), + Rudolf Koenig (rfkoenig@informatik.uni-erlangen.de), + Toerless Eckert (eckert@informatik.uni-erlangen.de), + Wayne Davison (davison@borland.com), + Patrick Wolfe (pat@kai.com, kailand!pat), + Bart Schaefer (schaefer@cse.ogi.edu), + Nathan Glasser (nathan@brokaw.lcs.mit.edu), + Larry W. Virden (lvirden@cas.org), + Howard Chu (hyc@hanauma.jpl.nasa.gov), + Tim MacKenzie (tym@dibbler.cs.monash.edu.au), + Markku Jarvinen (mta@{cc,cs,ee}.tut.fi), + Marc Boucher (marc@CAM.ORG), + Doug Siebert (dsiebert@isca.uiowa.edu), + Ken Stillson (stillson@tsfsrv.mitre.org), + Ian Frechett (frechett@spot.Colorado.EDU), + Brian Koehmstedt (bpk@gnu.ai.mit.edu), + Don Smith (djs6015@ultb.isc.rit.edu), + Frank van der Linden (vdlinden@fwi.uva.nl), + Martin Schweikert (schweik@cpp.ob.open.de), + David Vrona (dave@sashimi.lcu.com), + E. Tye McQueen (tye%spillman.UUCP@uunet.uu.net), + Matthew Green (mrg@mame.mu.oz.au), + Christopher Williams (cgw@unt.edu), + Matt Mosley (mattm@access.digex.net), + Gregory Neil Shapiro (gshapiro@wpi.WPI.EDU), + Jason Merrill (jason@jarthur.Claremont.EDU). + + Version + ======= + + This manual describes version 3.8.0 of the +`screen' program. Its roots are a merge of a custom version 2.3PR7 by +Wayne Davison and several enhancements to Oliver Laumann's version 2.0. +Note that all versions numbered 2.x are copyright by Oliver Laumann. + + See also *Note Availability::. + + +File: screen.info, Node: Bugs, Next: Installation, Prev: Credits, Up: Top + +Bugs +**** + + Just like any other significant piece of +software, `screen' has a few bugs and missing features. Please send in +a bug report if you have found a bug not mentioned here. + + * Menu: + + * Known Bugs:: Problems we know about. + * Reporting Bugs:: How to contact the maintainers. + * Availability:: Where to find the lastest screen version. + + +File: screen.info, Node: Known Bugs, Next: Reporting Bugs, Up: Bugs + +Known Bugs +========== + + * `dm' (delete mode) and `xs' are not handled + correctly (they are ignored). `xn' is treated + as a magic-margin indicator. + + * `screen' has no clue about double-high or + double-wide characters. But this is the only + area where `vttest' is allowed to fail. + + * It is not possible to change the environment + variable `$TERMCAP' when reattaching under a + different terminal type. + + * The support of terminfo based systems is very + limited. Adding extra capabilities to + `$TERMCAP' may not have any effects. + + * `screen' does not make use of hardware tabs. + + * `screen' must be installed setuid root in + order to be able to correctly change the owner + of the tty device file for each window. + Special permission may also be required to + write the file `/etc/utmp'. + + * Entries in `/etc/utmp' are not removed when + `screen' is killed with SIGKILL. This will + cause some programs (like "w" or "rwho") to + advertise that a user is logged on who really + isn't. + + * `screen' may give a strange warning when your + tty has no utmp entry. + + * When the modem line was hung up, `screen' may + not automatically detach (or quit) unless the + device driver sends a HANGUP signal. To detach + such a `screen' session use the -D or -d + command line option. + + * If a password is set, the command line options + -d and -D still detach a session without + asking. + + * Read permission on windows is never checked + for. All users that can attach to the session + can read window contents. + + * Both `breaktype' and `defbreaktype' change the + break generating method used by all terminal + devices. The first should change a window + specific setting, where the latter should + change only the default for new windows. + + * When attaching to a multiuser session, the + user's `.screenrc' file is not sourced. Each + users personal settings have to be included in + the `.screenrc' file from which the session is + booted, or have to be changed manually. + + * A weird imagination is most useful to gain + full advantage of all the features. + + +File: screen.info, Node: Reporting Bugs, Next: Availability, Prev: Known Bugs, Up: Bugs + +Reporting Bugs +============== + + If you find a bug in `Screen', please send +electronic mail to `screen@uni-erlangen.de', and also to +`bug-gnu-utils@prep.ai.mit.edu'. Include the version number of +`Screen' which you are using. Also include in your message the +hardware and operating system, the compiler used to compile, a +description of the bug behavior, and the conditions that triggered the +bug. Please recompile `screen' with the `-DDEBUG -DTMPTEST' options +enabled, reproduce the bug, and have a look at the debug output written +to the directory `/tmp/debug'. If necessary quote suspect passages from +the debug output and show the contents of your `config.h' if it matters. + + +File: screen.info, Node: Availability, Prev: Reporting Bugs, Up: Bugs + +Availability +============ + + `Screen' is available under the `GNU' copyleft. + + The latest official release of `screen' +available via anonymous ftp from `prep.ai.mit.edu', `nic.funet.fi' or +any other `GNU' distribution site. The home site of `screen' is +`ftp.uni-erlangen.de (131.188.1.43)', in the directory +`pub/utilities/screen'. The subdirectory `private' contains the latest +beta testing release. If you want to help, send a note to +screen@uni-erlangen.de. + + +File: screen.info, Node: Installation, Next: Concept Index, Prev: Bugs, Up: Top + +Installation +************ + + Since `screen' uses pseudo-ttys, the select +system call, and UNIX-domain sockets/named pipes, it will not run under +a system that does not include these features of 4.2 and 4.3 BSD UNIX. + + * Menu: + + * Socket Directory:: Where screen stores its handle. + * Compiling Screen:: + + +File: screen.info, Node: Socket Directory, Next: Compiling Screen, Up: Installation + +Socket Directory +================ + + The socket directory defaults either to +`$HOME/.screen' or simply to `/tmp/screens' or preferably to +`/usr/local/screens' chosen at compile-time. If `screen' is installed +setuid root, then the administrator should compile screen with an +adequate (not NFS mounted) `SOCKDIR'. If `screen' is not running +setuid-root, the user can specify any mode 700 directory in the +environment variable `$SCREENDIR'. + + +File: screen.info, Node: Compiling Screen, Prev: Socket Directory, Up: Installation + +Compiling Screen +================ + + To compile and install screen: + + The `screen' package comes with a `GNU Autoconf' +configuration script. Before you compile the package run + + `sh ./configure' + + This will create a `config.h' and `Makefile' for +your machine. If `configure' fails for some reason, then look at the +examples and comments found in the `Makefile.in' and `config.h.in' +templates. Rename `config.status' to `config.status.MACHINE' when you +want to keep configuration data for multiple architectures. Running `sh +./config.status.MACHINE' recreates your configuration significantly +faster than rerunning `configure'. + Read through the "User Configuration" section of +`config.h', and verify that it suits your needs. A comment near the +top of this section explains why it's best to install screen setuid to +root. Check for the place for the global `screenrc'-file and for the +socket directory. + Check the compiler used in `Makefile', the prefix +path where to install `screen'. Then run + + `make' + + If `make' fails to produce one of the files +`term.h', `comm.h' or `tty.c', then use `FILENAME.X.dist' instead. For +additional information about installation of `screen' refer to the file +`INSTALLATION', coming with this package. + + +File: screen.info, Node: Concept Index, Next: Command Index, Prev: Installation, Up: Top + +Concept Index +************* + + * Menu: + + * .screenrc: Startup Files. + * availability: Availability. + * binding: Key Binding. + * bug report: Reporting Bugs. + * bugs: Bugs. + * capabilities: Special Capabilities. + * Command Character: Command Character. + * command line options: Invoking Screen. + * command summary: Command Summary. + * compiling screen: Compiling Screen. + * control sequences: Control Sequences. + * copy and paste: Copy and Paste. + * customization: Customization. + * environment: Environment. + * Escape Character: Command Character. + * files: Files. + * flow control: Flow Control. + * input translation: Input Translation. + * installation: Installation. + * introduction: Getting Started. + * invoking: Invoking Screen. + * key binding: Key Binding. + * marking: Copy. + * message line: Message Line. + * multiuser session: Multiuser Session. + * options: Invoking Screen. + * overview: Overview. + * regions: Regions. + * screenrc: Startup Files. + * scrollback: Copy. + * socket directory: Socket Directory. + * terminal capabilities: Special Capabilities. + * title: Naming Windows. + + +File: screen.info, Node: Command Index, Next: Keystroke Index, Prev: Concept Index, Up: Top + +Command Index +************* + + This is a list of all the commands supported by +`screen'. + + * Menu: + + * acladd: Acladd. + * aclchg: Aclchg. + * acldel: Acldel. + * aclgrp: Aclgrp. + * aclumask: Umask. + * activity: Monitor. + * addacl: Acladd. + * allpartial: Redisplay. + * at: At. + * autodetach: Detach. + * autonuke: Autonuke. + * bell_msg: Bell. + * bind: Bind. + * bindkey: Bindkey. + * break: Break. + * breaktype: Break. + * bufferfile: Screen-Exchange. + * c1: Character Processing. + * chacl: Aclchg. + * charset: Character Processing. + * chdir: Chdir. + * clear: Clear. + * colon: Colon. + * command: Command Character. + * console: Console. + * copy: Copy. + * copy_reg: Registers. + * crlf: Line Termination. + * debug: Debug. + * defautonuke: Autonuke. + * defbreaktype: Break. + * defc1: Character Processing. + * defcharset: Character Processing. + * defescape: Command Character. + * defflow: Flow. + * defgr: Character Processing. + * defhstatus: Hardstatus. + * defkanji: Character Processing. + * deflogin: Login. + * defmode: Mode. + * defmonitor: Monitor. + * defobuflimit: Obuflimit. + * defscrollback: Scrollback. + * defshell: Shell. + * defsilence: Silence. + * defslowpaste: Paste. + * defwrap: Wrap. + * defwritelock: Writelock. + * defzombie: Zombie. + * detach: Detach. + * digraph: Digraph. + * displays: Displays. + * dumptermcap: Dump Termcap. + * echo: echo. + * escape: Command Character. + * exec: Exec. + * flow: Flow. + * focus: Focus. + * gr: Character Processing. + * hardcopy: Hardcopy. + * hardcopydir: Hardcopy. + * hardcopy_append: Hardcopy. + * hardstatus: Hardware Status Line. + * height: Window Size. + * help: Help. + * history: History. + * info: Info. + * ins_reg: Registers. + * kanji: Character Processing. + * kill: Kill. + * lastmsg: Last Message. + * license: License. + * lockscreen: Lock. + * log: Log. + * logfile: Log. + * login: Login. + * mapdefault: Bindkey Control. + * mapnotnext: Bindkey Control. + * maptimeout: Bindkey Control. + * markkeys: Copy Mode Keys. + * meta: Command Character. + * monitor: Monitor. + * msgminwait: Message Wait. + * msgwait: Message Wait. + * multiuser: Multiuser. + * nethack: Nethack. + * next: Next and Previous. + * nonblock: Nonblock. + * number: Number. + * obuflimit: Obuflimit. + * one: One. + * other: Other Window. + * partial: Redisplay. + * password: Detach. + * paste: Paste. + * pastefont: Paste. + * pow_break: Break. + * pow_detach: Power Detach. + * pow_detach_msg: Power Detach. + * preselect: Select. + * prev: Next and Previous. + * printcmd: Printcmd. + * process: Registers. + * quit: Quit. + * readbuf: Screen-Exchange. + * readreg: Paste. + * redisplay: Redisplay. + * register: Registers. + * remove: Remove. + * removebuf: Screen-Exchange. + * reset: Reset. + * screen: Screen Command. + * scrollback: Scrollback. + * select: Select. + * sessionname: Session Name. + * setenv: Setenv. + * shell: Shell. + * shelltitle: Shell. + * silence: Silence. + * silencewait: Silence. + * sleep: sleep. + * slowpaste: Paste. + * sorendition: Sorendition. + * split: Split. + * startup_message: Startup Message. + * stuff: Registers. + * su: Su. + * suspend: Suspend. + * term: Term. + * termcap: Termcap Syntax. + * termcapinfo: Termcap Syntax. + * terminfo: Termcap Syntax. + * time: Time. + * title: Title Command. + * umask: Umask. + * unsetenv: Setenv. + * vbell: Bell. + * vbellwait: Bell. + * vbell_msg: Bell. + * verbose: Verbose. + * version: Version. + * wall: Wall. + * width: Window Size. + * windows: Windows. + * wrap: Wrap. + * writebuf: Screen-Exchange. + * writelock: Writelock. + * xoff: XON/XOFF. + * xon: XON/XOFF. + * zombie: Zombie. + + +File: screen.info, Node: Keystroke Index, Prev: Command Index, Up: Top + +Keystroke Index +*************** + + This is a list of the default key bindings. + + The leading escape character (*note Command +Character::.) has been omitted from the key sequences, since it is the +same for all bindings. + + * Menu: + + * ": Select. + * ': Select. + * *: Displays. + * .: Dump Termcap. + * 0...9: Select. + * :: Colon. + * <: Screen-Exchange. + * =: Screen-Exchange. + * >: Screen-Exchange. + * ?: Help. + * {: History. + * A: Title Command. + * a: Command Character. + * C: Clear. + * c: Screen Command. + * C-a: Other Window. + * C-c: Screen Command. + * C-d: Detach. + * C-f: Flow. + * C-g: Bell. + * C-h: Hardcopy. + * C-i: Info. + * C-k: Kill. + * C-l: Redisplay. + * C-m: Last Message. + * C-n: Next and Previous. + * C-p: Next and Previous. + * C-q: XON/XOFF. + * C-r: Wrap. + * C-s: XON/XOFF. + * C-t: Time. + * C-v: Digraph. + * C-w: Windows. + * C-x: Lock. + * C-z: Suspend. + * C-[: Copy. + * C-\: Quit. + * C-]: Paste. + * d: Detach. + * D: Power Detach. + * ESC: Copy. + * F: Focus. + * f: Flow. + * h: Hardcopy. + * H: Log. + * i: Info. + * k: Kill. + * L: Login. + * l: Redisplay. + * M: Monitor. + * m: Last Message. + * n: Next and Previous. + * N: Number. + * p: Next and Previous. + * q: XON/XOFF. + * Q: One. + * r: Wrap. + * s: XON/XOFF. + * S: Split. + * SPC: Next and Previous. + * t: Time. + * v: Version. + * W: Window Size. + * w: Windows. + * x: Lock. + * X: Remove. + * z: Suspend. + * Z: Reset. + * [: Copy. + * ]: Paste. + + |