git event
[wiki.git] / doc / screen.mdwn
1 [[!meta title="Using Screen"]]
2
3 ## Why?
4
5 `screen` is a handy tool.  It lets you get more out of a terminal
6 session, whether in a window, via ssh, or by some more esoteric means.
7 Its original reason for existence was allowing you to switch between
8 subsessions on a [video-display
9 terminal](http://en.wikipedia.org/wiki/Video_terminal), but it grew to
10 allow sessions that could be detached and reattached (if you went home
11 for the day, or say you were connecting via a glitchy network) and
12 eventually to allow the same session to be simultaneously accessed
13 from multiple places.
14
15 ## Getting Started
16
17  1.  Pick a machine to run your screen session on.  If you don't know of any options, linux.mit.edu (Linerva) is a good choice.
18  2.  ssh to that machine.
19  3.  run `screen`
20  4.  Do stuff.
21
22 To detach, type "C-a d".  To reattach, type `screen -dr`.
23
24 If you close your ssh connection without detaching, or lose your
25 network connection:
26
27  1.  run `screen -dr`
28  2.  Do stuff.
29
30 The `-dr` means "find my screen session, detach it from wherever it's
31 attached if it's attached, and reattach it here."
32
33 Once you're comfortable with this, hit "C-a C-c".  This creates what
34 screen calls a new "window"; it should give you a new shell prompt,
35 and you can do stuff at it.  If you want to switch back to the old
36 "window", hit "C-a C-a".  You can create as many "windows" as you
37 want; you can switch to the first 10 of them with "C-a 0" through "C-a
38 9" and see a list of what's open with "C-a w".  ("C-a C-a" actually
39 means "switch to the previously used window".)
40
41 A useful shorthand: `screen -dR` is like `screen -dr` except
42 it adds a "if I don't already have a session, create one" step.
43
44 You can use `screen -x` to attach a screen session that's already
45 attached somewhere without detaching it first.  This can have side
46 effects if the other place is already attached or is in a window that
47 is a different size than your current one.  It's useful when you want
48 to share context between different screens, or even different people,
49 but doing it when you're not sure where else your screen might be
50 attached has privacy implications.
51
52 ## For More Information
53
54 `screen` can do lots of stuff.  If you have a while to burn, run
55 `man screen` at the shell prompt.  It may be helpful to do this
56 inside of `screen` so you can put it down and come back to it later.
57
58 ## TODO
59
60 clean up, explain the "C-a C-a" notation.