t6alloc_blk(3NSL)

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

NAME

t6alloc_blk, t6free_blk- Allocate and free security-attribute control structure and buffer

SYNOPSIS

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


#include <tsix/t6attrs.h>

t6attr_t t6alloc_blk(t6mask_t mask);
void t6free_blk(t6attr_t t6ctl);

DESCRIPTION

t6alloc_blk() allocates a t6attr_t structure, which is an opaque handle used to access the full set of security attributes supported on the system. See man pages for t6get_attr(3NSL) and t6set_attr(3NSL) for more information on how generic TSIX application programs can access security attributes referenced by t6attr_t without knowing how references are built between the t6attr_t structure and the sets of security attributes for each individual TSIX operating system vendor. If t6alloc_blk() is successful, the opaque handle is returned that can be used to set or get individual attributes to or from this control structure. t6alloc_blk() allocates space in the control structure for all attributes specified in the mask parameter.

t6free_blk() should be used in conjunction with t6alloc_blk() to free the opaque control structure and any space within it.

RETURN VALUES

Upon successful completion, t6alloc_blk() returns a pointer to the t6attr_t structure. Upon failure, t6alloc_blk() returns a NULL pointer.

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), t6get_attr(3NSL), t6set_attr(3NSL)

SunOS 5.8 Reference Manual

attributes(5)

WARNINGS

For generic TSIX applications, use t6free_blk() to free memory allocated by t6alloc_blk() for better portability.

NOTES

This man page is based on the version from the TSIX(RE) 1.1 Application Programming Interface (API) document; this interface is available in TSIX(RE) 1.1-API-compliant systems.

SunOS 5.8  Last Revised 13 Feb 1997

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