bioerror(D3)bioerror(D3)NAMEbioerror - manipulate error fields within a buffer header
SYNOPSIS
#include <sys/types.h>
#include <sys/buf.h>
#include <sys/ddi.h>
void bioerror(buf_t *bp, int errno);
Arguments
bp Pointer to the buffer header structure.
errno Error number to be set, or zero to indicate that the error
fields within the buffer header should be cleared.
DESCRIPTIONbioerror is used to manipulate the error fields within a buffer header
(buf(D4) structure).
Return Values
None
USAGE
Driver code (for example, a strategy(D2) routine) that wishes to report
an I/O error condition associated with the buffer pointed to by bp should
call bioerror with errno set to the appropriate error number. This will
set the appropriate fields within the buffer header so that higher level
code can detect the error and retrieve the error number using
geterror(D3).
The error fields within the buffer header can be cleared by calling
bioerror with errno set to zero.
On multiprocessor systems, DDI/DKI conforming drivers are no longer
permitted to manipulate the error fields of the buf structure directly.
bioerror must be used for this purpose.
Level
Base or Interrupt.
Synchronization Constraints
Does not sleep.
Driver-defined basic locks, read/write locks, and sleep locks may be held
across calls to this function.
REFERENCESbuf(D4), errnos(D5), geteblk(D3), geterror(D3), getrbuf(D3),
ngeteblk(D3), strategy(D2)
Page 1
