NAME¶
retty - Attach process running on another terminal
SYNOPSIS¶
retty [-v] [-h] [-0 fd] [-1 fd] [-2 fd] PID
DESCRIPTION¶
retty is a simple tool which will let you attach process currently
running on another terminal. Unlike screen, you need to make no special
provisions in advance - just get the process' pid and attach it anytime.
Non-violently killing
retty should provide for a proper detach - after
that, the process can be used on the original terminal again (multiple
subsequent
retty attachments of a single process are possible, but the
process does I/O only on the last one).
You can also use escape sequences to detach a process and possibly do other
things. The escape character is "`" (lowercase of "~") and
"`h" will give you list of possible escape sequences. The escape
character must be immediately preceded by an enter.
By default,
retty attaches file descriptors 0, 1 and 2 of process. That
should be enough in most cases, but will not do in some special ones. In such
case, you have to check /proc/<PID>/fd and force
retty to attach
correct file descriptors instead.
OPTIONS¶
- -v
- Display version information.
- -h
- Display usage information.
- -0 fd
- Specify file descriptor that process we want to attach uses as input.
Default value is 0 (stdin).
- -1 fd
- Specify file descriptor that process we want to attach uses as output.
Default value is 1 (stdout).
- -2 fd
- Specify file descriptor that process we want to attach uses for error
outputs. Default value is 2 (stderr).
- PID
- PID of process that we want to attach. If retty is run as ordinary user,
it can attach only processes owned by that user. If run as root, retty can
attach probably anything (not always good idea).
BUGS¶
- •
- retty is x86-specific and works only on Linux.
- •
- The attached process' controlling terminal is not switched appropriately,
which causes many funny effects (e.g. mutt not properly adjusting
for your window size, but this can be fixed by going into editor and
back), annoying bugs (ctrl+c not delivered properly) and totally breaking
attaching for some applications (OpenSSH).
- •
- If you attach bash it imagines EOF on stdin. Attaching and
detaching multiple times without any activity in the meantime will cause
it to die.
- •
- Attempts to attach less just don't work even with input fd
override. This might or might not be fixed in the future, depending on
cause (which is unknown now).
SEE ALSO¶
screen(1)