1libssh2_sftp_seek64(3) libssh2 manual libssh2_sftp_seek64(3)
2
3
4
6 libssh2_sftp_seek64 - set the read/write position within a file
7
9 #include <libssh2.h>
10 #include <libssh2_sftp.h>
11
12 void libssh2_sftp_seek64(LIBSSH2_SFTP_HANDLE *handle,
13 libssh2_uint64_t offset);
14
16 handle - SFTP File Handle as returned by libssh2_sftp_open_ex(3)
17
18 offset - Number of bytes from the beginning of file to seek to.
19
20 Move the file handle's internal pointer to an arbitrary location. lib‐
21 ssh2 implements file pointers as a localized concept to make file
22 access appear more POSIX like. No packets are exchanged with the server
23 during a seek operation. The localized file pointer is simply used as a
24 convenience offset during read/write operations.
25
26 You MUST NOT seek during writing or reading a file with SFTP, as the
27 internals use outstanding packets and changing the "file position" dur‐
28 ing transit will results in badness.
29
31 Added in 1.0
32
34 libssh2_sftp_open_ex(3)
35
36
37
38libssh2 1.0 22 Dec 2008 libssh2_sftp_seek64(3)