aboutsummaryrefslogtreecommitdiff
path: root/rtty.1
diff options
context:
space:
mode:
Diffstat (limited to 'rtty.1')
-rw-r--r--rtty.159
1 files changed, 33 insertions, 26 deletions
diff --git a/rtty.1 b/rtty.1
index d8a01eb..926e977 100644
--- a/rtty.1
+++ b/rtty.1
@@ -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.