Mercurial > dropbear

comparison dbclient.1 @ 546:568638be7203 agent-client

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
propagate from branch 'au.asn.ucc.matt.dropbear' (head 899a8851a5edf840b2f7925bcc26ffe99dcac54d) to branch 'au.asn.ucc.matt.dropbear.cli-agent' (head 6bbab8364de17bd9ecb1dee5ffb796e48c0380d2)
author Matt Johnston <matt@ucc.asn.au>
date Wed, 01 Jul 2009 04:16:32 +0000
parents 7fc4ba3c1cbb
children 52d7301e46bd
comparison
equal deleted inserted replaced
500:d588e3ea557a 546:568638be7203
8 .I id\fR] [\-L 8 .I id\fR] [\-L
9 .I l\fR:\fIh\fR:\fIr\fR] [\-R 9 .I l\fR:\fIh\fR:\fIr\fR] [\-R
10 .I l\fR:\fIh\fR:\fIr\fR] [\-l 10 .I l\fR:\fIh\fR:\fIr\fR] [\-l
11 .IR user ] 11 .IR user ]
12 .I host 12 .I host
13 .RI [ command ]
14
15 .B dbclient
16 [
17 .I args ]
18 .I [user1]@host1[/port1],[user2]@host2[/port2],...
19
13 .SH DESCRIPTION 20 .SH DESCRIPTION
14 .B dbclient 21 .B dbclient
15 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
16 environments, while still being functional and secure enough for general use. 23 environments, while still being functional and secure enough for general use.
17 .SH OPTIONS 24 .SH OPTIONS
84 Ensure that traffic is transmitted at a certain interval in seconds. This is 91 Ensure that traffic is transmitted at a certain interval in seconds. This is
85 useful for working around firewalls or routers that drop connections after 92 useful for working around firewalls or routers that drop connections after
86 a certain period of inactivity. The trade-off is that a session may be 93 a certain period of inactivity. The trade-off is that a session may be
87 closed if there is a temporary lapse of network connectivity. A setting 94 closed if there is a temporary lapse of network connectivity. A setting
88 if 0 disables keepalives. 95 if 0 disables keepalives.
96 .TP
97 .B \-I \fIidle_timeout
98 Disconnect the session if no traffic is transmitted or received for \fIidle_timeout\fR seconds.
99 .TP
100 .B \-J \fIproxy_command
101 Use the standard input/output of the program \fIproxy_command\fR rather than using
102 a normal TCP connection. A hostname should be still be provided, as this is used for
103 comparing saved hostkeys.
104 .TP
105 .B \-B \fIendhost:endport
106 "Netcat-alike" mode, where Dropbear will connect to the given host, then create a
107 forwarded connection to \fIendhost\fR. This will then be presented as dbclient's
108 standard input/output.
109
110 Dropbear will also allow multiple "hops" to be specified, separated by commas. In
111 this case a connection will be made to the first host, then a TCP forwarded
112 connection will be made through that to the second host, and so on. Hosts other than
113 the final destination will not see anything other than the encrypted SSH stream.
114 A port for a host can be specified with a slash (eg matt@martello/44 ).
115 This syntax can also be used with scp or rsync (specifying dbclient as the
116 ssh/rsh command). A file can be "bounced" through multiple SSH hops, eg
117
118 scp -S dbclient matt@martello,root@wrt,canyons:/tmp/dump .
119
120 Note that hostnames are resolved by the prior hop (so "canyons" would be resolved by the host "wrt")
121 in the example above, the same way as other -L TCP forwarded hosts are. Host keys are
122 checked locally based on the given hostname.
123
89 .SH ENVIRONMENT 124 .SH ENVIRONMENT
125 .TP
126 .B DROPBEAR_PASSWORD
127 A password to use for remote authentication can be specified in the environment
128 variable DROPBEAR_PASSWORD. Care should be taken that the password is not
129 exposed to other users on a multi-user system, or stored in accessible files.
90 .TP 130 .TP
91 .B SSH_ASKPASS 131 .B SSH_ASKPASS
92 dbclient can use an external program to request a password from a user. 132 dbclient can use an external program to request a password from a user.
93 SSH_ASKPASS should be set to the path of a program that will return a password 133 SSH_ASKPASS should be set to the path of a program that will return a password
94 on standard output. This program will only be used if either DISPLAY is set and 134 on standard output. This program will only be used if either DISPLAY is set and
95 standard input is not a TTY, or the environment variable SSH_ASKPASS_ALWAYS is 135 standard input is not a TTY, or the environment variable SSH_ASKPASS_ALWAYS is
96 set. 136 set.
97 .TP
98 .B DROPBEAR_PASSWORD
99 A password to use for remote authentication can be specified in the environment
100 variable DROPBEAR_PASSWORD. Care should be taken that the password is not
101 exposed to other users on a multi-user system, or stored in accessible files.
102 .SH AUTHOR 137 .SH AUTHOR
103 Matt Johnston ([email protected]). 138 Matt Johnston ([email protected]).
139 .br
140 Mihnea Stoenescu wrote initial Dropbear client support
104 .br 141 .br
105 Gerrit Pape ([email protected]) wrote this manual page. 142 Gerrit Pape ([email protected]) wrote this manual page.
106 .SH SEE ALSO 143 .SH SEE ALSO
107 dropbear(8), dropbearkey(8) 144 dropbear(8), dropbearkey(8)
108 .P 145 .P