FSEEKO64(3) NEWLIB FSEEKO64(3)NAME
5.4 `fseeko64'--set file position for large file
SYNOPSIS
#include <stdio.h>
int fseeko64(FILE *FP, _off64_t OFFSET, int WHENCE)
int _fseeko64_r (struct _reent *PTR, FILE *FP,
_off64_t OFFSET, int WHENCE)
DESCRIPTION
Objects of type `FILE' can have a "position" that records how much of
the file your program has already read. Many of the `stdio' functions
depend on this position, and many change it as a side effect.
You can use `fseeko64' to set the position for the file identified
by FP that was opened via `fopen64'. The value of OFFSET determines
the new position, in one of three ways selected by the value of WHENCE
(defined as macros in ``stdio.h''):
`SEEK_SET'--OFFSET is the absolute file position (an offset from the
beginning of the file) desired. OFFSET must be positive.
`SEEK_CUR'--OFFSET is relative to the current file position. OFFSET
can meaningfully be either positive or negative.
`SEEK_END'--OFFSET is relative to the current end of file. OFFSET
can meaningfully be either positive (to increase the size of the file)
or negative.
See `ftello64' to determine the current file position.
RETURNS
`fseeko64' returns `0' when successful. On failure, the result is
`EOF'. The reason for failure is indicated in `errno': either `ESPIPE'
(the stream identified by FP doesn't support repositioning or wasn't
opened via `fopen64') or `EINVAL' (invalid file position).
PORTABILITY
`fseeko64' is a glibc extension.
Supporting OS subroutines required: `close', `fstat64', `isatty',
`lseek64', `read', `sbrk', `write'.
SEE ALSOfseeko64 is part of the library. The full documentation for is main‐
tained as a Texinfo manual. If info and are properly installed at your
site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 FSEEKO64(3)
