### lsh-1.2.2 README file

    LSH - a GNU implementation of the Secure Shell protocols.

    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.

    COPYRIGHT

    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.

    INSTALLATION

    If you have downloaded a release, you should be able to compile it
    with

       ./configure
       make

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

      bash configure

    If you want to hack lsh, you need some more tools: autoconf, automake,
    bash, gcc, gperf (at least version 2.7) and a scheme implementeation.
    The currently supported schemes are guile and scsh (at least version
    0.5.2). 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.

    If you have checked out lsh from CVS, things are more complicated. You
    must first generate Makefile.am files from the corresponding
    Makefile.am.in files. Do this by running ./make_am in the top level
    directory. Next, you need to run aclocal, autoconf, autoheader and
    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.

    NEEDED LIBRARIES

    GMP (cersion 2.0.2 or better) can be found at ftp.gnu.org, or some of
    its mirrors.

    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.

    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 -o 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

    For more information on using LSH, read the LSH manual, doc/lsh.info
    or doc/lsh.html.

    For an introduction to the inner workings of LSH, see the file
    doc/HACKING.

    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/>.

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