.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "PARPORT_READ" "" "06 October 2005" "" ""

.SH NAME
parport_read \- read a block of data from a parallel port
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
ssize_t parport_read  (struct parport * \fIport\fB, void * \fIbuffer\fB, size_t \fIlen\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIport\fB\fR
port to read from
.TP
\fB\fIbuffer\fB\fR
data buffer (in kernel space)
.TP
\fB\fIlen\fB\fR
number of bytes of data to transfer
.SH "DESCRIPTION"
.PP
This will read up to \fIlen\fR bytes of \fIbuffer\fR to the port
specified, using the IEEE 1284 transfer mode most recently
negotiated to (using \fBparport_negotiate\fR), as long as that
mode supports reverse transfers (peripheral to host).
.PP
It is the caller's responsibility to ensure that the first
\fIlen\fR bytes of \fIbuffer\fR are available to write to.
.PP
This function returns the number of bytes transferred (if zero
or positive), or else an error code.