1libssh2_sftp_seek64(3) libssh2 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
13 libssh2_sftp_seek64(LIBSSH2_SFTP_HANDLE *handle,
14 libssh2_uint64_t offset);
15
17 handle - SFTP File Handle as returned by libssh2_sftp_open_ex(3)
18
19 offset - Number of bytes from the beginning of file to seek to.
20
21 Move the file handle's internal pointer to an arbitrary location. lib‐
22 ssh2 implements file pointers as a localized concept to make file ac‐
23 cess appear more POSIX like. No packets are exchanged with the server
24 during a seek operation. The localized file pointer is used as a conve‐
25 nience offset during read/write operations.
26
27 You MUST NOT seek during writing or reading a file with SFTP, as the
28 internals use outstanding packets and changing the "file position" dur‐
29 ing transit will results in badness.
30
32 Added in 1.0
33
35 libssh2_sftp_open_ex(3)
36
37
38
39libssh2 22 Dec 2008 libssh2_sftp_seek64(3)