newlib-cygwin/newlib/libc/unix/pread.c

77 lines
1.7 KiB
C
Raw Normal View History

#ifndef _NO_PREAD
/*
FUNCTION
<<pread>>---read a file from specified position
INDEX
pread
INDEX
_pread_r
SYNOPSIS
#include <unistd.h>
ssize_t pread(int <[fd]>, void *<[buf]>, size_t <[n]>, off_t <[off]>);
ssize_t _pread_r(struct _reent *<[rptr]>, int <[fd]>,
void *<[buf]>, size_t <[n]>, off_t <[off]>);
DESCRIPTION
The <<pread>> function is similar to <<read>>. One difference is that
<<pread>> has an additional parameter <[off]> which is the offset to
position in the file before reading. The function also differs in that
the file position is unchanged by the function (i.e. the file position
is the same before and after a call to <<pread>>).
The <<_pread_r>> function is the same as <<pread>>, only a reentrant
struct pointer <[rptr]> is provided to preserve reentrancy.
RETURNS
<<pread>> returns the number of bytes read or <<-1>> if failure occurred.
PORTABILITY
<<pread>> is non-ANSI and is specified by the Single Unix Specification.
Supporting OS subroutine required: <<read>>, <<lseek>>.
*/
#include <_ansi.h>
#include <unistd.h>
#include <reent.h>
ssize_t
_pread_r (struct _reent *rptr,
int fd,
void *buf,
size_t n,
off_t off)
{
off_t cur_pos;
_READ_WRITE_RETURN_TYPE num_read;
if ((cur_pos = _lseek_r (rptr, fd, 0, SEEK_CUR)) == (off_t)-1)
return -1;
if (_lseek_r (rptr, fd, off, SEEK_SET) == (off_t)-1)
return -1;
num_read = _read_r (rptr, fd, buf, n);
if (_lseek_r (rptr, fd, cur_pos, SEEK_SET) == (off_t)-1)
return -1;
return (ssize_t)num_read;
}
#ifndef _REENT_ONLY
ssize_t
pread (int fd,
void *buf,
size_t n,
off_t off)
{
return _pread_r (_REENT, fd, buf, n, off);
}
#endif /* !_REENT_ONLY */
#endif /* !_NO_PREAD */