t6get_attr(3NSL)

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

NAME

t6get_attr, t6set_attr- get security attributes from or set security attributes in the security-attribute buffer handled by a control structure

SYNOPSIS

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


#include <tsix/t6attrs.h>

void *t6get_attr(t6attr_id_t attr_type, const t6attr_t t6ctl);
int t6set_attr(t6attr_id_t attr_type, const void *attr_buf, t6attr_t t6ctl);

DESCRIPTION

t6get_attr() takes a control structure, t6ctl, and attribute type, attr_type, and returns a pointer to the requested attribute value (type) from the opaque control structure t6ctl. attr_type contains a number (defined in <tsix/t6attrs.h>) that specifies which type of attribute the caller is interested in getting. Only one type can be specified per call.

Returned value by t6get_attr() should be type cast to the standard type that represents the type indicated by attr_type.

t6set_attr() replaces the requested attribute value (type) in t6ctl with the value to which attr_buf points. The type of the attribute is specified in attr_type as one of the numbers defined in <tsix/t6attrs.h>.

RETURN VALUES

Upon successful completion, t6get_attr() returns a pointer to the appropriate value if it exists in the attribute structure. Upon failure, t6get_attr() returns NULL. t6set_attr() returns 0 if the attribute structure can contain the requested attribute; if not, t6set_attr() returns -1 and does not change the attribute structure.

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), t6alloc_blk(3NSL), t6free_blk(3NSL)

SunOS 5.8 Reference Manual

attributes(5)

NOTES

In the Trusted Solaris environment, t6get_attr() returns values of these types:

au_id_t

Audit ID

auditinfo_t

Audit info

bclear_t

Clearance

bslabel_t

Sensitivity label

gid_t

Effective group ID

gid_t

Supplemental group IDs

pattr_t

Process attributes

priv_set_t

Effective privileges

sid_t

Session ID

pid_t

Process ID

uid_t

Effective user ID

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.

Trusted Solaris 8 4/01  Last Revised 1 May 2000

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