.IX \f4rmvq\fP(D3DK)

NAME

rmvq − remove a message from a queue

SYNOPSIS

#include <sys/stream.h>
void rmvq(queue_t ∗q, mblk_t ∗mp);

ARGUMENTS

qPointer to the queue containing the message to be removed. 

mpPointer to the message to remove. 

DESCRIPTION

rmvq removes a message from a queue.  A message can be removed from anywhere in a queue.  To prevent modules and drivers from having to deal with the internals of message linkage on a queue, either rmvq or getq(D3DK) should be used to remove a message from a queue. 

RETURN VALUE

None. 

LEVEL

Base or Interrupt. 

NOTES

Does not sleep. 

Driver-defined basic locks, read/write locks, and sleep locks may be held across calls to this function. 

mp must point to an existing message in the queue pointed to by q, or a system panic will occur. 

SEE ALSO

freezestr(D3DK), getq(D3DK), insq(D3DK), unfreezestr(D3DK)

EXAMPLE

See insq(D3DK) for an example of rmvq. 

DDI/DKI  —  STREAMS