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

.SH NAME
parport_yield \- relinquish a parallel port temporarily
.SH SYNOPSIS
.sp
\fB
.sp
int parport_yield  (struct pardevice * \fIdev\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIdev\fB\fR
a device on the parallel port
.SH "DESCRIPTION"
.PP
This function relinquishes the port if it would be helpful to other
drivers to do so.  Afterwards it tries to reclaim the port using
\fBparport_claim\fR, and the return value is the same as for
\fBparport_claim\fR.  If it fails, the port is left unclaimed and it is
the driver's responsibility to reclaim the port.
.PP
The \fBparport_yield\fR and \fBparport_yield_blocking\fR functions are for
marking points in the driver at which other drivers may claim the
port and use their devices.  Yielding the port is similar to
releasing it and reclaiming it, but is more efficient because no
action is taken if there are no other devices needing the port.  In
fact, nothing is done even if there are other devices waiting but
the current device is still within its ``timeslice''.  The default
timeslice is half a second, but it can be adjusted via the /proc
interface.
.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.75.