Mercurial > dropbear
annotate dbclient.1 @ 1811:7dc92355a986
Remove some obselete autoconf bits.
Keeps autoconf 2.71 happy, though we leave the prereq version at 2.59
| author | Matt Johnston <matt@ucc.asn.au> |
|---|---|
| date | Tue, 30 Mar 2021 20:42:04 +0800 |
| parents | 94323a20e572 |
| children |
| 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 |
|
1174
80cacacfec23
Fix minor manpage formatting issues
Guilhem Moulin <guilhem@fripost.org>
parents:
1172
diff
changeset
|
6 [\fIflag arguments\fR] [\-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 |
| 1172 | 9 .I l\fR:\fIh\fR:\fIp\fR] [\-R |
| 10 .I l\fR:\fIh\fR:\fIp\fR] [\-l | |
|
180
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 |
|
1174
80cacacfec23
Fix minor manpage formatting issues
Guilhem Moulin <guilhem@fripost.org>
parents:
1172
diff
changeset
|
13 .RI [ \fImore\ flags\fR ] |
|
501
d58c478bd399
Add support for [email protected] delayed compression.
Matt Johnston <matt@ucc.asn.au>
parents:
472
diff
changeset
|
14 .RI [ command ] |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
15 |
|
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
16 .B dbclient |
|
1174
80cacacfec23
Fix minor manpage formatting issues
Guilhem Moulin <guilhem@fripost.org>
parents:
1172
diff
changeset
|
17 [\fIargs\fR] |
|
80cacacfec23
Fix minor manpage formatting issues
Guilhem Moulin <guilhem@fripost.org>
parents:
1172
diff
changeset
|
18 [\fIuser1\fR]@\fIhost1\fR[^\fIport1\fR],[\fIuser2\fR]@\fIhost2\fR[^\fIport2\fR],... |
|
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 |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
22 is the client part of Dropbear SSH |
|
180
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
23 .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
|
24 .TP |
| 1172 | 25 .TP |
| 26 .B command | |
| 27 A command to run on the remote host. This will normally be run by the remote host | |
| 28 using the user's shell. The command begins at the first hyphen argument after the | |
| 29 host argument. If no command is specified an interactive terminal will be opened | |
| 30 (see -t and -T). | |
| 31 .TP | |
|
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 .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
|
33 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
|
34 .I port |
|
895
5608a5a61c2a
Change port separator to ^ since % is used in ipv6 addresses
Matt Johnston <matt@ucc.asn.au>
parents:
821
diff
changeset
|
35 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
|
36 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
|
37 .TP |
|
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
38 .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
|
39 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
|
40 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
|
41 .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
|
42 (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
|
43 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
|
44 .TP |
|
1174
80cacacfec23
Fix minor manpage formatting issues
Guilhem Moulin <guilhem@fripost.org>
parents:
1172
diff
changeset
|
45 .B \-L\fR [\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
|
46 Local port forwarding. |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
47 Forward |
|
327
1857c2c551ea
Bring in changes from Debian 0.48.1-1
Matt Johnston <matt@ucc.asn.au>
parents:
326
diff
changeset
|
48 .I listenport |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
49 on the local host through the SSH connection to |
|
327
1857c2c551ea
Bring in changes from Debian 0.48.1-1
Matt Johnston <matt@ucc.asn.au>
parents:
326
diff
changeset
|
50 .I port |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
51 on |
|
327
1857c2c551ea
Bring in changes from Debian 0.48.1-1
Matt Johnston <matt@ucc.asn.au>
parents:
326
diff
changeset
|
52 .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
|
53 .TP |
|
1174
80cacacfec23
Fix minor manpage formatting issues
Guilhem Moulin <guilhem@fripost.org>
parents:
1172
diff
changeset
|
54 .B \-R\fR [\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
|
55 Remote port forwarding. |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
56 Forward |
|
327
1857c2c551ea
Bring in changes from Debian 0.48.1-1
Matt Johnston <matt@ucc.asn.au>
parents:
326
diff
changeset
|
57 .I listenport |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
58 on the remote host through the SSH connection to |
|
327
1857c2c551ea
Bring in changes from Debian 0.48.1-1
Matt Johnston <matt@ucc.asn.au>
parents:
326
diff
changeset
|
59 .I port |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
60 on |
|
327
1857c2c551ea
Bring in changes from Debian 0.48.1-1
Matt Johnston <matt@ucc.asn.au>
parents:
326
diff
changeset
|
61 .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
|
62 .TP |
|
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
63 .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
|
64 Username. |
|
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
65 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
|
66 .I user |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
67 on the remote host. An alternative is to specify user@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
|
68 .TP |
|
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
69 .B \-t |
| 1172 | 70 Allocate a PTY. This is the default when no command is given, it gives a full |
| 71 interactive remote session. The main effect is that keystrokes are sent remotely | |
| 72 immediately as opposed to local line-based editing. | |
|
180
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
73 .TP |
|
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
74 .B \-T |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
75 Don't allocate a PTY. This is the default when a command is given. See -t. |
|
258
306499676384
* add -g (dbclient) and -a (dropbear) options for allowing non-local
Matt Johnston <matt@ucc.asn.au>
parents:
180
diff
changeset
|
76 .TP |
|
325
0e4f225b7e07
Add -N "no remote command" dbclient option.
Matt Johnston <matt@ucc.asn.au>
parents:
258
diff
changeset
|
77 .B \-N |
|
0e4f225b7e07
Add -N "no remote command" dbclient option.
Matt Johnston <matt@ucc.asn.au>
parents:
258
diff
changeset
|
78 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
|
79 .TP |
|
326
d965110e3f5c
add -f background option to dbclient
Matt Johnston <matt@ucc.asn.au>
parents:
325
diff
changeset
|
80 .B \-f |
|
d965110e3f5c
add -f background option to dbclient
Matt Johnston <matt@ucc.asn.au>
parents:
325
diff
changeset
|
81 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
|
82 This is useful when using password authentication. |
|
d965110e3f5c
add -f background option to dbclient
Matt Johnston <matt@ucc.asn.au>
parents:
325
diff
changeset
|
83 .TP |
|
258
306499676384
* add -g (dbclient) and -a (dropbear) options for allowing non-local
Matt Johnston <matt@ucc.asn.au>
parents:
180
diff
changeset
|
84 .B \-g |
|
306499676384
* add -g (dbclient) and -a (dropbear) options for allowing non-local
Matt Johnston <matt@ucc.asn.au>
parents:
180
diff
changeset
|
85 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
|
86 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
|
87 by the ssh server. |
| 437 | 88 .TP |
| 89 .B \-y | |
| 90 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
|
91 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
|
92 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
|
93 .TP |
| 560 | 94 .B \-A |
| 95 Forward agent connections to the remote host. dbclient will use any | |
| 96 OpenSSH-style agent program if available ($SSH_AUTH_SOCK will be set) for | |
| 97 public key authentication. Forwarding is only enabled if -A is specified. | |
| 98 .TP | |
|
449
3e6c536bc023
Add -W <windowsize> argument and document it.
Matt Johnston <matt@ucc.asn.au>
parents:
446
diff
changeset
|
99 .B \-W \fIwindowsize |
|
3e6c536bc023
Add -W <windowsize> argument and document it.
Matt Johnston <matt@ucc.asn.au>
parents:
446
diff
changeset
|
100 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
|
101 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
|
102 default buffer size. |
|
454
7e43f5e473b9
- Add -K keepalive flag for dropbear and dbclient
Matt Johnston <matt@ucc.asn.au>
parents:
449
diff
changeset
|
103 .TP |
|
7e43f5e473b9
- Add -K keepalive flag for dropbear and dbclient
Matt Johnston <matt@ucc.asn.au>
parents:
449
diff
changeset
|
104 .B \-K \fItimeout_seconds |
|
7e43f5e473b9
- Add -K keepalive flag for dropbear and dbclient
Matt Johnston <matt@ucc.asn.au>
parents:
449
diff
changeset
|
105 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
|
106 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
|
107 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
|
108 closed if there is a temporary lapse of network connectivity. A setting |
| 946 | 109 if 0 disables keepalives. If no response is received for 3 consecutive keepalives the connection will be closed. |
| 515 | 110 .TP |
| 111 .B \-I \fIidle_timeout | |
| 112 Disconnect the session if no traffic is transmitted or received for \fIidle_timeout\fR seconds. | |
| 113 .TP | |
|
1516
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
114 |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
115 .\" TODO: how to avoid a line break between these two -J arguments? |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
116 .B \-J \fIproxy_command |
|
1516
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
117 .TP |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
118 .B \-J \fI&fd |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
119 .br |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
120 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
|
121 a normal TCP connection. A hostname should be still be provided, as this is used for |
| 1221 | 122 comparing saved hostkeys. This command will be executed as "exec proxy_command ..." with the |
| 123 default shell. | |
|
1516
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
124 |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
125 The second form &fd will make dbclient use the numeric file descriptor as a socket. This |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
126 can be used for more complex tunnelling scenarios. Example usage with socat is |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
127 |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
128 socat EXEC:'dbclient -J &38 ev',fdin=38,fdout=38 TCP4:host.example.com:22 |
|
33b872649eb7
Add dbclient '-J &fd' option for a file descriptor
Matt Johnston <matt@ucc.asn.au>
parents:
1466
diff
changeset
|
129 |
| 515 | 130 .TP |
| 516 | 131 .B \-B \fIendhost:endport |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
132 "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
|
133 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
|
134 standard input/output. |
| 690 | 135 .TP |
| 136 .B \-c \fIcipherlist | |
| 137 Specify a comma separated list of ciphers to enable. Use \fI-c help\fR to list possibilities. | |
| 138 .TP | |
| 139 .B \-m \fIMAClist | |
| 140 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
|
141 .TP |
|
1206
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
142 .B \-o \fIoption |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
143 Can be used to give options in the format used by OpenSSH config file. This is |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
144 useful for specifying options for which there is no separate command-line flag. |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
145 For full details of the options listed below, and their possible values, see |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
146 ssh_config(5). |
|
1466
f787f60f8e45
bind to port as well with -b
Matt Johnston <matt@ucc.asn.au>
parents:
1221
diff
changeset
|
147 The following options have currently been implemented: |
|
1206
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
148 |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
149 .RS |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
150 .TP |
|
1212
bf626d259eb1
Support syslog logging in dbclient.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1206
diff
changeset
|
151 .B ExitOnForwardFailure |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
152 Specifies whether dbclient should terminate the connection if it cannot set up all requested local and remote port forwardings. The argument must be "yes" or "no". The default is "no". |
|
1212
bf626d259eb1
Support syslog logging in dbclient.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1206
diff
changeset
|
153 .TP |
|
bf626d259eb1
Support syslog logging in dbclient.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1206
diff
changeset
|
154 .B UseSyslog |
|
bf626d259eb1
Support syslog logging in dbclient.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1206
diff
changeset
|
155 Send dbclient log messages to syslog in addition to stderr. |
|
1784
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
156 .TP |
|
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
157 .B Port |
|
94323a20e572
Some minor manpage improvements
Matt Johnston <matt@ucc.asn.au>
parents:
1516
diff
changeset
|
158 Specify a listening port, like the \fI-p\fR argument. |
|
1206
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
159 .RE |
|
2907c658fa76
Implemented ExitOnForwardFailure option for local and remote forwarding.
Konstantin Tokarev <ktokarev@smartlabs.tv>
parents:
1174
diff
changeset
|
160 .TP |
|
697
aadfa8de977d
improve subsystem/sftp documentation, and multi-hop manual formatting
Matt Johnston <matt@ucc.asn.au>
parents:
690
diff
changeset
|
161 .B \-s |
|
aadfa8de977d
improve subsystem/sftp documentation, and multi-hop manual formatting
Matt Johnston <matt@ucc.asn.au>
parents:
690
diff
changeset
|
162 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 | 163 .TP |
|
1466
f787f60f8e45
bind to port as well with -b
Matt Johnston <matt@ucc.asn.au>
parents:
1221
diff
changeset
|
164 .B \-b \fI[address][:port] |
|
f787f60f8e45
bind to port as well with -b
Matt Johnston <matt@ucc.asn.au>
parents:
1221
diff
changeset
|
165 Bind to a specific local address when connecting to the remote host. This can be used to choose from |
|
f787f60f8e45
bind to port as well with -b
Matt Johnston <matt@ucc.asn.au>
parents:
1221
diff
changeset
|
166 multiple outgoing interfaces. Either address or port (or both) can be given. |
|
f787f60f8e45
bind to port as well with -b
Matt Johnston <matt@ucc.asn.au>
parents:
1221
diff
changeset
|
167 .TP |
| 946 | 168 .B \-V |
| 169 Print the version | |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
170 |
|
697
aadfa8de977d
improve subsystem/sftp documentation, and multi-hop manual formatting
Matt Johnston <matt@ucc.asn.au>
parents:
690
diff
changeset
|
171 .SH MULTI-HOP |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
172 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
|
173 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
|
174 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
|
175 the final destination will not see anything other than the encrypted SSH stream. |
| 1172 | 176 A port for a host can be specified with a caret (eg matt@martello^44 ). |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
177 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
|
178 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
|
179 |
|
b85507ade010
- Update manuals, include section on authorized_keys
Matt Johnston <matt@ucc.asn.au>
parents:
509
diff
changeset
|
180 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
|
181 |
| 516 | 182 Note that hostnames are resolved by the prior hop (so "canyons" would be resolved by the host "wrt") |
| 183 in the example above, the same way as other -L TCP forwarded hosts are. Host keys are | |
| 184 checked locally based on the given hostname. | |
| 185 | |
| 774 | 186 .SH ESCAPE CHARACTERS |
| 187 Typing a newline followed by the key sequence \fI~.\fR (tilde, dot) will terminate a connection. | |
| 188 The sequence \fI~^Z\fR (tilde, ctrl-z) will background the connection. This behaviour only | |
| 189 applies when a PTY is used. | |
| 190 | |
|
472
d7b0c015fdc7
Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
454
diff
changeset
|
191 .SH ENVIRONMENT |
|
d7b0c015fdc7
Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
454
diff
changeset
|
192 .TP |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
193 .B DROPBEAR_PASSWORD |
|
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
194 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
|
195 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
|
196 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
|
197 .TP |
|
472
d7b0c015fdc7
Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
454
diff
changeset
|
198 .B SSH_ASKPASS |
|
d7b0c015fdc7
Add SSH_ASKPASS and DROPBEAR_PASSWORD to the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
454
diff
changeset
|
199 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
|
200 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
|
201 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
|
202 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
|
203 set. |
| 1172 | 204 .SH NOTES |
| 205 If compiled with zlib support and if the server supports it, dbclient will | |
| 206 always use compression. | |
| 207 | |
|
180
743fce568f49
Merge in Debian package changes from 0.45-3, grab the dbclient manpage
Matt Johnston <matt@ucc.asn.au>
parents:
diff
changeset
|
208 .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
|
209 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
|
210 .br |
|
509
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
211 Mihnea Stoenescu wrote initial Dropbear client support |
|
4e251543b941
LICENSE - Update copyright to 2008
Matt Johnston <matt@ucc.asn.au>
parents:
501
diff
changeset
|
212 .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
|
213 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
|
214 .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
|
215 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
|
216 .P |
| 690 | 217 https://matt.ucc.asn.au/dropbear/dropbear.html |