NAME    [Toc]    [Back]

       rmvb  -  STREAMS:  Removes  a message block from a message
       block

SYNOPSIS    [Toc]    [Back]

       #include <sys/stream.h>

       MBLKP rmvb(
               MBLKP message_block_ptr,
               MBLKP message_to_be_removed );

ARGUMENTS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Upon successful completion, rmvb returns a pointer to  the
       message  block  (minus  the  removed  message  block). The
       pointer is NULL if the message_to_be_removed argument  was
       the  only message block before the call to the rmvb interface.
 If the message block passed to message_to_be_removed
       does not exist, rmvb returns the value -1.

SEE ALSO    [Toc]    [Back]

       Kernel Interfaces: rmvq(9r)



                                                         rmvb(9r)