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