tsol_putnextctl(9F)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | CONTEXT | SEE ALSO | NOTES

NAME

tsol_putnextctl- Send a control message and a set of attributes to a queue

SYNOPSIS

#include <sys/stream.h>

int tsol_putnextctl(queue_t *q, int type, str_attr_t *attrs);

PARAMETERS

q

Queue to which the message is to be sent.

type

Message type (must be control, not data type).

attrs

Pointer to the security attributes for the control message.

DESCRIPTION

tsol_putnextctl() is a replacement for putnextctl(9F). tsol_putnextctl() allows a set of attributes to be sent with the control message via attrs. Otherwise, tsol_putnextctl() performs the same as putnextctl().

tsol_putnextctl() should always be used in preference to putnextctl().

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	Trusted Solaris only
Interface-Level	Architecture-independent level 1 (DDI/DKI)

RETURN VALUES

tsol_putnextctl() returns:

1

On success.

0

If type is a data type or if a message block cannot be allocated.

CONTEXT

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

SEE ALSO

Trusted Solaris 8 Reference Manual

putctl(9F), putnextctl1(9F), tsol_putnextctl1(9F)

SunOS 5.8 Reference Manual

cmn_err(9F), datamsg(9F), attributes(5)

Writing Device Drivers STREAMS Programming Guide

NOTES

These interfaces are uncommitted. Although they are not expected to change between minor releases of the Trusted Solaris environment, they may.

Trusted Solaris 8  Last Revised 29 Mar 1993

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | CONTEXT | SEE ALSO | NOTES