Struct ssh2::File [−][src]
pub struct File { /* fields omitted */ }
Expand description
A file handle to an SFTP connection.
Files behave similarly to std::old_io::File
in that they are readable and
writable and support operations like stat and seek.
Files are created through open
, create
, and open_mode
on an instance
of Sftp
.
Implementations
Set the metadata for this handle.
Reads a block of data from a handle and returns file entry information for the next entry, if any.
Note that this provides raw access to the readdir
function from
libssh2. This will return an error when there are no more files to
read, and files such as .
and ..
will be included in the return
values.
Also note that the return paths will not be absolute paths, they are the filenames of the files in this directory.
Trait Implementations
Pull some bytes from this source into the specified buffer, returning how many bytes were read. Read more
Like read
, except that it reads into a slice of buffers. Read more
can_vector
)Determines if this Read
er has an efficient read_vectored
implementation. Read more
read_initializer
)Determines if this Read
er can work with buffers of uninitialized
memory. Read more
Read all bytes until EOF in this source, placing them into buf
. Read more
Read all bytes until EOF in this source, appending them to buf
. Read more
Read the exact number of bytes required to fill buf
. Read more
Creates a “by reference” adapter for this instance of Read
. Read more
Creates an adapter which will chain this stream with another. Read more
Move the file handle’s internal pointer to an arbitrary location.
libssh2 implements file pointers as a localized concept to make file access appear more POSIX like. No packets are exchanged with the server during a seek operation. The localized file pointer is simply used as a convenience offset during read/write operations.
You MUST NOT seek during writing or reading a file with SFTP, as the internals use outstanding packets and changing the “file position” during transit will results in badness.
seek_stream_len
)Returns the length of this stream (in bytes). Read more
Write a buffer into this writer, returning how many bytes were written. Read more
Flush this output stream, ensuring that all intermediately buffered contents reach their destination. Read more
can_vector
)Determines if this Write
r has an efficient write_vectored
implementation. Read more
Attempts to write an entire buffer into this writer. Read more
write_all_vectored
)Attempts to write multiple buffers into this writer. Read more
Writes a formatted string into this writer, returning any error encountered. Read more