NAME

       Net::SSH2::SFTP - SSH 2 Secure FTP object

DESCRIPTION

       An SFTP object is created by the Net::SSH2 "sftp" method.

   error
       Returns the last SFTP error (one of the LIBSSH2_FX_* constants).  Use this when Net::SSH2::error returns
       LIBSSH2_ERROR_SFTP_PROTOCOL.  In list context, returns (code, error name).

   open ( file [, flags [, mode ]]] )
       Open or create a file on the remote host.  The flags are the standard O_RDONLY, O_WRONLY, O_RDWR,
       O_APPEND, O_CREAT, O_TRUNC, and O_EXCL, which may be combined as usual.  Flags default to O_RDONLY and
       mode to 0666 (create only).  Returns a Net::SSH2::File object on success.

   opendir ( dir )
       Open a directory on the remote host; returns a Net::SSH2::Dir object on success.

   unlink ( file )
       Delete the remote file.

   rename ( old, new [, flags ] )
       Rename old to new.  Flags are taken from LIBSSH2_SFTP_RENAME_*, and may be combined; the default is to
       use all (overwrite, atomic, native).

   mkdir ( path [, mode ] )
       Create directory; mode defaults to 0777.

   rmdir ( path )
       Remove directory.

   stat ( path [, follow ] )
       Get file attributes for the given path.  If follow is set (default), will follow symbolic links.  On
       success, returns a hash containing the following:

       mode
       size
       uid
       gid
       atime
       mtime

   setstat ( path, key, value... )
       Set file attributes for given path; keys are the same as those returned by stat; note that it's not
       necessary to pass them all.

   symlink ( path, target [, type ] )
       Create a symbolic link to a given target.

   readlink ( path )
       Return the target of the given link, undef on failure.

   realpath ( path )
       Resolve a filename's path; returns the resolved path, or undef on error.

SEE ALSO

       Net::SSH2.

AUTHOR

       David B. Robins, <dbrobins@cpan.org>

COPYRIGHT AND LICENSE

       Copyright (C) 2005, 2006 by David B. Robins; all rights reserved.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl
       itself, either Perl version 5.8.0 or, at your option, any later version of Perl 5 you may have available.