Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

net::ssh2::sftp(3pm) [debian man page]

Net::SSH2::SFTP(3pm)					User Contributed Perl Documentation				      Net::SSH2::SFTP(3pm)

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. perl v5.14.2 2011-05-06 Net::SSH2::SFTP(3pm)

Check Out this Related Man Page

Net::SSH2::Channel(3pm) 				User Contributed Perl Documentation				   Net::SSH2::Channel(3pm)

NAME
Net::SSH2::Channel - SSH 2 channel object DESCRIPTION
A channel object is created by the Net::SSH2 "channel" method. As well as being an object, it is also a tied filehandle. The Net::SSH2 "poll" method can be used to check for read/write availability and other conditions. setenv ( key, value ... ) Sets remote environment variables. Note that most implementations do not allow environment variables to be freely set. Pass in a list of keys and values with the values to set. Returns the number of successful sets. blocking ( flag ) Enable or disable blocking. Note that this is currently implemented in libssh2 by setting a per-session flag; it's equivalent to Net::SSH2::blocking. eof Returns true if the remote server sent an EOF. send_eof Send an EOF to the remote. After an EOF has been sent, no more data may be sent; the connection should be closed. close Close the channel (happens automatically on object destruction). wait_closed Wait for a remote close event. Must have already seen remote EOF. exit_status Returns the channel's program exit status. pty ( terminal [, modes [, width [, height ]]] ) Request a terminal on a channel. If provided, "width" and "height" are the width and height in characters (defaults to 80x24); if negative their absolute values specify width and height in pixels. pty_size ( width, height ) Request a terminal size change on a channel. "width" and "height" are the width and height in characters; if negative their absolute values specify width and height in pixels. process ( request, message ) Start a process on the channel. See also shell, exec, subsystem. shell Start a shell on the remote host; calls process("shell"). exec ( command ) Execute the command on the remote host; calls process("exec", command). Note that only one of these requests can succeed per channel (cp. "exec" in perlfunc); if you want to run a series of commands, consider using shell instead. subsystem ( name ) Run subsystem on the remote host; calls process("subsystem", command). ext_data ( mode ) Set extended data handling mode: normal (default) Keep data in separate channels; stderr is read separately. ignore Ignore all extended data. merge Merge into the regular channel. read ( buffer, size [, ext ] ) Attempts to read size bytes into the buffer. Returns number of bytes read, undef on failure. If ext is present and set, reads from the extended data channel (stderr). write ( buffer [, ext ] ) Attempts to write the buffer to the channel. Returns number of bytes written, undef on failure. If ext is present and set, writes to the extended data channel (stderr). flush ( [ ext ] ) Flushes the channel; if ext is present and set, flushes extended data channel. Returns number of bytes flushed, undef on error. exit_signal Returns the exit signal of the command executed on the channel. Requires libssh 1.2.8 or higher. 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. perl v5.14.2 2011-05-07 Net::SSH2::Channel(3pm)
Man Page