Revision history for Net::SFTP::Foreign

1.65 May 17, 2011

• die_on_error was broken

1.64 May 09, 2011

• release as stable
• document the write_delay and read_ahead options
• minor doc corrections

1.63_10 Apr 13, 2011

• workaround bug in perl 5.6 calling STORE in a tied filehandle
• solve "not enough arguments for grep" when using an old version of Scalar::Util

1.63_09 Apr 12, 2011

• an error in the handler accessors was adding and useless wrapping layer

1.63_08 Jan 22, 2011

• bad method call inside mkpath corrected (bug report and solution by Adam Pingel)

1.63_07 Jan 20, 2011

• do not override PreferredAuthentication when explicitly set by the user (bug report and solution by Ave Wrigley)

1.63_06 Dec 10, 2010

• redirect_stderr_to_tty was redirecting to the wrong side of the tty (bug report by Russ Brewer)

1.63_05 Dec 6, 2010

• add support for hardlink@openssh.com extension
• add die_on_error method
• create a new process group for slave ssh process so that signals sent from the terminal are not propagated
• better error messages

1.63_04 Nov 11, 2010

• workaround for IPC::Open3::open3 not working with tied file handles on Windows (bug report by Barnabas Bona)
• several spelling corrections (contributed by Philippe Bruhat)

1.63_03 Nov 10, 2010

• On some OSs (i.e. AIX) reading/writing from non-blocking fds can result in EAGAIN even when select has indicated that data was available (bug report and patch by Bill Godfrey)

1.63_02 Nov 2, 2010

• Windows backend was not pipelining requests when called from put method

1.63_01

• support for Tectia client added (bug report by Russ Brewer)

1.62 Oct 5, 2010

• catchtainted_args was not being imported from helpers (bug report by rfbits at PerlMonks)

1.61 Sep 22, 2010

• remove some dead code introducing unneded constraints that cause the Net::SSH2 backend to fail (bug report by Philippe Vouters)

1.60 Sep 20, 2010

• ensurelist was not being imported from Helpers (bug report and solution by Jean-Benoît Baudens)

1.59 Sep 16, 2010

• kill ssh subprocess with KILL signal on Windows

1.58_08 Aug 22, 2010

• import _hexdump from Helpers.pm (bug report by Chuck Kozak)
• call kill passing the signal name instead of using POSIX to get its number

1.58_07 Aug 2, 2010

• dump $! on failed sysreads and syswrites

1.58_06 Jul 12, 2010

• rput was broken under Windows (bug report by Brian E. Lozier)
• do not use Fcntl S_IS* macro wrappers as S_ISLNK is not available under Windows
• new FAQ about put failing because of forbidden setstat
• minor doc improvements
• use "kill $name" instead of using POSIX to get the signal number

1.58_05 Jun 7, 2010

• add support for stderr_discard also in Windows backend

1.58_04 Jun 7, 2010

• add support for stderr_discard

1.58_03 May 27, 2010

• even more debugging for put method and the resume feature

1.58_02

• add FAQ about strict host key checking
• better debugging for put method

1.58_01 Apr 19, 2010

• add stderr redirection feature
• minor doc corrections
• add donating to OpenSSH entry in docs

1.57 Mar 14, 2010

• release as stable

1.56_09 Mar 11, 2010

• realpath feature was broken on find and ls methods (bug report by Paul Kolano)
• taint checks on hashes were not reporting problems properly
• minor doc corrections

1.56_08 Jan 5, 2010

• put'ting a tied file handle was generating some warnings (bug report and patch by Gavin Carr)

1.56_07 Dec 29, 2009

• new methods added: mget, mput, get_symlink, put_symlink
• new numbered feature
• some minor bugs corrected
• glob can now also be used from Net::SFTP::Foreign::Local
• some doc corrections and improvements
• callon_error was not cleaning up under some conditions

1.56_06 Dec 14, 2009

