retty.1

   1 .TH SCREEN 1 2006-05-22
   2
   3 .SH NAME
   4 retty - Attach process running on another terminal
   5
   6 .SH SYNOPSIS
   7 .B retty pid
   8
   9 .SH DESCRIPTION
  10
  11 .B retty
  12 is a simple tool which will let you attach process currently running on
  13 another terminal. Unlike screen, you need to make no special provisions
  14 in advance - just get the process' pid and attach it anytime.
  15
  16 Non-violently killing retty should provide for a proper detach - after that,
  17 the process can be used on the original terminal again (multiple subsequent
  18 retty attachments of a single process are possible, but the process does I/O
  19 only on the last one).
  20
  21 You can also use escapes to detach a process and possibly do other things.
  22 The escape character is "`" (lowercase of "~") and "`h" will give you list
  23 of possible escape sequences. The escape character must be immediately
  24 preceded by an enter.
  25
  26 .RE
  27 .SH "SEE ALSO"
  28 screen(1)
  29
  30 .RE
  31 .SH BUGS
  32 .PD
  33 .IP \(bu
  34 .I retty
  35 is x86-specific and works only on Linux.
  36 .IP \(bu
  37 The attached process' controlling terminal is not switched appropriately,
  38 which causes many funny effects (e.g.
  39 .I mutt
  40 not properly adjusting for your
  41 window size), annoying bugs (ctrl-c not delivered properly) and totally
  42 breaking attaching for some applications (OpenSSH).
  43 .IP \(bu
  44 If you attach
  45 .I bash
  46 it imagines EOF on stdin. Attaching and detaching multiple times without
  47 any activity in the meantime will cause it to die.