summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorMatt Johnston <matt@ucc.asn.au>2004-08-14 17:59:42 +0000
committerMatt Johnston <matt@ucc.asn.au>2004-08-14 17:59:42 +0000
commit9ab4bbc7ff4dbb894e91aa52dc9d17ab1d2a3218 (patch)
tree4e330dc10796cac1ffa258706a84da01307486ad
parent703c9a7370f856af030873562a89cccdb71fed8f (diff)
Some documentation touchups
--HG-- extra : convert_revision : d428137d689eb015db1bd4168614516eb7f29c41
-rw-r--r--README21
-rw-r--r--TODO4
-rw-r--r--debug.h2
3 files changed, 19 insertions, 8 deletions
diff --git a/README b/README
index 21b147e..5dc3a44 100644
--- a/README
+++ b/README
@@ -13,6 +13,8 @@ me if you have any questions/bugs found/features/ideas/comments etc :)
Matt Johnston
matt@ucc.asn.au
+
+In the absence of detailed documentation, some notes follow:
============================================================================
Public key auth:
@@ -28,6 +30,13 @@ user.
NOTE: Dropbear ignores authorized_keys options such as those described in the
OpenSSH sshd manpage, and will not allow a login for these keys.
+============================================================================
+
+If you want to get the public-key portion of a Dropbear private key, look at
+dropbearkey's '-y' option.
+
+============================================================================
+
To run the server, you need to generate server keys, this is one-off:
./dropbearkey -t rsa -f dropbear_rsa_host_key
./dropbearkey -t dss -f dropbear_dss_host_key
@@ -35,18 +44,16 @@ To run the server, you need to generate server keys, this is one-off:
or alternatively convert OpenSSH keys to Dropbear:
./dropbearconvert openssh dropbear /etc/ssh/ssh_host_dsa_key dropbear_dss_host_key
-And you can now run the server.
-./dropbear
-
-or './dropbear -h' to get options.
+============================================================================
If the server is run as non-root, you most likely won't be able to allocate a
pty, and you cannot login as any user other than that running the daemon
(obviously). Shadow passwords will also be unusable as non-root.
+============================================================================
+
The Dropbear distribution includes a standalone version of OpenSSH's scp
program. You can compile it with "make scp", you may want to change the path
of the ssh binary, specified near the top of the scp.c file. By default
-the progress meter isn't compiled in to save space, you can enable it with
-"make scp-progress".
-
+the progress meter isn't compiled in to save space, you can enable it by
+adding 'SCPPROGRESS=1' to the make commandline.
diff --git a/TODO b/TODO
index 4197284..5e67b18 100644
--- a/TODO
+++ b/TODO
@@ -23,3 +23,7 @@ Things which might need doing:
- Use m_burn for clearing sensitive items in LTM/LTC
- fix scp.c for IRIX
+
+- Be able to use OpenSSH keys for the client? or at least have some form of
+ encrypted keys.
+- Client agent forwarding
diff --git a/debug.h b/debug.h
index d619a58..3ae7ca5 100644
--- a/debug.h
+++ b/debug.h
@@ -36,7 +36,7 @@
/* Define this to print trace statements - very verbose */
/* Caution: Don't use this in an unfriendly environment (ie unfirewalled),
* since the printing does not sanitise strings etc */
-#define DEBUG_TRACE
+/* #define DEBUG_TRACE */
/* All functions writing to the cleartext payload buffer call
* CHECKCLEARTOWRITE() before writing. This is only really useful if you're