Mercurial > dropbear

comparison dbclient.1 @ 509:4e251543b941

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
LICENSE - Update copyright to 2008 cli-runopts.c - mention that -v is for DEBUG_TRACE, add multihop syntax dbclient.1 - document some new features
author Matt Johnston <matt@ucc.asn.au>
date Wed, 05 Nov 2008 13:53:14 +0000
parents d58c478bd399
children b85507ade010
comparison
equal deleted inserted replaced
508:d4bbc0039008 509:4e251543b941
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 ] 13 .RI [ command ]
14
15 .B dbclient
16 [
17 .I args ]
18 .I [user1]@host1[/port1],[user2]@host2[/port2],...
19
14 .SH DESCRIPTION 20 .SH DESCRIPTION
15 .B dbclient 21 .B dbclient
16 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
17 environments, while still being functional and secure enough for general use. 23 environments, while still being functional and secure enough for general use.
18 .SH OPTIONS 24 .SH OPTIONS
85 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
86 useful for working around firewalls or routers that drop connections after 92 useful for working around firewalls or routers that drop connections after
87 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
88 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
89 if 0 disables keepalives. 95 if 0 disables keepalives.
96 .B \-J \fIproxy_command
97 Use the standard input/output of the program \fIproxy_command\fR rather than using
98 a normal TCP connection. A hostname should be still be provided, as this is used for
99 comparing saved hostkeys.
100 .B \B \fIendhost:endport
101 "Netcat-alike" mode, where Dropbear will connect to the given host, then create a
102 forwarded connection to \fIendhost\fR. This will then be presented as dbclient's
103 standard input/output.
104
105 Dropbear will also allow multiple "hops" to be specified, separated by commas. In
106 this case a connection will be made to the first host, then a TCP forwarded
107 connection will be made through that to the second host, and so on. Hosts other than
108 the final destination will not see anything other than the encrypted SSH stream.
109 This syntax can also be used with scp or rsync (specifying dbclient as the
110 ssh/rsh command). A port for a host can be specified with a slash (eg matt@martello/44 ).
111
90 .SH ENVIRONMENT 112 .SH ENVIRONMENT
113 .TP
114 .B DROPBEAR_PASSWORD
115 A password to use for remote authentication can be specified in the environment
116 variable DROPBEAR_PASSWORD. Care should be taken that the password is not
117 exposed to other users on a multi-user system, or stored in accessible files.
91 .TP 118 .TP
92 .B SSH_ASKPASS 119 .B SSH_ASKPASS
93 dbclient can use an external program to request a password from a user. 120 dbclient can use an external program to request a password from a user.
94 SSH_ASKPASS should be set to the path of a program that will return a password 121 SSH_ASKPASS should be set to the path of a program that will return a password
95 on standard output. This program will only be used if either DISPLAY is set and 122 on standard output. This program will only be used if either DISPLAY is set and
96 standard input is not a TTY, or the environment variable SSH_ASKPASS_ALWAYS is 123 standard input is not a TTY, or the environment variable SSH_ASKPASS_ALWAYS is
97 set. 124 set.
98 .TP
99 .B DROPBEAR_PASSWORD
100 A password to use for remote authentication can be specified in the environment
101 variable DROPBEAR_PASSWORD. Care should be taken that the password is not
102 exposed to other users on a multi-user system, or stored in accessible files.
103 .SH AUTHOR 125 .SH AUTHOR
104 Matt Johnston ([email protected]). 126 Matt Johnston ([email protected]).
127 .br
128 Mihnea Stoenescu wrote initial Dropbear client support
105 .br 129 .br
106 Gerrit Pape ([email protected]) wrote this manual page. 130 Gerrit Pape ([email protected]) wrote this manual page.
107 .SH SEE ALSO 131 .SH SEE ALSO
108 dropbear(8), dropbearkey(8) 132 dropbear(8), dropbearkey(8)
109 .P 133 .P