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)