SunOS man pages


	www.sun.com	docs.sun.com \| \| \|

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Kernel Functions for Drivers

biowait(9F)

INTERFACE LEVEL
PARAMETERS
DESCRIPTION
RETURN VALUES
CONTEXT
SEE ALSO

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).

PARAMETERS

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: Upon success
non-zero: Upon I/O failure. biowait() calls geterror(9F) to retrieve the error number which it returns.

CONTEXT

biowait() can be called from user context only.