X-Git-Url: https://sipb.mit.edu/gitweb.cgi/wiki.git/blobdiff_plain/537314853f3a4cfc77e68bc74eddcd6921bb5a7e..17e41a9c537106c2e00d71836802a936257596e1:/doc/screen.mdwn

diff --git a/doc/screen.mdwn b/doc/screen.mdwn
index 07a28d5..b340fa2 100644
--- a/doc/screen.mdwn
+++ b/doc/screen.mdwn
@@ -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`.