putctl1(9F)

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

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

This routine puts an unlabeled message on the stream. The use of this routine is strongly discouraged. Programmers should use tsol_putctl1(9F) instead. If this routine is used on a network-type stream, the message will be dropped by the streams head.

SEE ALSO

Trusted Solaris 8 Reference Manual

putctl(9F), putnextctl1(9F), tsol_putctl1(9F)

SunOS 5.8 Reference Manual

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

Writing Device Drivers

STREAMS Programming Guide

NOTES

These interfaces are uncommitted. Although not expected to do so, they may change between minor Trusted Solaris releases.

Trusted Solaris 8  Last Revised 10 Sept 1997

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