[unix-history] / usr / othersrc / public / screen-3.2 / screen3.2 / README


Short introduction to screen (Version 3.0.7)                  jw 7.9.91

screen 
  provides you with an ansi/vt100 terminal emulator, which can multiplex
  up to 10 pseudo-terminals. On startup, it executes $SHELL in window 0.
  Then it reads $HOME/.screenrc to learn configuration, keybindings, 
  and may open more windows.

  C-A C		Create new windows.

  C-A SPACE	Advance from window to window (with wraparound)

  C-A C-A	Toggle between two windows.

  C-A 0
   ...
  C-A 9		Switch to window nr. 0 ... 9.

  C-A w		Show a list of windows in the Statusline.

  C-A a		(Think of goto-start-of-line in emacs or tcsh).
  C-A s		(Think of i-search in emacs).
  C-A q		Send a literal C-A/C-S/C-Q to the process in the window.

  C-A l		Redraw this window.

  C-A W		Toggle between 80 & 132 columns mode. 

  C-A L		Try to toggle the utmp-slot for this window.

  C-A A		Prompt for a new name for this window. (see C-A w).

  C-A z		Suspend the whole screen.

  C-A x		Execute /usr/bin/lock or $LOCKCMD or a builtin terminallock.

  C-A C-[	Start copy&paste mode. Move cursor with h,j,k,l. Set 2 marks
		with SPACE or y. Abort with ESC. Note that "C-[" is ESC.
		NOTE: there is a userdefined amount of scrollback history.
                The history buffer is entered, when the cursor hits the top
		of the window.

  C-A C-]	paste in current window's stdin. see C-A C-[.

  C-A <
  C-A >		Read or write the copybuffer from/to the exchange file.
		Multiple screen users on the same host may thus transfer text.

  C-A d		Detach screen. All processes continue and may spool output
		to their pty's, but screen disconnects from your terminal.
		reattach with "screen -r".

  C-A D D	Power detach. Disconnect like C-A d and kill the parent shell.

  C-A K		Kill a window and send SIGHUP to its processgroup. Per default
		this would be C-A C-k. But it is redefined in the demo .screenrc
		(think of killing a whole line in emacs).

  C-A :set all  Show all keybindings. The above list is not at all complete and
		may even be wrong, as keys can be redefined in .screenrc or
		with "C-A :bind 'X' keyname [arguments]".

  C-A : ....  Online configuration change.


screen -r [host.tty]
  Reattach a detached screen session. The terminal emulator reconfigures
  according to your $TERMCAP or $TERM settings. '-R' brings up a detached
  session or (if none) creates a new session. You should specify a socket
  when there you have multiple screens detached. 

screen -d [host.tty]
  Detach a screen session from remote. Has the same effect as typing 'C-A d'
  on the controlling terminal. '-D' will power-detach.

screen -list
screen -ls
  Show all available sockets. If there are (DEAD???) sockets, you may consider 
  removing them. If there are sockets missing, you may send a SIGCHLD to its
  process 'SCREEN' and the process will re-establish the socket. (think of 
  someone cleaning /tmp thoroughly).

screen -h 200
  Starts a new screen session and sets the number of lines in the scrollback
  buffer to 200. The default is 50 lines.
Commit	Line	Data
e1009ea2 WJ	1
	2	Short introduction to screen (Version 3.0.7) jw 7.9.91
	3
	4	screen
	5	provides you with an ansi/vt100 terminal emulator, which can multiplex
	6	up to 10 pseudo-terminals. On startup, it executes $SHELL in window 0.
	7	Then it reads $HOME/.screenrc to learn configuration, keybindings,
	8	and may open more windows.
	9
	10	C-A C Create new windows.
	11
	12	C-A SPACE Advance from window to window (with wraparound)
	13
	14	C-A C-A Toggle between two windows.
	15
	16	C-A 0
	17	...
	18	C-A 9 Switch to window nr. 0 ... 9.
	19
	20	C-A w Show a list of windows in the Statusline.
	21
	22	C-A a (Think of goto-start-of-line in emacs or tcsh).
	23	C-A s (Think of i-search in emacs).
	24	C-A q Send a literal C-A/C-S/C-Q to the process in the window.
	25
	26	C-A l Redraw this window.
	27
	28	C-A W Toggle between 80 & 132 columns mode.
	29
	30	C-A L Try to toggle the utmp-slot for this window.
	31
	32	C-A A Prompt for a new name for this window. (see C-A w).
	33
	34	C-A z Suspend the whole screen.
	35
	36	C-A x Execute /usr/bin/lock or $LOCKCMD or a builtin terminallock.
	37
	38	C-A C-[ Start copy&paste mode. Move cursor with h,j,k,l. Set 2 marks
	39	with SPACE or y. Abort with ESC. Note that "C-[" is ESC.
	40	NOTE: there is a userdefined amount of scrollback history.
	41	The history buffer is entered, when the cursor hits the top
	42	of the window.
	43
	44	C-A C-] paste in current window's stdin. see C-A C-[.
	45
	46	C-A <
	47	C-A > Read or write the copybuffer from/to the exchange file.
	48	Multiple screen users on the same host may thus transfer text.
	49
	50	C-A d Detach screen. All processes continue and may spool output
	51	to their pty's, but screen disconnects from your terminal.
	52	reattach with "screen -r".
	53
	54	C-A D D Power detach. Disconnect like C-A d and kill the parent shell.
	55
	56	C-A K Kill a window and send SIGHUP to its processgroup. Per default
	57	this would be C-A C-k. But it is redefined in the demo .screenrc
	58	(think of killing a whole line in emacs).
	59
	60	C-A :set all Show all keybindings. The above list is not at all complete and
	61	may even be wrong, as keys can be redefined in .screenrc or
	62	with "C-A :bind 'X' keyname [arguments]".
	63
	64	C-A : .... Online configuration change.
65
66
67	screen -r [host.tty]
68	Reattach a detached screen session. The terminal emulator reconfigures
69	according to your $TERMCAP or $TERM settings. '-R' brings up a detached
70	session or (if none) creates a new session. You should specify a socket
71	when there you have multiple screens detached.
72
73	screen -d [host.tty]
74	Detach a screen session from remote. Has the same effect as typing 'C-A d'
75	on the controlling terminal. '-D' will power-detach.
76
77	screen -list
78	screen -ls
79	Show all available sockets. If there are (DEAD???) sockets, you may consider
80	removing them. If there are sockets missing, you may send a SIGCHLD to its
81	process 'SCREEN' and the process will re-establish the socket. (think of
82	someone cleaning /tmp thoroughly).
83
84	screen -h 200
85	Starts a new screen session and sets the number of lines in the scrollback
86	buffer to 200. The default is 50 lines.