NAME

biowait - suspend processes pending completion of block I/O

SYNOPSIS

#include <sys/types.h>

#include <sys/buf.h>

int biowait(struct buf * bp);

INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI).

ARGUMENTS

bp

Pointer to the buf structure describing the transfer.

DESCRIPTION

Drivers allocating their own buf structures with getrbuf(9F) can use the biowait( ) function to suspend the current thread and wait for completion of the transfer.

Drivers must call biodone(9F) when the transfer is complete to notify the thread blocked by biowait( ). biodone( ) is usually called in the interrupt routine.

RETURN VALUES

0

on success

non-0

on I/O failure. biowait( ) calls geterror(9F) to retrieve the error number which it returns.

CONTEXT

biowait( ) can be called from user context only.

SEE ALSO

biodone(9F), geterror(9F), getrbuf(9F), buf(9S)

Writing Device Drivers