tsol_putctl1(9F)

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

NAME

tsol_putctl1- Send a control message with a one-byte parameter and a set of attributes to a queue

SYNOPSIS

#include <sys/stream.h>

int tsol_putctl1(queue_t *q, int type, int p, str_attr_t *attrs);

PARAMETERS

q

Queue to which the message is to be sent.

type

Type of message.

p

One-byte parameter.

attrs

Pointer to the security attributes for the control message.

DESCRIPTION

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

tsol_putctl1() should always be used in preference to putctl1(9F).

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_putctl1() returns:

1

On success.

0

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

CONTEXT

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

SEE ALSO

Trusted Solaris 8 Reference Manual

putctl(9F), putnextctl1(9F)

SunOS 5.8 Reference Manual

put(9E), allocb(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 11 Apr 1991

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