• mkpath was broken, rewritten to not use the obsolete normalizepath method (bug report by Peter Edwards).
• add some tests for mkpath
• introduce internal clearerror_and_status method
• completely remove normalizepath
• correct bug in _debug not printing sub name under some conditions

1.56_05 Dec 9, 2009

• add support for plugable backends ***THIS IS A MAYOR INTERNAL CHANGE THAT COULD INTRODUCE NEW BUGS***

1.56_04 Dec 8, 2009

• remote file path joining sub rewritten (note: this could change the module behaviour in some corner cases)
• new test file with path join operations
• rput('.',...) was failing due to bad path joining for local filesystem (bug report by Aaron Paetznick).
• accept keyboard-interactive authentication
• some docs reorganization
• add pointer to my wish list :-)

1.56_03 Nov 14, 2009

• use SIGTERM to kill children also on Windows
• workaround Cygwin bug, fopen(..., a); ftell() does not return the size of the file

1.56_01 Oct 26, 2009

• pass PreferredAuthentication option to SSH process to force password authentication (bug and solution by Stewart Heckenberg)
• use SIGTERM instead of SIGHUP to kill slave SSH process

1.55 Sep 9, 2009

• re-release as stable

1.54_03 Sep 4, 2009

• add debugging to _rel2abs

1.54_02 Aug 19, 2009

• add extra sanity check to setcwd method. It seems that some servers do not report an error when realpath is called on an inexistent file (bug report by Ben Szulc)
• password authentication broken in AIX
• some documentation corrections
• more tests added

1.54_01 Jul 22, 2009

• yet another "Password not requested as expected" bug solved, $pty->close_slave was being called too soon (bug report by Tim Rayner)

1.53 Jul 6, 2009

• re-released as stable

1.52_12 Jul 2, 2009

• also if using password authentication, detect when the remote host key doesn't match the key stored in know_hosts and abort the connection (bug report by Ryan Niebur).
• if using password authentication, detect when the target host key has not been accepted yet (bug report by Ryan Niebur)
• work around for IPC::Open3 feature missing in old versions of that module that caused password authentication to fail under 5.6.x perls (bug report by Vetrivel).
• find method would not follow links passed as arguments to the method or others found when ordered mode was selected (bug report by Paul Kolano)
• detect bad passwords and other password authentication improvements
• sample scripts added
• atomic_rename was returning the wrong error code/string
• Perl 5.11 changes the EOF call interface for tied file handles
• attributes flags slot was incorrectly set on new_from_buffer
• get/put_int64 optimization
• add calling function name to debug output
• add debug hexdumps for sysreads and syswrites
• optimize some common ls usages to reduce CPU utilization
• implement pipelining for ls command
• ls bug, wanted was being called with the wrong arguments
• add timestamps to debugging output
• ensure that attribute arguments are of class Net::SFTP::Foreign::Attributes (feature request by Todd Rinaldo)
• put_attributes was broken
• move _hexdump to Helpers package
• debug subsystem cleanup

1.51 Apr 7, 2009

• "get" corrupted the fetched files if $\ was non empty (bug report and solution by Dagfinn Ilmari Mannsaker)
• increment default packet and queue size

1.50 Mar 18, 2009

• rel2abs was not collapsing duplicated slashes when joining paths, generating paths as '//home' that have an unexpected meaning under Windows (bug report and solution by Erik Weidel)

1.49 Mar 17, 2009

• use utf8::downgrade to handle data with may have its utf8 flag set (bug report by Jamie Lahowetz, solution by ikegami)
• emulate SSH2_FXF_APPEND mode not supported by OpenSSH SFTP server
• open flags documented
• minor documentation corrections
• follow_links option from find method was broken (bug report by Paul Kolano)
• spurious debugging message removed from statvfs
• put and get now accept a file handle instead of a file name for the local file (feature request by David Morel)
• add support for append option in put and get
• put and get documentation reorganized
• improve write caching behavior, 'writedelay' is used to control the write buffer size (feature request by David Morel)

1.47 Feb 13, 2009

• add support for per object dirty cleanup flag required by proper Net::OpenSSH integration
• add support for old SSH1

