t6peek_attr(3N)

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

SYNOPSIS
     cc [ flags ... ] file

     #include <sys/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 trusted 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. Its parameters are
     identical to the t6peek_attr routine.

     Note that the following attributes will never be returned in the argument
     t6attr_t when the functions t6peek_attr and t6last_attr are called:
     T6_NAT_CAVEATS, T6_ACL, T6_IL, T6_PID, T6_RESV10, T6_AUDIT_INFO,
     T6_CLEARANCE.

RETURN VALUE
     On 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, the error code is returned.

ERRORS
     Errors generated by t6peek_attr and t6last_attrs are indicated by the
     global variable errno.

     [EFAULT]       If new_attrs contains a NULL pointer.

     [EINVAL]       Invalid Argument.

     [ENOTSOCK]     Socket operation on a Non-Socket not permitted.

SEE ALSO
     libt6(3N)

SOURCE
     Trusted Systems Interoperability Group
NOTES