RFIO_LSEEK

Section: Rfio Library Functions (3)
Updated: $Date: 2005/03/31 13:13:03 $
Index Return to Main Contents
 

NAME

rfio_lseek - positions/repositions a file  

SYNOPSIS

#include <sys/types.h>
#include "rfio_api.h"

off_t rfio_lseek (int s, off_t offset, int how);

Under Linux, for large files:
#define _LARGEFILE64_SOURCE
#include <sys/types.h>
#include "rfio_api.h"

off64_t rfio_lseek64 (int s, off64_t offset, int how);

For large files, under other systems:
#include <sys/types.h>
#include "rfio_api.h"

off64_t rfio_lseek64 (int s, off64_t offset, int how);  

DESCRIPTION

rfio_lseek positions/repositions to offset the file associated with the descriptor s generated by a previous rfio_open. how indicates how to interpret the offset value:
SEEK_SET
The offset is set from beginning of file.
SEEK_CUR
The offset is added to current position.
SEEK_END
The offset is added to current file size.

rfio_lseek64 performs the same function on large files using off64_t rather than off_t.  

RETURN VALUE

This routine returns -1 if the operation failed or the actual offset from the beginning of file. In case of failure, serrno is set appropriately.  

ERRORS

EBADF
s is not a valid descriptor.
EINVAL
incorrect value for how.
SENOSHOST
Host unknown.
SENOSSERV
Service unknown.
SETIMEDOUT
Timed out.
SEBADVERSION
Version ID mismatch.
SEINTERNAL
Internal error.
SECONNDROP
Connection closed by remote end.
SECOMERR
Communication error.
 

SEE ALSO

rfio_open(3)  

AUTHOR

LCG Grid Deployment Team