biowait(D3) biowait(D3)
NAME
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);
Arguments
bp Pointer to the buffer header structure.
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.
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.
Level
Base only.
Synchronization Constraints
Can sleep.
Driver-defined basic locks and read/write locks may not be
held across calls to this function.
Driver-defined sleep locks may be held across calls to this
function.
Copyright 1994 Novell, Inc. Page 1
biowait(D3) biowait(D3)
REFERENCES
biodone(D3), biowait_sig(D3), buf(D4), geteblk(D3),
getrbuf(D3), intr(D2), ngeteblk(D3), strategy(D2)
NOTICES
Portability
All processors
Applicability
ddi: 1, 2, 3, 4, 5, 5mp, 6, 6mp, 7, 7mp
Copyright 1994 Novell, Inc. Page 2