libssh2_sftp_seek64.3 (1034B)
1.TH libssh2_sftp_seek64 3 "22 Dec 2008" "libssh2" "libssh2" 2.SH NAME 3libssh2_sftp_seek64 - set the read/write position within a file 4.SH SYNOPSIS 5.nf 6#include <libssh2.h> 7#include <libssh2_sftp.h> 8 9void 10libssh2_sftp_seek64(LIBSSH2_SFTP_HANDLE *handle, 11 libssh2_uint64_t offset); 12.fi 13.SH DESCRIPTION 14\fIhandle\fP - SFTP File Handle as returned by 15.BR libssh2_sftp_open_ex(3) 16 17\fIoffset\fP - Number of bytes from the beginning of file to seek to. 18 19Move the file handle's internal pointer to an arbitrary location. libssh2 20implements file pointers as a localized concept to make file access appear 21more POSIX like. No packets are exchanged with the server during a seek 22operation. The localized file pointer is used as a convenience offset during 23read/write operations. 24 25You MUST NOT seek during writing or reading a file with SFTP, as the internals 26use outstanding packets and changing the "file position" during transit will 27results in badness. 28.SH AVAILABILITY 29Added in 1.0 30.SH SEE ALSO 31.BR libssh2_sftp_open_ex(3)