.\"
.\" $Id: rfio_pread.man,v 1.1 2008/09/24 11:25:01 dhsmith Exp $
.\"
.\" @(#)$RCSfile: rfio_pread.man,v $ $Revision: 1.1 $ $Date: 2008/09/24 11:25:01 $ CERN IT-DM Jean-Philippe Baud
.\" Copyright (C) 1999-2008 by CERN/IT/DM
.\" All rights reserved
.\"
.TH RFIO_PREAD 3 "$Date: 2008/09/24 11:25:01 $" LCG "Rfio Library Functions"
.SH NAME
rfio_pread \- reads in a file
.SH SYNOPSIS
.B #include <sys/types.h>
.br
\fB#include "rfio_api.h"\fR
.sp
.BI "int rfio_pread (char *" ptr ", int " size ", int " items ", FILE *" fd ");"
.SH DESCRIPTION
.B rfio_pread
reads
.BI items
times
.BI size
bytes, using the descriptor
.BI fd
generated by a previous
.B rfio_popen
and strore them at location
.BR ptr .
.SH RETURN VALUE
This routine returns -1 if the operation failed or the number of items actually read. In case of failure, 
.B serrno
is set appropriately.
.SH ERRORS
.TP 1.3i
.B EBADF
.I fd
is a NULL pointer.
.TP
.B SENOSHOST
Host unknown.
.TP
.B SENOSSERV
Service unknown.
.TP
.B SETIMEDOUT
Timed out.
.TP
.B SEBADVERSION
Version ID mismatch.
.TP
.B SECONNDROP
Connection closed by remote end.
.TP
.B SECOMERR
Communication error.
.TP
.B SENORCODE
Host did not return error number.
.SH SEE ALSO
.BR rfio_popen(3)
.SH AUTHOR
\fBLCG Grid Deployment\fP Team