Change yczeng to sipb-vice-chair
[wiki.git] / doc / screen.mdwn
index 07a28d51138f8a812db14601be1825a1409aac95..9ff6fcd591e82920ae1889bf35918bfd6fdf75f4 100644 (file)
@@ -6,7 +6,7 @@
 session, whether in a window, via ssh, or by some more esoteric means.
 Its original reason for existence was allowing you to switch between
 subsessions on a [video-display
-terminal](http://en.wikipedia.org/wiki/Video_terminal), but it grew to
+terminal](https://en.wikipedia.org/wiki/Video_terminal), but it grew to
 allow sessions that could be detached and reattached (if you went home
 for the day, or say you were connecting via a glitchy network) and
 eventually to allow the same session to be simultaneously accessed
@@ -14,12 +14,12 @@ from multiple places.
 
 ## Getting Started
 
- 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.
- 2.  ssh to that machine.
+ 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.
+ 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`.
  3.  run `screen`
  4.  Do stuff.
 
-To detach, type "C-a d".  To reattach, type `screen -dr`.
+To detach, type "C-a d" (That's control+a, release both keys, press 'd'.) .  To reattach, type `screen -dr`.
 
 If you close your ssh connection without detaching, or lose your
 network connection:
@@ -55,6 +55,17 @@ attached has privacy implications.
 `man screen` at the shell prompt.  It may be helpful to do this
 inside of `screen` so you can put it down and come back to it later.
 
-## TODO
+Some people (including the author of this sentence) use `tmux` instead of
+`screen`; it can do all of the same things `screen` can, and may be easier to
+customize.
 
-clean up, explain the "C-a C-a" notation.
\ No newline at end of file
+Also, instead of normal `ssh`, you can use `mosh` (the mobile shell) to connect
+to the Athena machine; it will be able to reconnect automatically if you lose
+your Internet connection momentarily. An example alias:
+
+    alias athmosh='mosh --server="athrun mosh_project mosh-server" --ssh="ssh -K"'
+
+`ssh -K` will pass along Kerberos tickets from your own machine, so if you
+first run `kinit yourkerberos@ATHENA.MIT.EDU` and type your password on your
+computer, you won't need to re-authenticate when running this command. You can
+invoke this as `athmosh yourkerberos@fbb`.