putctl1(9F)

NAME

putctl1 − send a control message with a one-byte parameter to a queue

SYNOPSIS

#include <sys/stream.h>
int putctl1(queue_t ∗q, int type, int p
);

INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI).

ARGUMENTS

q Queue to which the message is to be sent.

type Type of message.

p One-byte parameter.

DESCRIPTION

putctl1(), like putctl(9F), tests the type argument to make sure a data type has not been specified, and attempts to allocate a message block. The p parameter can be used, for example, to specify how long the delay will be when an M_DELAY message is being sent. putctl1() fails if type is M_DATA, M_PROTO, or M_PCPROTO, or if a mesage block cannot be allocated. If successful, putctl1() calls the put(9E) routine of the queue pointed to by q with the newly allocated and initialized message.

RETURN VALUES

On success, 1 is returned. 0 is returned if type is a data type, or if a message block cannot be allocated.

CONTEXT

putctl1() can be called from user or interrupt context.

EXAMPLE

See the putctl(9F) function page for an example of putctl1().

Museum

Related Articles