STREAMS-UX Programmer's Guide (February 2007)

STREAMS Utilities Supported by HP-UX
Appendix B
198
NAME
putnextctl () – Send control message with one byte parameter to the next queue.
SYNOPSIS
#include <sys/stream.h>
int putnextctl1 (queue_t *q, int type, int parm);
PARAMETERS
q Pointer to the queue from which the control message is to be sent.
type Type of the control message.
parm 1-byte data parameter.
DESCRIPTION
putnextctl1() behaves exactly like putnextctl() with the addition of a 1-byte parameter to the control
message.
RETURN VALUES
On successful it returns 1. putnext1() returns 0 if, either the type specified is M_DATA, M_PROTO, or
M_PCPROTO, or a message block cannot be allocated.
CONSTRAINTS
putnextctl1() does not block and can be called from thread or interrupt context. Spinlocks must not be held
across this call.