aboutsummaryrefslogtreecommitdiff
path: root/rtty.1
blob: 9c03e0f8a87516269ce688126f02db88e4a344c8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
.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" .