t6peek_attr(3NSL)

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

NAME

t6peek_attr, t6last_attr- Examine the security attributes on the next or the previous byte of data

SYNOPSIS

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


#include <tsix/t6attrs.h>

int t6peek_attr(int fd, t6attr_t attr_ptr, t6mask_t *new_attrs);
int t6last_attr (int fd, t6attr_t attr_ptr, t6mask_t *new_attrs);

DESCRIPTION

t6peek_attr() allows a process to peek ahead at the security attributes of the next byte of data. fd is the descriptor of the endpoint; attr_ptr specifies a structure in which to store those attributes the caller wishes to retrieve. new_attrs points to a mask that indicates which attributes were actually retrieved on return from t6peek_attr().

t6last_attr() allows a process to retrieve the attributes of the last byte of data read from the indicated file descriptor. The parameters for t6last_attr() are identical to those for the t6peek_attr() routine.

If no messages are available at the socket, the examining call waits for a message to arrive, unless the socket is non-blocking (see fcntl(2)), in which case -1 is returned with the external variable errno set to EWOULDBLOCK.

In order to obtain audit ID, additional audit information, and supplementary group IDs when using connectionless transports, connect(3SOCKET) must be used to associate the peer network address with the local transport endpoint before calling t6peek_attr() or t6last_attr().

RETURN VALUES

Upon successful completion, these calls return 0, place the retrieved security attributes in the t6attr_t structure, and set *new_attrs to the mask of those attributes actually returned. If either call encounters an error, it returns -1. When they generate errors, t6peek_attr() and t6last_attrs() set errno.

ATTRIBUTES

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

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

SEE ALSO

Trusted Solaris 8 4/01 Reference Manual

libt6(3NSL), fcntl(2)

SunOS 5.8 Reference Manual

connect(3SOCKET), 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.

SunOS 5.8  Last Revised 6 Oct 2000

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