Net-SSH2-0.59_12

Changes for version 0.59_12 - 2016-04-26

WARNING: backward incompatible change: "READLINE" had an undocumented hard coded timeout of 250ms which made the method unreliable. That timeout has been removed. If desired, the old behaviour can be attained setting non-blocking mode or with a global timeout.
add Channel "readline" method.
add Channel "getc" method.
Cleanup of the channel tie interface.

Changes for version 0.59_11 - 2016-04-22

Add channel method "read2".
Do not retry read operations when "libssh2_channel_read_ex" returns 0 (bug report by Ferenc Erki).
Fix definitions for LIBSSH2_ERROR_NONE, LIBSSH2_SESSION_BLOCK_INBOUND and LIBSSH2_SESSION_BLOCK_OUTBOUND.
Scale timeout values passed between IO::Socket::* (using seconds) and libssh2 (using miliseconds).
Several documentation improvements.

Changes for version 0.59_10 - 2016-04-19

Don't warn when undef is passed to method "timeout".
Add more tests.
Several documentation improvements.

Changes for version 0.59_09 - 2016-04-18

Method "read" was not returning errors correctly.
Typemaps for 64bit integers were broken
Restrict the channel type to "session" in method "channel".
The realclean target of the generated Makefile was deleting const-c.inc and const-xs.inc which are not generated anymore.
Several documentation improvements.

Changes for version 0.59_08 - 2016-04-18

Get extended diagnosis messages when $ENV{AUTOMATED_TESTING} is set.

Changes for version 0.59_07 - 2016-04-17

In auth, do not call authentications methods unless they are supported by the server.
Fix minor scp_get issue
Add workaround for getpwuid not being available on MS Windows.
Several documentation fixes.

Changes for version 0.59_06 - 2016-04-17

Add method die_with_error into Net::SSH2::SFTP
Several documentation improvements.

Changes for version 0.59_05 - 2016-04-16

Switch the order of "policy" and "known_host_path" arguments in method "check_hostkey".
Improve "check_hostkey" method adding support for using a callback as policy.
Rename "remote_port" to "port", "remote_hostname" to "hostname" and "check_remote_hostkey" to "check_hostkey".
Rewrite constant generation code
Several documentation improvements.

Changes for version 0.59_04 - 2016-04-13

Use libssh2 function "libssh2_scp_send64" when available. It allows sending files bigger than 4GB.
Improve the way the user is prompted.
Improve "check_remote_hostkey" method (WIP).
Add scat.pl sample script
Several documentation improvements.
Remove File::Slurp dependency in test script.

Changes for version 0.59_03 - 2016-04-12

Fix Channel "read" method that was hanging in blocking mode.
Add "check_remote_hostkey" method for easy remote host key verification (WIP)
Add "die_with_error" method.
Several documentation improvements.

Changes for version 0.59_02 - 2016-04-12

Fix "auth_list" method.
Fix handling of "lib" argument in Makefile.PL.
Compilation was broken for perls 5.8.0 .. 5.8.3.
Several documentation improvements.

Changes for version 0.59_01 - 2016-04-11

WARNING: this release includes lots of changes, some visible, most internal. Regressions are expected. Also, it introduces some minor backward incompatible changes - but in those cases, the old behavior was broken or insane anyway.
libssh2 version 1.7.0 is now recommended. The module would still compile against older versions, but not all its features will be available.
Makefile.PL has been refactored and improved. Now it is better able to find the library libssh2 and compile code using it.
Lots of XS code refactoring has been performed in order to simplify the module internals. Specifically, now typemaps are used extensively to convert between C and Perl types. Also, some complex non-performance-critical functions have been moved to the Perl side or broken in a high level Perl wrapper and a low level simpler C wrapper.
KnownHost methods now return undef on error instead of die'ing. Note that this submodule is still marked as experimental.
Die when data containing wide characters is passed (i.e. outside the latin1 range). In previous versions, methods on this module would happily accept strings internally encoded as latin1 or utf8 and pass then along untouched, resulting in unreliable behavior.
In 32bit perls, return offsets and file sizes as NVs when required to avoid overflow.
Method "new" now also accepts the options "compress" and "sigpipe".
Passing options to "connect" is now deprecated.
Passing a file descriptor number to "connect" is not supported anymore (it was already broken).
Method "connect" consistently returns undef on error. The error code can be retrieved calling the "error" method (requires libssh2 1.7.0). In previous versions, some errors made the method die.
Timeouts are handled correctly inside "connect".
Report EAGAIN in the same way as any other error. This introduces a minor backward incompatibility, but the old behavior was utterly insane and undocumented, and so probably, nobody was using it right anyway!
Use libssh2_session_set_last_error function for storage of the Perl level errors (required libssh2 1.7.0). This may introduce some minor backward incompatibilities, but the old code was broken and unreliable anyway.