Mercurial > dropbear

comparison dbclient.1 @ 801:7dcb46da72d9 ecc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
merge in HEAD
author Matt Johnston <matt@ucc.asn.au>
date Tue, 21 May 2013 12:09:35 +0800
parents 0e5ea6812bb7
children f8b28a3de6cb
comparison
equal deleted inserted replaced
799:c344607b7341 801:7dcb46da72d9
13 .RI [ command ] 13 .RI [ command ]
14 14
15 .B dbclient 15 .B dbclient
16 [ 16 [
17 .I args ] 17 .I args ]
18 .I [user1]@host1[/port1],[user2]@host2[/port2],... 18 .I [user1]@host1[%port1],[user2]@host2[%port2],...
19 19
20 .SH DESCRIPTION 20 .SH DESCRIPTION
21 .B dbclient 21 .B dbclient
22 is a SSH 2 client designed to be small enough to be used in small memory 22 is a SSH 2 client designed to be small enough to be used in small memory
23 environments, while still being functional and secure enough for general use. 23 environments, while still being functional and secure enough for general use.
24 .SH OPTIONS 24 .SH OPTIONS
25 .TP 25 .TP
26 .B \-p \fIport 26 .B \-p \fIport
27 Remote port. 27 Connect to
28 Connect to port
29 .I port 28 .I port
30 on the remote host. 29 on the remote host. Alternatively a port can be specified as hostname%port.
31 Default is 22. 30 Default is 22.
32 .TP 31 .TP
33 .B \-i \fIidfile 32 .B \-i \fIidfile
34 Identity file. 33 Identity file.
35 Read the identity from file 34 Read the identity from file
59 Login as 58 Login as
60 .I user 59 .I user
61 on the remote host. 60 on the remote host.
62 .TP 61 .TP
63 .B \-t 62 .B \-t
64 Allocate a pty. 63 Allocate a PTY.
65 .TP 64 .TP
66 .B \-T 65 .B \-T
67 Don't allocate a pty. 66 Don't allocate a PTY.
68 .TP 67 .TP
69 .B \-N 68 .B \-N
70 Don't request a remote shell or run any commands. Any command arguments are ignored. 69 Don't request a remote shell or run any commands. Any command arguments are ignored.
71 .TP 70 .TP
72 .B \-f 71 .B \-f
78 forwarded ports, though remote connections to -R forwarded ports may be limited 77 forwarded ports, though remote connections to -R forwarded ports may be limited
79 by the ssh server. 78 by the ssh server.
80 .TP 79 .TP
81 .B \-y 80 .B \-y
82 Always accept hostkeys if they are unknown. If a hostkey mismatch occurs the 81 Always accept hostkeys if they are unknown. If a hostkey mismatch occurs the
83 connection will abort as normal. 82 connection will abort as normal. If specified a second time no host key checking
83 is performed at all, this is usually undesirable.
84 .TP 84 .TP
85 .B \-A 85 .B \-A
86 Forward agent connections to the remote host. dbclient will use any 86 Forward agent connections to the remote host. dbclient will use any
87 OpenSSH-style agent program if available ($SSH_AUTH_SOCK will be set) for 87 OpenSSH-style agent program if available ($SSH_AUTH_SOCK will be set) for
88 public key authentication. Forwarding is only enabled if -A is specified. 88 public key authentication. Forwarding is only enabled if -A is specified.
124 .SH MULTI-HOP 124 .SH MULTI-HOP
125 Dropbear will also allow multiple "hops" to be specified, separated by commas. In 125 Dropbear will also allow multiple "hops" to be specified, separated by commas. In
126 this case a connection will be made to the first host, then a TCP forwarded 126 this case a connection will be made to the first host, then a TCP forwarded
127 connection will be made through that to the second host, and so on. Hosts other than 127 connection will be made through that to the second host, and so on. Hosts other than
128 the final destination will not see anything other than the encrypted SSH stream. 128 the final destination will not see anything other than the encrypted SSH stream.
129 A port for a host can be specified with a slash (eg matt@martello/44 ). 129 A port for a host can be specified with a hash (eg matt@martello%44 ).
130 This syntax can also be used with scp or rsync (specifying dbclient as the 130 This syntax can also be used with scp or rsync (specifying dbclient as the
131 ssh/rsh command). A file can be "bounced" through multiple SSH hops, eg 131 ssh/rsh command). A file can be "bounced" through multiple SSH hops, eg
132 132
133 scp -S dbclient matt@martello,root@wrt,canyons:/tmp/dump . 133 scp -S dbclient matt@martello,root@wrt,canyons:/tmp/dump .
134 134
135 Note that hostnames are resolved by the prior hop (so "canyons" would be resolved by the host "wrt") 135 Note that hostnames are resolved by the prior hop (so "canyons" would be resolved by the host "wrt")
136 in the example above, the same way as other -L TCP forwarded hosts are. Host keys are 136 in the example above, the same way as other -L TCP forwarded hosts are. Host keys are
137 checked locally based on the given hostname. 137 checked locally based on the given hostname.
138
139 .SH ESCAPE CHARACTERS
140 Typing a newline followed by the key sequence \fI~.\fR (tilde, dot) will terminate a connection.
141 The sequence \fI~^Z\fR (tilde, ctrl-z) will background the connection. This behaviour only
142 applies when a PTY is used.
138 143
139 .SH ENVIRONMENT 144 .SH ENVIRONMENT
140 .TP 145 .TP
141 .B DROPBEAR_PASSWORD 146 .B DROPBEAR_PASSWORD
142 A password to use for remote authentication can be specified in the environment 147 A password to use for remote authentication can be specified in the environment