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 and you're just starting out, you can ssh into athena.dialup.mit.edu (Athena Dialup). This will pick a machine by round-robin; you should be greeted by a prompt that says something like yourkerberos@foobarbaz.mit.edu. foobarbaz.mit.edu will be the machine that you'll host your session on.
  18  2.  ssh to the machine you chose in step 1. Remember it for future reference. If you want a shorter name for foobarbaz.mit.edu you can type `stella foobarbaz` at an Athena prompt; one or several shorter aliases should be listed, such as, hypothetically, `fbb`. On the MIT network, you don't even have to type `.mit.edu`, so you can just `ssh yourkerberos@fbb`.
  19  3.  run `screen`
  20  4.  Do stuff.
  21
  22 To detach, type "C-a d" (That's control+a, release both keys, press '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 Some people (including the author of this sentence) use `tmux` instead of
  59 `screen`; it can do all of the same things `screen` can, and may be easier to
  60 customize.
  61
  62 Also, instead of normal `ssh`, you can use `mosh` (the mobile shell) to connect
  63 to the Athena machine; it will be able to reconnect automatically if you lose
  64 your Internet connection momentarily. An example alias:
  65
  66     alias athmosh='mosh --server="athrun mosh_project mosh-server" --ssh="ssh -K"'
  67
  68 `ssh -K` will pass along Kerberos tickets from your own machine, so if you
  69 first run `kinit yourkerberos@ATHENA.MIT.EDU` and type your password on your
  70 computer, you won't need to re-authenticate when running this command. You can
  71 invoke this as `athmosh yourkerberos@fbb`.