STREAMS-UX Programmer's Guide (February 2007)

STREAMS Utilities Supported by HP-UX

Appendix B

232

NAME

unlinkb () – Removes the first message block from the head of a message.

SYNOPSIS

#include <sys/stream.h>

mblk_t *unlinkb(mblk_t *mp);

PARAMETERS

Pointer to message from which the first block is to be removed.

DESCRIPTION

unlinkb() will unlink the first message block from the message and the altered message is returned to the

caller. It is the responsibility of the module or driver to actually free the message block.

RETURN VALUES

unlinkb() returns a pointer to the head of the altered message after unlinking the first block. If this was the

last (or only) block in the message, unlinkb() returns a NULL pointer.

CONSTRAINTS

unlinkb() can be called from thread or interrupt context. Spinlocks can be held across this call.