freeblk(D2sdi)

freeblk -- free a Host Bus Adapter device-specific request block

Synopsis

   long prefixfreeblk(struct hbadata *hbap);

Description

freeblk( ) frees HBA driver-specific request blocks previously allocated by the getblk(D2sdi) routine.

hbap: a pointer to the device specific hbadata(D4sdi) request block to be freed

Return values

On success, freeblk( ) returns SDI_RET_OK. On failure, it returns SDI_RET_ERR.

Usage

The freeblk( ) routine is the partner of the getblk(D2sdi) routine. freeblk( ) puts the freed command block back into the HBA driver's freelist of command blocks. If there are any processes blocked, waiting for the next command block to be freed, they must be unblocked after the block is put back in the freelist.

Context and synchronization

Non-blockable context. Interrupts are enabled but processes are not yet or no longer available.

Applicable hardware

All

Version applicability

sdi: 1, 2, 3, 4 HBA drivers.