~ubuntu-branches/ubuntu/utopic/dropbear/utopic-proposed

« back to all changes in this revision

Viewing changes to dropbear.8

  • Committer: Bazaar Package Importer
  • Author(s): Gerrit Pape, Matt Johnston, Gerrit Pape
  • Date: 2008-11-19 20:58:59 UTC
  • mfrom: (1.4.2 upstream)
  • mto: This revision was merged to the branch mainline in revision 11.
  • Revision ID: james.westby@ubuntu.com-20081119205859-dmeze0y6b16ia93v
Tags: 0.52-1
[ Matt Johnston ]
* New upstream release.
  * dbclient.1: mention optional 'command' argument (closes: #495823).

[ Gerrit Pape ]
* debian/diff/0001-dbclient.1-dbclient-uses-compression-if...diff:
  new; dbclient.1: dbclient uses compression if compiled with zlib
  support (thx Luca Capello, closes: #495825).
* debian/initramfs/*: new; cryptroot remote unlocking on boot feature
  (thx debian@x.ray.net).
* debian/rules: install debian/initramfs/* (thx debian@x.ray.net).
* debian/control: Suggests: udev (for cryptroot support, thx
  debian@x.ray.net).
* debian/dropbear.postinst: conditionally run update-initramfs -u
  (for cryptroot support, thx debian@x.ray.net. closes: #465903).
* debian/diff/0002-dropbearkey.8-mention-y-option-add-example.diff:
  new; mention -y option, add example (thx debian@x.ray.net).

Show diffs side-by-side

added added

removed removed

Lines of Context:
24
24
dsskeyfile.
25
25
Use the contents of the file
26
26
.I dsskey
27
 
for the dss host key (default: /etc/dropbear/dropbear_dss_host_key).
 
27
for the DSS host key (default: /etc/dropbear/dropbear_dss_host_key). 
 
28
Note that 
 
29
some SSH implementations
 
30
use the term "DSA" rather than "DSS", they mean the same thing.
28
31
This file is generated with
29
32
.BR dropbearkey (8).
30
33
.TP
94
97
a certain period of inactivity. The trade-off is that a session may be
95
98
closed if there is a temporary lapse of network connectivity. A setting
96
99
if 0 disables keepalives.
 
100
.TP
 
101
.B \-I \fIidle_timeout
 
102
Disconnect the session if no traffic is transmitted or received for \fIidle_timeout\fR seconds.
 
103
.SH FILES
 
104
 
 
105
.TP
 
106
Authorized Keys
 
107
 
 
108
~/.ssh/authorized_keys can be set up to allow remote login with a RSA or DSS
 
109
key. Each line is of the form
 
110
.TP
 
111
[restrictions] ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIgAsp... [comment]
 
112
 
 
113
and can be extracted from a Dropbear private host key with "dropbearkey -y". This is the same format as used by OpenSSH, though the restrictions are a subset (keys with unknown restrictions are ignored).
 
114
Restrictions are comma separated, with double quotes around spaces in arguments.
 
115
Available restrictions are:
 
116
 
 
117
.TP
 
118
.B no-port-forwarding
 
119
Don't allow port forwarding for this connection
 
120
 
 
121
.TP
 
122
.B no-agent-forwarding
 
123
Don't allow agent forwarding for this connection
 
124
 
 
125
.TP
 
126
.B no-X11-forwarding
 
127
Don't allow X11 forwarding for this connection
 
128
 
 
129
.TP
 
130
.B no-pty
 
131
Disable PTY allocation. Note that a user can still obtain most of the
 
132
same functionality with other means even if no-pty is set.
 
133
 
 
134
.TP
 
135
.B command="\fIforced_command\fR"
 
136
Disregard the command provided by the user and always run \fIforced_command\fR.
 
137
 
 
138
The authorized_keys file and its containing ~/.ssh directory must only be
 
139
writable by the user, otherwise Dropbear will not allow a login using public
 
140
key authentication.
 
141
 
 
142
.TP
 
143
Host Key Files
 
144
 
 
145
Host key files are read at startup from a standard location, by default
 
146
/etc/dropbear/dropbear_dss_host_key and /etc/dropbear/dropbear_rsa_host_key
 
147
or specified on the commandline with -d or -r. These are of the form generated
 
148
by dropbearkey.
 
149
 
 
150
.TP
 
151
Message Of The Day
 
152
 
 
153
By default the file /etc/motd will be printed for any login shell (unless 
 
154
disabled at compile-time). This can also be disabled per-user
 
155
by creating a file ~/.hushlogin .
 
156
 
97
157
.SH AUTHOR
98
158
Matt Johnston (matt@ucc.asn.au).
99
159
.br