1.46 Dec 18, 2008

• release as stable version
• improve synopsis documentation
• commercial support offering note added

1.45 Nov 11, 2008

• reduce localized scope for $SIG{__DIE__} and $@ (bug report by David Serrano and David Riosalido)
• workaround incomplete unicode support in perl 5.6.x
• new FAQ entry about how to completely disable passwd authentication
• add support for OpenSSH protocol extensions statvfs, fstatvfs and posix-rename.
• add overwrite feature to rename method
• new fs_encoding feature added ***this is a mayor internal change that could introduce new bugs***
• when parsing status msgs, the string was not being converted to utf8
• croak when utf8 data is written to remote files in any way.
• binmode ssh_in and ssh_out
• some minor documentation corrections
• add support for mkpath (feature requested by Mark Murphy)
• add support for late_set_attr (bug report by Oliver Dunbar)
• add support for extended file attributes (bug report by Oliver Dunbar)
• add support for the autodisconnect feature (bug report by Jared Watkins).
• add support for multiprocess debugging

1.44 Oct 9, 2008

• put was using block sizes 4 times bigger than requested, bug introduced in 1.41 (reported by Hussain Syed).

1.43 Sep 8, 2008

• readline was slurping the full file contents (bug report by Sylvain Cousineau).

1.42 Jul 17, 2008

• experimental support for resuming file transfers
• some typos fixed
• TODO added

1.41 Jul 16, 2008

• add support for on the fly data conversions including dos2unix and unix2dos
• copy_perm => 0 was being ignored in several methods (bug report by Dave Tauzell)

1.40 Jun 24, 2008

• work around for servers that do not include the mandatory error message on SSH_FXP_STATUS responses (bug report by Hugh Lampert).

1.39 Jun 23, 2008

• suppress warning on mod_perl environments (bug and solution reported by Eric Rybski).

1.38 May 20, 2008

• add experimental support for plink command
• on get, don't change file size passed to callback
• on get, survive stat failure for servers with stat/readdir disabled (bug reported by Hussain Syed)
• default open mode set to read
• add support for block_size and queue_size constructor arguments
• limit usage of Expect and PTYs to authentication phase (bug reported by Tom Warkentin)
• honour copy_perm option in put method (bug report by Bruce Harold)
• copy_perms option renamed to copy_perm for consistency (copy_perms still supported)
• glob optimization
• typo in Net::SFTP::Foreign::Common::seterrno was not setting $! correctly (bug report by Rafael Kitover)
• add debugging support to doio and set(status|error)

1.36 Apr 18, 2008

• forbid usage of Net::SFTP::Foreign methods from Compat module (bug reported by Fred Zellinger)
• document the password and passphrase constructor options.

1.35 Feb 8, 2008

• put method was failing for binary files under Windows because binmode was not set on the local filehandler (bug report and patch by Patrick Frazer).

1.34 Jan 8, 2008

• document rput. It said it was not implemented (bug report by Paul Kolano).
• put method was failing for binary files under Windows because binmode was not set on the local filehandler (bug report and patch by Patrick Frazer).

1.33 Jan 6, 2008

• rremove was not removing dirs (bug report by Paul Kolano).
• require perl >= 5.6
• add support for open/close and DESTROY debugging

1.32 Dec 8, 2007

• add new question to FAQ
• document password and passphrase options (though, not completely).
• somo minor documentation changes
• on testing look for sftp-server on libexec dirs
• and delete temporal files

1.31 Oct 8, 2007

• remove Win32::Socketpair loading, it is not used anymore
• improve debugging
• do not croak when invalid data from the other side appears

1.30 Aug 23, 2007

• add support for realpath option to ls method
• add support for realpath and names_only to glob method
• improve setstatus and seterror methods
• add support for password authentication and for keys with passphrases

1.29 Aug 14, 2007

• add support for names_only option to ls and find methods
• make ls and find methods default to '.'
• DESTROY was also messing with $? and $! values (bug reported by Dave Haywood)
• better usage checking for several methods
• add support for cwd (experimental)
• symlink docs corrected
• several other doc corrections

