.\" $Id: libssh2_sftp_tell.3,v 1.1 2007/06/14 16:33:38 jehousley Exp $
.\"
.TH libssh2_sftp_tell 3 "1 Jun 2007" "libssh2 0.15" "libssh2 manual"
.SH NAME
libssh2_sftp_tell - get the current read/write position indicator for a file
.SH SYNOPSIS
#include <libssh2.h>
#include <libssh2_sftp.h>

size_t 
libssh2_sftp_tell(LIBSSH2_SFTP_HANDLE *handle);

.SH DESCRIPTION
\fIhandle\fP - SFTP File Handle as returned by 
.BR libssh2_sftp_open(3)

Identify the current offset of the file handle's internal pointer. Note 
that the SSH2 protocol does not have a notion of file pointers and that 
libssh2 implements this using a localized file pointer which is updated 
with each read/write call.

.SH RETURN VALUE
Current offset from beginning of file in bytes.

.SH SEE ALSO
.BR libssh2_sftp_open(3)