.\" 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" "9" "17 July 2003" "" ""

.SH NAME
parport_read \- read a block of data from a parallel port
.SH 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.
.SH "ABOUT THIS DOCUMENT"
.PP
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.1 or any later version published by the Free Software
Foundation; with no Invariant Sections, with no Front-Cover Texts,
and with no Back-Cover Texts.  A copy of the license is included
in the section entitled "GNU Free Documentation License".
.PP
If you have comments on the formatting of this manpage, then please contact
Michael Still (mikal@stillhq.com).
.PP
This documentation was generated with kernel version 2.5.72.