1.28

• argument checking in rename was wrong (reported by Greg Howard)
• disable DIE custom handlers when using eval

1.27 Jul 7, 2007

• catch insecure $ENV{PATH} under taint mode (bug reported by jmarshll).

1.26 Jul 5, 2007

• my email was missing from the docs
• make it work under taint checking (experimental feature).
• work around bug in dualvar under taint checking

1.25 Jun 19, 2007

• remove some obsolete tests not working on 5.9.x

1.24 Jun 18, 2007

• DESTROY was messing up $@ (bug reported by Kai Grossjohann)
• set $SIG{PIPE} handler inside doio to catch IO errors
• don't execute external command when transport option is used on constructor

1.23 May 23, 2007

• release as stable!
• some doc improvements

0.90_22 Apr 29, 2007

• experimental Windows support added

0.90_21 Apr 25, 2007

• some documentation improvements
• check that ctor 'more' arguments are not joined
• eliminate "Password" prompt on passwd_auth sample (solution suggested by Fletch on PerlMonks)

0.90_20 Apr 20, 2007

• add support for "transport" options on the constructor that allows to use password authentication and keys protected by a passphrase
• add password authentication sample

0.90_19 Apr 5, 2007

• add abort method (feature requested by Jamie Lahowetz)

0.90_18 Mar 23, 2007

• fallback to dirty cleanup if ssh process doesn't exit cleanly in 8 seconds (bug reported by Brandon Schendel).

0.90_17 Mar 21, 2007

• add support for dont_save flag in get method, required for Compat module (bug reported by Jamie Lahowetz).

0.90_16 Mar 18, 2007

