dropbear: dbclient.1 annotate

annotate dbclient.1 @ 1167:1397a677cb5c

lazy allocation of circbuffer

author	Matt Johnston <matt@ucc.asn.au>
date	Thu, 19 Nov 2015 23:52:11 +0800
parents	b8f362078209
children	a44747e5a05a

rev	line source
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	1 .TH dbclient 1
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	2 .SH NAME
821 f8b28a3de6cb Don't say "SSH 2" any more since protocol version 1 is irrelevant Matt Johnston <matt@ucc.asn.au> parents: 784 diff changeset	3 dbclient \- lightweight SSH client
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	4 .SH SYNOPSIS
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	5 .B dbclient
1153 67d8a904f5a9 don't silently ignore extra flag arguments Matt Johnston <matt@ucc.asn.au> parents: 999 diff changeset	6 [flag arguments] [\-p
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	7 .I port\fR] [\-i
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	8 .I id\fR] [\-L
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	9 .I l\fR:\fIh\fR:\fIr\fR] [\-R
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	10 .I l\fR:\fIh\fR:\fIr\fR] [\-l
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	11 .IR user ]
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	12 .I host
501 d58c478bd399 Add support for [email protected] delayed compression. Matt Johnston <matt@ucc.asn.au> parents: 472 diff changeset	13 .RI [ command ]
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	14
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	15 .B dbclient
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	16 [
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	17 .I args ]
895 5608a5a61c2a Change port separator to ^ since % is used in ipv6 addresses Matt Johnston <matt@ucc.asn.au> parents: 821 diff changeset	18 .I [user1]@host1[^port1],[user2]@host2[^port2],...
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	19
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	20 .SH DESCRIPTION
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	21 .B dbclient
946 17d874ae93a1 Add '-V' for version Matt Johnston <matt@ucc.asn.au> parents: 895 diff changeset	22 is a small SSH client
1161 b8f362078209 Add comment about compression Matt Johnston <matt@ucc.asn.au> parents: 1153 diff changeset	23 .P
b8f362078209 Add comment about compression Matt Johnston <matt@ucc.asn.au> parents: 1153 diff changeset	24 If compiled with zlib support and if the server supports it, dbclient will
b8f362078209 Add comment about compression Matt Johnston <matt@ucc.asn.au> parents: 1153 diff changeset	25 always use compression.
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	26 .SH OPTIONS
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	27 .TP
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	28 .B \-p \fIport
783 34e69908b3f7 Use '#' for host#port separator, document it. This fixes scp Matt Johnston <matt@ucc.asn.au> parents: 774 diff changeset	29 Connect to
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	30 .I port
895 5608a5a61c2a Change port separator to ^ since % is used in ipv6 addresses Matt Johnston <matt@ucc.asn.au> parents: 821 diff changeset	31 on the remote host. Alternatively a port can be specified as hostname^port.
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	32 Default is 22.
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	33 .TP
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	34 .B \-i \fIidfile
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	35 Identity file.
821 f8b28a3de6cb Don't say "SSH 2" any more since protocol version 1 is irrelevant Matt Johnston <matt@ucc.asn.au> parents: 784 diff changeset	36 Read the identity key from file
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	37 .I idfile
821 f8b28a3de6cb Don't say "SSH 2" any more since protocol version 1 is irrelevant Matt Johnston <matt@ucc.asn.au> parents: 784 diff changeset	38 (multiple allowed). This file is created with dropbearkey(1) or converted
999 295a08e9d07e Document ~/.ssh/id_dropbear Matt Johnston <matt@ucc.asn.au> parents: 946 diff changeset	39 from OpenSSH with dropbearconvert(1). The default path ~/.ssh/id_dropbear is used
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	40 .TP
597 a415c5b71420 Mention -L/-R listenaddress argument in manpage Matt Johnston <matt@ucc.asn.au> parents: 560 diff changeset	41 .B \-L [\fIlistenaddress\fR]:\fIlistenport\fR:\fIhost\fR:\fIport\fR
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	42 Local port forwarding.
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	43 Forward the port
327 1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	44 .I listenport
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	45 on the local host through the SSH connection to port
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	46 .I port
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	47 on the host
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	48 .IR host .
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	49 .TP
597 a415c5b71420 Mention -L/-R listenaddress argument in manpage Matt Johnston <matt@ucc.asn.au> parents: 560 diff changeset	50 .B \-R [\fIlistenaddress\fR]:\fIlistenport\fR:\fIhost\fR:\fIport\fR
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	51 Remote port forwarding.
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	52 Forward the port
327 1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	53 .I listenport
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	54 on the remote host through the SSH connection to port
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	55 .I port
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	56 on the host
1857c2c551ea Bring in changes from Debian 0.48.1-1 Matt Johnston <matt@ucc.asn.au> parents: 326 diff changeset	57 .IR host .
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	58 .TP
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	59 .B \-l \fIuser
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	60 Username.
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	61 Login as
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	62 .I user
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	63 on the remote host.
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	64 .TP
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	65 .B \-t
774 e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	66 Allocate a PTY.
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	67 .TP
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	68 .B \-T
774 e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	69 Don't allocate a PTY.
258 306499676384 * add -g (dbclient) and -a (dropbear) options for allowing non-local Matt Johnston <matt@ucc.asn.au> parents: 180 diff changeset	70 .TP
325 0e4f225b7e07 Add -N "no remote command" dbclient option. Matt Johnston <matt@ucc.asn.au> parents: 258 diff changeset	71 .B \-N
0e4f225b7e07 Add -N "no remote command" dbclient option. Matt Johnston <matt@ucc.asn.au> parents: 258 diff changeset	72 Don't request a remote shell or run any commands. Any command arguments are ignored.
0e4f225b7e07 Add -N "no remote command" dbclient option. Matt Johnston <matt@ucc.asn.au> parents: 258 diff changeset	73 .TP
326 d965110e3f5c add -f background option to dbclient Matt Johnston <matt@ucc.asn.au> parents: 325 diff changeset	74 .B \-f
d965110e3f5c add -f background option to dbclient Matt Johnston <matt@ucc.asn.au> parents: 325 diff changeset	75 Fork into the background after authentication. A command argument (or -N) is required.
d965110e3f5c add -f background option to dbclient Matt Johnston <matt@ucc.asn.au> parents: 325 diff changeset	76 This is useful when using password authentication.
d965110e3f5c add -f background option to dbclient Matt Johnston <matt@ucc.asn.au> parents: 325 diff changeset	77 .TP
258 306499676384 * add -g (dbclient) and -a (dropbear) options for allowing non-local Matt Johnston <matt@ucc.asn.au> parents: 180 diff changeset	78 .B \-g
306499676384 * add -g (dbclient) and -a (dropbear) options for allowing non-local Matt Johnston <matt@ucc.asn.au> parents: 180 diff changeset	79 Allow non-local hosts to connect to forwarded ports. Applies to -L and -R
306499676384 * add -g (dbclient) and -a (dropbear) options for allowing non-local Matt Johnston <matt@ucc.asn.au> parents: 180 diff changeset	80 forwarded ports, though remote connections to -R forwarded ports may be limited
306499676384 * add -g (dbclient) and -a (dropbear) options for allowing non-local Matt Johnston <matt@ucc.asn.au> parents: 180 diff changeset	81 by the ssh server.
437 7319d229799a 0.49 probably done Matt Johnston <matt@ucc.asn.au> parents: 327 diff changeset	82 .TP
7319d229799a 0.49 probably done Matt Johnston <matt@ucc.asn.au> parents: 327 diff changeset	83 .B \-y
7319d229799a 0.49 probably done Matt Johnston <matt@ucc.asn.au> parents: 327 diff changeset	84 Always accept hostkeys if they are unknown. If a hostkey mismatch occurs the
772 7fc0aeada79c -y -y to disable hostkey checking Matt Johnston <matt@ucc.asn.au> parents: 697 diff changeset	85 connection will abort as normal. If specified a second time no host key checking
7fc0aeada79c -y -y to disable hostkey checking Matt Johnston <matt@ucc.asn.au> parents: 697 diff changeset	86 is performed at all, this is usually undesirable.
449 3e6c536bc023 Add -W <windowsize> argument and document it. Matt Johnston <matt@ucc.asn.au> parents: 446 diff changeset	87 .TP
560 52d7301e46bd Agent forwarding works Matt Johnston <matt@ucc.asn.au> parents: 516 diff changeset	88 .B \-A
52d7301e46bd Agent forwarding works Matt Johnston <matt@ucc.asn.au> parents: 516 diff changeset	89 Forward agent connections to the remote host. dbclient will use any
52d7301e46bd Agent forwarding works Matt Johnston <matt@ucc.asn.au> parents: 516 diff changeset	90 OpenSSH-style agent program if available ($SSH_AUTH_SOCK will be set) for
52d7301e46bd Agent forwarding works Matt Johnston <matt@ucc.asn.au> parents: 516 diff changeset	91 public key authentication. Forwarding is only enabled if -A is specified.
52d7301e46bd Agent forwarding works Matt Johnston <matt@ucc.asn.au> parents: 516 diff changeset	92 .TP
449 3e6c536bc023 Add -W <windowsize> argument and document it. Matt Johnston <matt@ucc.asn.au> parents: 446 diff changeset	93 .B \-W \fIwindowsize
3e6c536bc023 Add -W <windowsize> argument and document it. Matt Johnston <matt@ucc.asn.au> parents: 446 diff changeset	94 Specify the per-channel receive window buffer size. Increasing this
3e6c536bc023 Add -W <windowsize> argument and document it. Matt Johnston <matt@ucc.asn.au> parents: 446 diff changeset	95 may improve network performance at the expense of memory use. Use -h to see the
3e6c536bc023 Add -W <windowsize> argument and document it. Matt Johnston <matt@ucc.asn.au> parents: 446 diff changeset	96 default buffer size.
454 7e43f5e473b9 - Add -K keepalive flag for dropbear and dbclient Matt Johnston <matt@ucc.asn.au> parents: 449 diff changeset	97 .TP
7e43f5e473b9 - Add -K keepalive flag for dropbear and dbclient Matt Johnston <matt@ucc.asn.au> parents: 449 diff changeset	98 .B \-K \fItimeout_seconds
7e43f5e473b9 - Add -K keepalive flag for dropbear and dbclient Matt Johnston <matt@ucc.asn.au> parents: 449 diff changeset	99 Ensure that traffic is transmitted at a certain interval in seconds. This is
7e43f5e473b9 - Add -K keepalive flag for dropbear and dbclient Matt Johnston <matt@ucc.asn.au> parents: 449 diff changeset	100 useful for working around firewalls or routers that drop connections after
7e43f5e473b9 - Add -K keepalive flag for dropbear and dbclient Matt Johnston <matt@ucc.asn.au> parents: 449 diff changeset	101 a certain period of inactivity. The trade-off is that a session may be
7e43f5e473b9 - Add -K keepalive flag for dropbear and dbclient Matt Johnston <matt@ucc.asn.au> parents: 449 diff changeset	102 closed if there is a temporary lapse of network connectivity. A setting
946 17d874ae93a1 Add '-V' for version Matt Johnston <matt@ucc.asn.au> parents: 895 diff changeset	103 if 0 disables keepalives. If no response is received for 3 consecutive keepalives the connection will be closed.
515 fe30d2a2d626 - Document idle_timeout Matt Johnston <matt@ucc.asn.au> parents: 510 diff changeset	104 .TP
fe30d2a2d626 - Document idle_timeout Matt Johnston <matt@ucc.asn.au> parents: 510 diff changeset	105 .B \-I \fIidle_timeout
fe30d2a2d626 - Document idle_timeout Matt Johnston <matt@ucc.asn.au> parents: 510 diff changeset	106 Disconnect the session if no traffic is transmitted or received for \fIidle_timeout\fR seconds.
fe30d2a2d626 - Document idle_timeout Matt Johnston <matt@ucc.asn.au> parents: 510 diff changeset	107 .TP
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	108 .B \-J \fIproxy_command
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	109 Use the standard input/output of the program \fIproxy_command\fR rather than using
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	110 a normal TCP connection. A hostname should be still be provided, as this is used for
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	111 comparing saved hostkeys.
515 fe30d2a2d626 - Document idle_timeout Matt Johnston <matt@ucc.asn.au> parents: 510 diff changeset	112 .TP
516 7fc4ba3c1cbb - Bump to 0.52 Matt Johnston <matt@ucc.asn.au> parents: 515 diff changeset	113 .B \-B \fIendhost:endport
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	114 "Netcat-alike" mode, where Dropbear will connect to the given host, then create a
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	115 forwarded connection to \fIendhost\fR. This will then be presented as dbclient's
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	116 standard input/output.
690 4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	117 .TP
4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	118 .B \-c \fIcipherlist
4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	119 Specify a comma separated list of ciphers to enable. Use \fI-c help\fR to list possibilities.
4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	120 .TP
4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	121 .B \-m \fIMAClist
4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	122 Specify a comma separated list of authentication MACs to enable. Use \fI-m help\fR to list possibilities.
697 aadfa8de977d improve subsystem/sftp documentation, and multi-hop manual formatting Matt Johnston <matt@ucc.asn.au> parents: 690 diff changeset	123 .TP
aadfa8de977d improve subsystem/sftp documentation, and multi-hop manual formatting Matt Johnston <matt@ucc.asn.au> parents: 690 diff changeset	124 .B \-s
aadfa8de977d improve subsystem/sftp documentation, and multi-hop manual formatting Matt Johnston <matt@ucc.asn.au> parents: 690 diff changeset	125 The specified command will be requested as a subsystem, used for sftp. Dropbear doesn't implement sftp itself but the OpenSSH sftp client can be used eg \fIsftp -S dbclient user@host\fR
946 17d874ae93a1 Add '-V' for version Matt Johnston <matt@ucc.asn.au> parents: 895 diff changeset	126 .TP
17d874ae93a1 Add '-V' for version Matt Johnston <matt@ucc.asn.au> parents: 895 diff changeset	127 .B \-V
17d874ae93a1 Add '-V' for version Matt Johnston <matt@ucc.asn.au> parents: 895 diff changeset	128 Print the version
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	129
697 aadfa8de977d improve subsystem/sftp documentation, and multi-hop manual formatting Matt Johnston <matt@ucc.asn.au> parents: 690 diff changeset	130 .SH MULTI-HOP
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	131 Dropbear will also allow multiple "hops" to be specified, separated by commas. In
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	132 this case a connection will be made to the first host, then a TCP forwarded
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	133 connection will be made through that to the second host, and so on. Hosts other than
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	134 the final destination will not see anything other than the encrypted SSH stream.
895 5608a5a61c2a Change port separator to ^ since % is used in ipv6 addresses Matt Johnston <matt@ucc.asn.au> parents: 821 diff changeset	135 A port for a host can be specified with a hash (eg matt@martello^44 ).
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	136 This syntax can also be used with scp or rsync (specifying dbclient as the
510 b85507ade010 - Update manuals, include section on authorized_keys Matt Johnston <matt@ucc.asn.au> parents: 509 diff changeset	137 ssh/rsh command). A file can be "bounced" through multiple SSH hops, eg
b85507ade010 - Update manuals, include section on authorized_keys Matt Johnston <matt@ucc.asn.au> parents: 509 diff changeset	138
b85507ade010 - Update manuals, include section on authorized_keys Matt Johnston <matt@ucc.asn.au> parents: 509 diff changeset	139 scp -S dbclient matt@martello,root@wrt,canyons:/tmp/dump .
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	140
516 7fc4ba3c1cbb - Bump to 0.52 Matt Johnston <matt@ucc.asn.au> parents: 515 diff changeset	141 Note that hostnames are resolved by the prior hop (so "canyons" would be resolved by the host "wrt")
7fc4ba3c1cbb - Bump to 0.52 Matt Johnston <matt@ucc.asn.au> parents: 515 diff changeset	142 in the example above, the same way as other -L TCP forwarded hosts are. Host keys are
7fc4ba3c1cbb - Bump to 0.52 Matt Johnston <matt@ucc.asn.au> parents: 515 diff changeset	143 checked locally based on the given hostname.
7fc4ba3c1cbb - Bump to 0.52 Matt Johnston <matt@ucc.asn.au> parents: 515 diff changeset	144
774 e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	145 .SH ESCAPE CHARACTERS
e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	146 Typing a newline followed by the key sequence \fI~.\fR (tilde, dot) will terminate a connection.
e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	147 The sequence \fI~^Z\fR (tilde, ctrl-z) will background the connection. This behaviour only
e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	148 applies when a PTY is used.
e8b2ca448928 Document escape chars Matt Johnston <matt@ucc.asn.au> parents: 772 diff changeset	149
472 d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	150 .SH ENVIRONMENT
d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	151 .TP
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	152 .B DROPBEAR_PASSWORD
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	153 A password to use for remote authentication can be specified in the environment
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	154 variable DROPBEAR_PASSWORD. Care should be taken that the password is not
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	155 exposed to other users on a multi-user system, or stored in accessible files.
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	156 .TP
472 d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	157 .B SSH_ASKPASS
d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	158 dbclient can use an external program to request a password from a user.
d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	159 SSH_ASKPASS should be set to the path of a program that will return a password
d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	160 on standard output. This program will only be used if either DISPLAY is set and
d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	161 standard input is not a TTY, or the environment variable SSH_ASKPASS_ALWAYS is
d7b0c015fdc7 Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: 454 diff changeset	162 set.
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	163 .SH AUTHOR
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	164 Matt Johnston ([email protected]).
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	165 .br
509 4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	166 Mihnea Stoenescu wrote initial Dropbear client support
4e251543b941 LICENSE - Update copyright to 2008 Matt Johnston <matt@ucc.asn.au> parents: 501 diff changeset	167 .br
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	168 Gerrit Pape ([email protected]) wrote this manual page.
743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	169 .SH SEE ALSO
821 f8b28a3de6cb Don't say "SSH 2" any more since protocol version 1 is irrelevant Matt Johnston <matt@ucc.asn.au> parents: 784 diff changeset	170 dropbear(8), dropbearkey(1)
180 743fce568f49 Merge in Debian package changes from 0.45-3, grab the dbclient manpage Matt Johnston <matt@ucc.asn.au> parents: diff changeset	171 .P
690 4b47ff154ff6 Document "-m" and "-c" Matt Johnston <matt@ucc.asn.au> parents: 597 diff changeset	172 https://matt.ucc.asn.au/dropbear/dropbear.html

Mercurial > dropbear

annotate dbclient.1 @ 1167:1397a677cb5c