.Dd $Mdocdate$
.Dt RTTY 1
.Os
.Sh NAME
.Nm rtty
.Nd limited but responsive remote shell
.Sh SYNOPSIS
.Nm
.Op Sy +dipx
.Op Ar ...
.Sh DESCRIPTION
.Pp
.Nm
is a wrapper around
.Xr ssh 1 ,
providing a line-based remote shell.
It is a very useful tool on slow connections.
.Pp
.Nm
uses the default line-editing capabilities of the terminal.
User input is only sent to the remote server
once a full line has been input.
As such, input is as responsive as on the local machine.
The session can be killed by sending a QUIT signal (C-/).
.Pp
Flags specific to
.Nm
are prefixed with a plus sign:
.Bl -tag -width xx -offset indent
.It Sy +d
Disables all heuristics to detect password prompts
from the remote server and hide the user's input,
which are enabled by default.
.It Sy +i
Prevents
.Nm
from identifying as a hard-copy terminal (tty43),
allowing visual programs such as
.Xr vi 1
to run.
Sets
.Ev PAGER
to
.Xr ul 1
instead of
.Xr cat 1 .
.It Sy +p
Manually asks the user for a password
before connecting to the server.
This requires
.Xr sshpass 1
to be installed.
Without the
.Sy +p
flag,
.Xr ssh 1
is launched in batch mode.
.It Sy +x
Enables escaped commands beginning with
.Ql \&! ,
like
.Ql "!vi mbox" .
An escaped command runs on the local system,
but operates on a remote file,
which is downloaded and re-uploaded with
.Xr scp 1 .
.El
.Pp
All remaining arguments
are passed to
.Xr ssh 1 .
.Sh SEE ALSO
.Xr dtach 1
.Sh AUTHORS
.Pp
.Nm
is written by John Ankarström
.Aq Mt "john (at) ankarstrom.se" .