SVR5

bioreset(D3)

bioreset -- reset a private buffer for reuse after completed I/O

Synopsis

   #include <sys/buf.h>
   #include <sys/ddi.h>
   
   void bioreset(buf_t *bp);

Description

The bioreset function is called by drivers which have allocated a private buffer for block I/O (via getrbuf(D3), for example) and want to use the buffer multiple times. When called, bioreset resets the buffer header pointed to by bp as follows:

clears the B_DONE and B_ERROR flags set for the previous I/O operation in the b_flags member
clears error codes (if any) returned for the previous I/O operation in the b_error member

Arguments

bp: Pointer to the buffer header structure.

Return values

None

Usage

To reuse a buffer, the driver calls bioreset at the end of each I/O operation to reset the buffer's header structure. The reset prepares the buffer for reuse during the next I/O operation. bioreset may also be called prior to performing any I/O operation, although this is not required.

The calling driver must ``own'' the buffer for which the reset is being requested.

I/O must not be in progress when bioreset is called.

Context and synchronization

All contexts.

Hardware applicability

All

Version applicability

ddi: 4, 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

buf(D4) freerbuf(D3) getrbuf(D3)