t6peek_attr(3N)

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 .

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 7 Reference Manual

libt6(3N) , fcntl(2)

SunOS 5.7 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.

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