Index for Section 9r

Alphabetical listing for R

Bottom of page

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
  message_block_ptr
      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 *.

  message_to_be_removed
      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
  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
  Kernel Interfaces: rmvq(9r)

Index for Section 9r

Alphabetical listing for R

Top of page