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