putctl1(9F)

NAME | SYNOPSIS | PARAMETERS | INTERFACE LEVEL | DESCRIPTION | RETURN VALUES | CONTEXT | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO

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);

PARAMETERS

q

Queue to which the message is to be sent.

type

Type of message.

p

One-byte parameter.

INTERFACE LEVEL

Architecture independent level 1 (DDI/DKI).

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 message 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.

EXAMPLES

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

SUMMARY OF TRUSTED SOLARIS CHANGES

The new message allocated by this routine is labeled with the default streams attributes of the target queue.

SEE ALSO

Trusted Solaris 8 HW 12/02 Reference Manual

putctl(9F), putnextctl1(9F)

SunOS 5.8 Reference Manual

put(9E), allocb(9F), datamsg(9F)

Writing Device Drivers

STREAMS Programming Guide

SunOS 5.8Trusted Solaris 8 HW 12/02  Last Revised 26 Jul 2001

NAME | SYNOPSIS | PARAMETERS | INTERFACE LEVEL | DESCRIPTION | RETURN VALUES | CONTEXT | EXAMPLES | SUMMARY OF TRUSTED SOLARIS CHANGES | SEE ALSO