rmvb(9r)rmvb(9r)NAMErmvb - 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)