home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / SRC / screen.src.lzh / SCREEN_LIB / readme < prev    next >
Text File  |  1991-06-27  |  5KB  |  108 lines
  1. "screen" is a window manager that allows you to handle several independent
  2. screens (UNIX ttys) on a single physical terminal; each screen has its own
  3. set of processes connected to it (typically interactive shells).  Each
  4. virtual terminal created by "screen" emulates a DEC VT100 plus several ANSI
  5. X3.64 functions (including DEC VT102 features such as line and character
  6. deletion and insertion).
  7.  
  8. Since "screen" uses pseudo-ttys, the select system call, and UNIX-domain
  9. sockets, it will not run under a system that does not include these
  10. features of 4.2 and 4.3 BSD UNIX.
  11.  
  12. [ It's also available for OS-9/68000 with the PTYs from reccoware
  13.   systems. Instead of the socket a named pipe is used. The select system
  14.   call is emulated with _gs_rdy() and _ss_signl() calls.  /// weo]
  15.  
  16. If you want to get a quick idea how "screen" works but don't want to read
  17. the entire manual, do the following:
  18.  
  19.      -  call "screen" without arguments
  20.      -  wait for the shell prompt; execute some commands
  21.      -  type ^A ^C (Control-A followed by Control-C)
  22.      -  wait for the shell prompt; do something in the new window
  23.      -  type ^A ^A repeatedly to switch between the two windows
  24.      -  terminate the first shell ("screen" switches to the other window)
  25.      -  terminate the second shell
  26.  
  27. If you have got "vttest" (the VT100 test program from mod.sources) you
  28. may want to run it from within "screen" to verify that it correctly
  29. emulates a VT100 on your terminal (except for 132 column mode and
  30. double width/height characters, of course).
  31.  
  32. By the way, "screen" can be used to compensate for certain bugs of "real"
  33. VT100 terminals.  For instance, our 4.2 BSD version of mille(6) garbles
  34. the display on terminals of the VT100 family, but it works quite fine
  35. when it is invoked from within "screen".  In addition, "screen" enables
  36. you to use EMACS on terminals that are unable to generate Control-S and
  37. Control-Q from the keyboard or that require flow control using Control-S
  38. and Control-Q.  This is the reason why I have an alias like
  39.      alias emacs "screen emacs"
  40. in my .cshrc file.
  41.  
  42.  
  43. I have published a beta-test release of screen in the non-moderated
  44. sources newsgroup four months ago.  Since then I have received numerous
  45. suggestions for enhancements and improvements, many of which I have
  46. included in this release of "screen".  One person reported that screen
  47. does not work correctly on the Ann Arbor Guru-XL; I have not been able
  48. to track the problem down without having more detailed information than
  49. just the termcap entry.
  50.  
  51. Major changes between this and the beta-test release are:
  52.  
  53.     -  "screen" now creates an entry in /etc/utmp for each virtual
  54.        terminal
  55.  
  56.        [ Not supported in OSK version /// weo]
  57.  
  58.     -  the owner of the tty file for a virtual terminal is set properly
  59.        (provided that "screen" is set-uid with owner root)
  60.     -  the -c option has been eliminated; you can now start a command
  61.        in a new window with "screen [cmd [args]]"
  62.     -  a (user-settable) notification can be displayed in the current
  63.        window's message line when the bell is rung in a background window
  64.     -  a "chdir" command can be placed into ".screenrc" to facilitate
  65.        creation of windows in specific directories
  66.     -  flow control can be disabled by means of a command line option or
  67.        a special termcap symbol (necessary for EMACS)
  68.     -  "C-a s" and "C-a q" can be used to send a Control-S or a Control-Q,
  69.        respectively (for certain terminals)
  70.     -  it is no longer necessary to specify the full pathname when a
  71.        command is started in a new window (and with the "bind" command)
  72.     -  "C-a ." can be used to write the current termcap entry to a file
  73.        (useful for "rlogin" which does not propagate TERMCAP)
  74.     -  "C-a C-t" displays status information (e.g. the load average and
  75.        the virtual terminal's parameters) in the message line
  76.  
  77.        [ Load average not displayed in OSK version.  /// weo]
  78.  
  79.     -  "C-a C-\" closes all windows and terminates screen
  80.  
  81. Before typing "make", you should have a look into the Makefile.
  82. If your system maintains a 4.3-BSD-style load average, add -DLOADAV to
  83. the compiler options.  In addition, you must set -DGETTTYENT if your
  84. system has the new format /etc/ttys and the getttyent(3) routines.
  85.  
  86. "screen" should be granted read and write access to /etc/utmp and, if
  87. -DLOADAV has been specified, read access to /vmunix and /dev/kmem.
  88. "screen" should be installed with set-uid and owner root to enable it
  89. to correctly change the owner of newly allocated virtual terminals.
  90. Failing to do this (e.g. if you fear a trojan horse) doesn't have any
  91. major disadvantages, except that w(1) and some other utilities may have
  92. some problems with the tty files of your virtual terminals.
  93.  
  94.  
  95. Have fun,
  96.     Oliver Laumann
  97.     Technical University of Berlin,
  98.     Communications and Operating Systems Research Group.
  99.  
  100.     net@tub.BITNET     US: pyramid!tub!net     Europe: unido!tub!net
  101.  
  102.  
  103. OSK Version by reccoware systems, Wolfgang Ocker, Puchheim, 1988
  104.                Lochhauserstrasse 35a
  105.                D-8039 Puchheim
  106.  
  107.     weo@recco  weo%recco@tmpmbx  weo@altger
  108.