generic-library/ssh2

Go to file

Daniel Stenberg 7899d28ecb sftp_write: handle "left over" acked data The SFTP handle struct now buffers number of acked bytes that haven't yet been returned. The way this is used is as following: 1. sftp_write() gets called with a buffer of let say size 32000. We split 32000 into 8 smaller packets and send them off one by one. One of them gets acked before the function returns so 4000 is returned. 2. sftp_write() gets called again a short while after the previous one, now with a much smaller size passed in to the function. Lets say 8000. In the mean-time, all of the remaining packets from the previous call have been acked (7*4000 = 28000). This function then returns 8000 as all data passed in are already sent and it can't return any more than what it got passed in. But we have 28000 bytes acked. We now store the remaining 20000 in the handle->u.file.acked struct field to add up in the next call. 3. sftp_write() gets called again, and now there's a backlogged 20000 bytes to return as fine and that will get skipped from the beginning of the buffer that is passed in.		2010-11-11 11:57:35 +01:00
docs	LIBSSH2_CALLBACK_MACERROR: clarify return code use	2010-11-10 14:41:56 +01:00
example	SCP: on failure, show the numerical error reason	2010-11-10 17:26:38 +01:00
include	compress: compression disabled by default	2010-10-22 13:37:13 +02:00
m4	Ignore libssh2_config.h.in and stamp-h2 in example/ and remove .cvsignore	2010-01-30 00:25:46 +01:00
nw	Added copyright define to libssh2.h and use it for binary builds.	2010-08-15 04:09:01 +02:00
src	sftp_write: handle "left over" acked data	2010-11-11 11:57:35 +01:00
tests	make it C90 compliant	2010-04-12 22:09:38 +02:00
vms	VMS specific: make sure final release can be installed over daily build	2010-05-22 11:06:08 +01:00
win32	Fixed Win32 makefile which was now broken at resource build.	2010-08-18 17:22:33 +02:00
.gitattribute	Ensure that win32/libssh2.dsp will be generated with CRLF line endings	2009-10-17 02:58:53 +02:00
.gitignore	ignore TAGS ("make tags" makes them)	2010-03-24 15:38:44 +01:00
acinclude.m4	Fix shell usage.	2009-09-23 09:39:47 +02:00
AUTHORS	added contributors from the 1.2 release notes	2009-08-11 10:11:11 +02:00
buildconf	Make it portable; test uses = for string comparison (not ==). Indent.	2010-02-23 15:27:18 +01:00
config.rpath	Use Bruno's M4 macros to search for libgcrypt.	2007-04-05 10:23:54 +00:00
configure.ac	Fix OpenSSL AES-128-CTR detection.	2010-04-14 14:04:45 +02:00
COPYING	Add re-discovered copyright holders to COPYING	2010-05-05 15:45:17 +07:00
get_ver.awk	Added copyright define to libssh2.h and use it for binary builds.	2010-08-15 04:09:01 +02:00
HACKING	Mention libssh2-style.el.	2009-10-29 10:39:15 +01:00
libssh2-style.el	helper script for emacs users to get the code style done libssh2-style	2008-12-20 12:36:50 +00:00
libssh2.pc.in	first take at producing and installing a pkg-config file	2009-09-01 09:55:25 +02:00
Makefile.am	New files should also be added to Makefile.am.	2010-08-18 14:59:03 +02:00
Makefile.inc	dist: include sftp.h in dist archives	2010-10-27 14:51:25 +02:00
maketgz	Added LIBSSH2_TIMESTAMP to the public header and it contains the timestamp of	2007-07-15 21:36:29 +00:00
NEWS	Mention libssh2_channel_get_exit_signal and give kudos.	2010-10-13 15:33:13 +02:00
NMakefile	Move examples from example/simple to example/.	2009-12-19 10:56:03 +01:00
README	Update mailing list URL to new address	2009-07-10 20:11:29 +02:00
RELEASE-NOTES	release: updated to hold 1.2.7 info	2010-08-17 23:10:54 +02:00
TODO	TODO: implemented a lot of the ideas now	2010-10-24 23:38:26 +02:00

README

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

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

Web site: http://www.libssh2.org/

Mailing list: http://cool.haxx.se/mailman/listinfo/libssh2-devel

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
  	* --without-libgcrypt
	* --with-libgcrypt-prefix=DIR

		libssh2 can use the Libgcrypt library
		(http://www.gnupg.org/) for cryptographic operations.
		Either Libgcrypt or OpenSSL is required.

		Configure will attempt to locate Libgcrypt
		automatically.

 		If your installation of Libgcrypt is in another
		location, specify it using --with-libgcrypt-prefix.

	* --with-openssl
	* --without-openssl
	* --with-libssl-prefix=[DIR]

		libssh2 can use the OpenSSL library
		(http://www.openssl.org) for cryptographic operations.
		Either Libgcrypt or OpenSSL is required.

		Configure will attempt to locate OpenSSL in the
		default location.

		If your installation of OpenSSL is in another
		location, specify it using --with-libssl-prefix.

	* --with-libz
	* --without-libz
	* --with-libz-prefix=[DIR]

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

		If your installation of Libz is in another location,
		specify it using --with-libz-prefix.

	* --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).