NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ATTRIBUTES | SEE ALSO | NOTES
#include <tsix/t6attrs.h>int t6peek_attr(int fd, t6attr_t attr_ptr, t6mask_t * new_attrs);
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() .
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 .
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Availability | SUNWtsu |
MT-Level | MT-Safe |
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