• new tests added
• mkdir, rmdir, remove, setstat, fsetstat and _close methods argument parsing was wrong (bug #25101 reported by funkonaut)
• wrong detection of Sort::Key corrected
• debug mode was broken
• network errors do not die anymore, documented

0.90_15 Dec 19 2006

• messages were not being queued on get method and so, performance was very bad (reported by "sched" via Perlmonks).
• Auto reduce block size on get method.

0.90_14 Nov 8 2006

• FAQ section added on the module documentation
• Net::SFTP supplant was not working, corrected

0.90_13 Sep 22 2006

• fchmod is not available everywhere, don't use it (bug and solution reported by Andre Tomt).

0.90_12 Aug 21 2006

• syntax error on Net::SFTP::Foreign::Compat corrected (reported by Hans Schligtenhorst).
• supplant was misspelled
• correct some dependency problems on Compat.
• add test for Compat.

0.90_11 Jun 30 2006

• don't croak from connect on runtime errors
• workaround bug in IPC::Open3 that leaves two processes running

0.90_10 May 17 2006

• 0 is a valid sftp handler.

0.90_09 Apr 25 2006

• bug on doio method corrected

0.90_08 Apr 24 2006

• bug for copy_perms => 0 corrected (reported by Erik Johansen).
• usage checks added to most commands.

0.90_07 Apr 23 2006

• don't use pack for quads on little-endian systems (bug reported by Mogens Hafsjold)

0.90_06 Feb 24 2006

• implement rput
• use Win32::Socketpair on Windows
• implement API for local fs in Local
• move common functions to Common and Helpers packages

0.90_05 Feb 23 2006

• convert remote file handle strings to tied file handles
• most methods changed to mimic perl buil-ins
• attach file position to file handles.

0.90_04 Feb 22 2006

• remove bug in get that could left remote file handles open
• new methods readlink, symlink, rremove, rget.

0.90_03 Feb 21 2006

• minor corrections to the docs
• new methods glob and join implemented.

0.90_02 Feb 20 2006

• added new method find
• ls method expanded with callback
• contructor rewritten
• better docs for Constants package
• Compat module updated
• several corrections on the docs

0.90_01 Feb 16 2006

• almost full rewrite exposing new much improved and incompatible API!!!

0.57 Nov 29 2005

• check sysread return value when reading from pipe (bug report and patch submited by Mina Naguib).

0.56 Nov 14 2005

• correct bug on open2_cmd option

0.55 Oct 24 2005

• kill ssh process when done (bug reported by Alf Carlsson).

0.54 Sep 07 2005

• add support for transferring files bigger than 4GB

0.53 May 03 2005

• link to SFTP draft actualised

0.52 May 03 2005

• some typos corrected on the docs.

0.51 May 03 2005

• Net::SFTP::Foreign::Buffer reimplemented from scratch. It doesn't depend on Net::SSH::Perl::Buffer anymore.
• use foreign 'ssh' to open connections.

0.50 May 02 2005

• Net::SFTP::Foreign FORKED !!!

0.09 2005.01.16

• New co-maintainer, David Robins (DBROBINS).
• Adds a 'warn' argument to the constructor to allow supression or redirection of warnings.
• Allows the 'ssh_args' constructor argument to be either a hash ref or an array ref.
• Adds a 'status' method which returns the last SSH2_FX_* status value, or (status value, text) in list context (only useful after last failure).
• Adds brief summary comments to some methods.
  • Returns failure if the remote open fails for 'get' (previous code ignored it); also moves the remote open before the local open so that we don't create empty local files if the remote file can't be opened.
  • Changes 'ls' to return an array reference in scalar context.
  • Documents: the fact that we die on protocol/local errors; the new option and method; changes to 'get'/'put' (formerly 'put' didn't return anything useful, and 'get's actual return values are the same, just better documented).
  • Adds a comprehensive remote test, but to use it one has to manually go in and configure a server a certain way, so it defaults to skipping everything; I'm including it as a base since there are currently no remote tests at all.

0.08 2003.12.12

• Net::SFTP::Buffer was passing an invalid option when loading Net::SSH::Perl::Buffer.
• Add SUPPORT section to the docs.

0.07 2003.11.14

• Require Net::SSH::Perl 1.24, which also includes circular reference fixes.

0.06 2003.11.14

• New maintainer, Dave Rolsky.
• Fixed a circular reference which caused connections to be held open indefinitely in a persistent environment like mod_perl. This uses weak references, so Perl 5.6.0+ is now required. This work was funded by Kineticode, Inc.
• Added a LICENSE file.

0.05 2001.05.24

• Added help ('h' or '?') command to psftp. Moved all shell functionality into Net::SFTP::Shell.
• Net::SFTP::Util needed to 'use Exporter'.

0.04 2001.05.16

• Fixed bug in put method when running fsetstat command; it was trying to set the UID/GID on the remote file, which was giving a permission denied message. Should not try to set UID/GID, so had to adjust flags.
• Added eg/psftp, a working SFTP shell.
• Moved READ and WRITE commands into their own methods (do_read and do_write, respectively).
• Changed semantics of get method. Returning the contents of the remote file is no longer connected to whether a local file is passed as an argument; it is instead based on the calling context of 'get'. Updated docs to reflect this.

0.03 2001.05.15

• Documentation for all extra classes: Attributes, Buffer, Constants, and Util.
• Documentation for command methods in Net::SFTP.
• Added binmode when reading/writing from local files.
• Added methods for all remaining commands in SFTP protocol version 3 (eg. remove, rmdir, mkdir, realpath, etc.).
• Added callbacks to get and put, eg. for status messages, etc.
• Fixed typo in Net::SFTP::Buffer::get_int64 that was breaking reading 64-bit ints.

0.02 2001.05.14

• Fixed bug with SSH2 server not sending one message per packet, ie. multiple packets have to be retrieved to make up one SFTP message. This would show up as a "Message length too long" error. Thanks to Matt Good for the spot.
• Fixed bug with OpenSSH and SSH2 SFTP servers where after a certain amount of bytes the connection would hang. This was a bug in Net::SSH::Perl (channel window sizes) that is fixed in version 1.13.

0.01 2001.05.13

• original version; created by h2xs 1.19