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

die_with_error( [message] )¶

Calls "die" with the given message and the error information from the object appended.

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.