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.
                    

