README 2.73 KB
Newer Older
Niels Möller's avatar
Niels Möller committed
1
LSH - a GNU implementation of the Secure Shell protocols.
Niels Möller's avatar
Niels Möller committed
2 3


4 5 6
LSH IS A WORK IN PROGRESS. IT WILL NOT PROVIDE ANY SECURITY ON SYSTEMS
THAT LACK /dev/random. THERE MAY BE OTHER SERIOUS BUGS THAT MAKE IT
TOTALLY INSECURE.
Niels Möller's avatar
Niels Möller committed
7

8 9 10

COPYRIGHT

Niels Möller's avatar
Niels Möller committed
11 12 13 14
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation. See the file COPYING for details.

15 16 17

INSTALLATION

Niels Möller's avatar
Niels Möller committed
18 19 20 21 22 23
If you have downloaded a snapshot, you should be able to compile it
with

   ./configure
   make

24 25 26 27 28 29
You need GNU make. Some shells have had bugs preventing them from
executing the configure script; if you experience problems, try
running

  bash configure

30
If you want to hack lsh, you need some more tools: autoconf, automake,
31 32 33 34 35 36 37
bash, gcc, gperf (at least version 2.7) and a scheme implementeation.
The currently supported schemes are guile and scsh. All but scsh can
be found at your local GNU mirror site. scsh, Olin Shiver's Scheme
Shell, can be downloaded from <URL:
ftp://ftp-swiss.ai.mit.edu/pub/su/scsh/scsh.tar.gz>. If you use guile,
you also need the slib library, which is usually distributed
separately. It's also available at the GNU mirrors.
38

39
If you have checked out lsh from CVS, things are more complicated. You
40 41
must first generate Makefile.am files from the corresponding
Makefile.am.in files. Do this by running ./make_am in the top level
42
directory. Next, you need to run aclocal, autoconf, autoheader and
43 44 45 46 47
automake -a. This creates the configure script and a Makefile.in. Now
you can try ./configure ; make. If the compiler complains that it
can't find a file foo.h.x, try creating it with make foo.h.x, and
similarly for missing foo.c.x files. The misc/bootstrap.sh script
tries to do all this.
Niels Möller's avatar
Niels Möller committed
48

J.H.M. Dassen's avatar
J.H.M. Dassen committed
49 50 51 52

NEEDED LIBRARIES

GMP-2.0.2 can be found at ftp.gnu.org, or some of its mirrors.
53 54 55

ZLIB can be found at ftp://ftp.cdrom.com/pub/infozip/zlib/zlib.html or
http://www.cdrom.com/pub/infozip/zlib/. Latest version is zlib-1.1.3.
J.H.M. Dassen's avatar
J.H.M. Dassen committed
56

57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78

GETTING STARTED

Some examples...

Create a new DSS key pair, and save it in NEW_KEY and NEW_KEY.pub:

  ./lsh_keygen  -l 8 | ./lsh_writekey NEW_KEY

Start an lshd server on port 4711, using the key created above as the
server host key:

  ./lshd -p 4711 -h NEW_KEY

Connect to an lshd server running on port 4711 on HOST, and attempt to
log in as USER:

  ./lsh -p 4711 -l USER HOST


MORE INFORMATION

79 80
For an introduction to the inner workings of LSH, see the file
HACKING.
Niels Möller's avatar
Niels Möller committed
81 82 83 84 85 86 87 88 89 90 91

Several people have contributed to LSH, see the AUTHORS file for
details.

If you are interested in lsh, you may want to subscribe to the
psst-list. Subscription address is psst-request@net.lut.ac.uk.

Current snapshots of lsh can be found at
<URL: http://www.lysator.liu.se/~nisse/archive/>.


92
/Niels Möller <nisse@lysator.liu.se>