rmvb(9r) rmvb(9r)
NAME
rmvb - STREAMS: Removes a message block from a message block
SYNOPSIS
#include <sys/stream.h>
MBLKP rmvb(
MBLKP message_block_ptr,
MBLKP message_to_be_removed );
ARGUMENTS
Specifies a pointer to the message block from which a message block is to be removed. The typedef MBLKP is an alternate name for typedef
struct msgb *. Specifies a pointer to the message block to be removed. The typedef MBLKP is an alternate name for typedef struct msgb *.
DESCRIPTION
The rmvb interface removes a message block (the message_to_be_removed argument) from a message block (the message_block_ptr argument) and
returns a pointer to the altered message block. The rmvb interface does not free the message block; it merely removes the message block. It
is the module's or driver's responsibility to free the message block.
RETURN VALUES
Upon successful completion, rmvb returns a pointer to the message block (minus the removed message block). The pointer is NULL if the mes-
sage_to_be_removed argument was the only message block before the call to the rmvb interface. If the message block passed to mes-
sage_to_be_removed does not exist, rmvb returns the value -1.
SEE ALSO
Kernel Interfaces: rmvq(9r)
rmvb(9r)
