.\" This documentation was generated from the book titled "The Linux 2.4 Parallel Port Subsystem", which is part of the Linux kernel source. .\" .\" Documentation by: Tim Waugh (twaugh@redhat.com) .\" Documentation copyright: 1999-2000 Tim Waugh .\" This documentation comes with the following legal notice: .\" .\" 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". .\" .\" For comments on the formatting of this manpage, please contact Michael Still .\" This manpage has been automatically generated by docbook2man .\" from a DocBook document. This tool can be found at: .\" .\" Please send any bug reports, improvements, comments, patches, .\" etc. to Steve Cheng . .TH "PARPORT_YIELD" "9" "06 August 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 This documentation was generated with kernel version 2.6.0.