Go to file
2007-04-21 21:26:54 +00:00
docs Document libssh2_sftp_readdir() and libssh2_sftp_readdirnb() 2007-04-21 18:07:17 +00:00
example Create a simple test for sftp readdir with non-blocking 2007-04-21 18:08:00 +00:00
include Non-blocking work 2007-04-21 18:16:23 +00:00
m4 Use Bruno's M4 macros to search for libgcrypt. 2007-04-05 10:23:54 +00:00
nw some more makefile fixes. 2007-04-21 21:26:54 +00:00
src Non-blocking work 2007-04-21 18:16:23 +00:00
tests Remove -no-install since it breaks Darwin builds (probably a libtool 2007-03-27 15:35:37 +00:00
win32 some more makefile fixes. 2007-04-21 21:26:54 +00:00
.cvsignore *** empty log message *** 2007-04-05 10:21:09 +00:00
.cvsusers Add. 2007-04-13 06:09:12 +00:00
acinclude.m4 setting sockets non-blocking using more portable code and configure macros 2007-02-07 21:39:17 +00:00
AUTHORS Add. 2007-03-27 12:28:18 +00:00
buildconf --copy added to automake --add-missing to avoid symlinks in bootstrapped CVS snapshot tarballs 2007-01-03 09:56:31 +00:00
ChangeLog Generated. 2007-03-27 13:33:18 +00:00
config.rpath Use Bruno's M4 macros to search for libgcrypt. 2007-04-05 10:23:54 +00:00
configure.in check for sys/time.h 2007-04-12 22:00:55 +00:00
COPYING Add, from LICENSE. 2007-03-27 12:24:35 +00:00
get_ver.awk Netware and Windows fixes by Guenter Knauf 2007-02-07 21:21:06 +00:00
Makefile.am Make ChangeLog a phony target. 2007-04-13 06:06:15 +00:00
NEWS Made some function parameters in the API const. This is an API change, 2007-04-18 18:51:03 +00:00
NMakefile Add support for win32. 2005-01-03 22:46:15 +00:00
README added --enable-debug 2007-04-12 21:40:22 +00:00

libssh2 - SSH2 library
======================

libssh2 is a library implementing the SSH2 protocol, available under
the revised BSD license.

Generic installation instructions are in INSTALL.  Some ./configure
options deserve additional comments:

	* --enable-crypt-none

		The SSH2 Transport allows for unencrypted data
		transmission using the "none" cipher.  Because this is
		such a huge security hole, it is typically disabled on
		SSH2 implementations and is disabled in libssh2 by
		default as well.

		Enabling this option will allow for "none" as a
		negotiable method, however it still requires that the
		method be advertized by the remote end and that no
		more-preferable methods are available.

	* --enable-mac-none

		The SSH2 Transport also allows implementations to
		forego a message authentication code.  While this is
		less of a security risk than using a "none" cipher, it
		is still not recommended as disabling MAC hashes
		removes a layer of security.

		Enabling this option will allow for "none" as a
		negotiable method, however it still requires that the
		method be advertized by the remote end and that no
		more-preferable methods are available.

	* --disable-gex-new

		The diffie-hellman-group-exchange-sha1 (dh-gex) key
		exchange method originally defined an exchange
		negotiation using packet type 30 to request a
		generation pair based on a single target value.  Later
		refinement of dh-gex provided for range and target
		values.  By default libssh2 will use the newer range
		method.

		If you experience trouble connecting to an old SSH
		server using dh-gex, try this option to fallback on
		the older more reliable method.

  	* --with-libgcrypt
	* --with-libgcrypt-prefix=DIR

		libssh2 can use the Libgcrypt library
		(http://www.gnupg.org/) for cryptographic operations.

		Configure will attempt to locate Libgcrypt in the
		default location, but if you have installed it
		somewhere else, use the --with-libgrypt-prefix=DIR
		parameter.

	* --with-openssl=[DIR]

		libssh2 can use the OpenSSL library
		(http://www.openssl.org) for cryptographic operations.

		Configure will attempt to locate OpenSSL in a number
		of default locations:

			/usr/local/ssl
			/usr/local
			/usr
			/usr/local/openssl

		If your installation of OpenSSL is in another
		location, specify it here.

	* --with-libz=[DIR]

		If present, libssh2 will attempt to use the zlib (http://www.zlib.org)
		for payload compression, however zlib is not required.

		Configure will attempt to location a zlib installation
		in a number of default locations:

			/usr/local
			/usr
			/usr/local/libz
			/usr/libz
			/usr/local/zlib
			/usr/zlib

		If your installation of zlib is in another location,
		you may specify it here.

	* --enable-debug

		Will make the build use more pedantic and strict compiler
		options as well as enable the libssh2_trace() function (for
		showing debug traces).