diff options
Diffstat (limited to 'rtty.1')
-rw-r--r-- | rtty.1 | 59 |
1 files changed, 33 insertions, 26 deletions
@@ -6,38 +6,40 @@ .Nd limited but responsive remote shell .Sh SYNOPSIS .Nm -.Op Sy +dp +.Op Sy +dpx .Op Ar ... .Sh DESCRIPTION .Pp .Nm is a wrapper around -.Xr ssh 1 -that provides a remote shell as responsive as -.Xr mosh 1 -and as limited as a hard-copy teletypewriter. +.Xr ssh 1 , +providing a line-based remote shell. It is a very useful tool on slow connections. -As +.Pp .Nm -uses the default line-editing capabilities of the terminal, -user input is only sent to the remote server +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. -If the -.Sy +d -flag is provided, -.Nm -disables all heuristics to detect password prompts +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. -If the -.Sy +p -flag is provided, +.It Sy +h +Makes .Nm -manually asks the user for a password +identify as a hard-copy terminal, +preventing visual programs such as +.Xr vi 1 +from running. +.It Sy +p +Manually asks the user for a password before connecting to the server. This requires .Xr sshpass 1 @@ -47,19 +49,24 @@ Without the 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 other arguments +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" . -.Sh CAVEATS -.Pp -.Nm -exits immediately on SIGINT; -it is best used in conjunction with -.Xr dtach 1 -on the remote server. |