DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5

biowait(D3)


biowait -- suspend execution pending completion of block I/O

Synopsis

   #include <sys/types.h>
   #include <sys/buf.h>
   #include <sys/ddi.h>
   

int biowait(buf_t *bp);

Description

The biowait function suspends process execution during block I/O. This wait will not be interrupted by signals. Use biowait_sig(D3) if you wish to be able to be interrupted by signals.

Arguments


bp
Pointer to the buffer header structure.

Return values

If an error occurred during the I/O transfer, the error number is returned. Otherwise, on success, 0 is returned.

Usage

Block drivers that have allocated their own buffers with geteblk(D3), getrbuf(D3), or ngeteblk(D3) can use biowait to suspend the current process execution while waiting for a read or write request to complete.

Drivers using biowait must use biodone(D3) in their I/O completion handlers to signal biowait when the I/O transfer is complete.

Context and synchronization

User or blockable context.

Hardware applicability

All

Version applicability

ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

biodone(D3), biowait_sig(D3), buf(D4) geteblk(D3), getrbuf(D3), intr(D2), ngeteblk(D3), strategy(D2)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005