t6get_endpt_mask(3NSL)

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

NAME

t6get_endpt_mask, t6set_endpt_mask, t6get_endpt_default, t6set_endpt_default- get and set endpoint mask, or get and set endpoint default attributes

SYNOPSIS

cc [flags...] file ... -lt6


#include <tsix/t6attrs.h>

int t6get_endpt_mask(int fd, t6mask_t *mask);
int t6set_endpt_mask(int fd, t6mask_t mask);
int t6get_endpt_default(int fd, t6mask_t *mask, t6attr_t attr_ptr);
int t6set_endpt_default(int fd, t6mask_t mask, const t6attr_t attr_ptr);

DESCRIPTION

The security extensions on the communication endpoint include a set of default security attributes that may be applied to outgoing data and an attribute mask that designates which attributes are taken from the endpoint's default attributes and which are taken from the process' effective attributes.

By default, data written to an endpoint has associated with it the security attributes of the process that wrote the data. However, a privileged process may change the value of the default attribute mask on an endpoint the process had created, and the endpoint's default attributes.

t6get_endpt_mask() allows a process to obtain the current setting of the default attribute mask for the endpoint specified by fd. The attribute mask is returned in the parameter mask.

t6set_endpt_mask() allows a process to set the bit values of the default attribute mask for the endpoint specified by fd to the value specified by mask. A bit value of 0 indicates the attribute is taken from the process's effective attributes; and a bit value of 1 indicates the the attribute is taken from the endpoint's default attributes.

t6get_endpt_default() allows a process to get the current setting of the default attributes of the endpoint specified by fd. mask indicates which attributes are present in the attr_ptr parameter. To access attr_ptr, see t6get_attr(3NSL).

t6set_endpt_default() allows a process to set the default attributes of the endpoint specified by fd to the attributes specified by attr_ptr. mask indicates which attributes are present in attr_ptr. To set up attr_ptr, see t6set_attr(3NSL).

Only a process with the appropriate override privileges can change the endpoint's attribute mask or default attributes. To change an endpoint's default attribute or its mask bit, a process must have the override privilege corresponding to the attribute. The override privilege required to specify a default attribute is implementation-specific.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
MT-Level	MT-Safe

RETURN VALUES

Upon successful completion, these calls return 0. If either call encounters an error, the call returns -1.

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

libt6(3NSL), t6sendto(3NSL), t6set_attr(3NSL)

SunOS 5.8 Reference Manual

attributes(5)

NOTES

This man page is based on the version from the TSIX(RE) 1.1 Application Programming Interface (API) document; and this interface is available in TSIX(RE) 1.1-API-compliant systems.

Trusted Solaris 8 4/01  Last Revised 29 Apr 1998

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