t6peek_attr(3N)						       t6peek_attr(3N)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     libt6(3N)

SOURCE    [Toc]    [Back]

     Trusted Systems Interoperability Group





									Page 1






t6peek_attr(3N)						       t6peek_attr(3N)

NOTES    [Toc]    [Back]

									PPPPaaaaggggeeee 2222