t6get_attr(3NSL)

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | RETURN VALUES | 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);

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> .

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWtsu
MT-Level	MT-Safe

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.

SEE ALSO

Trusted Solaris 8 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 ID s

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  Last Revised 1 May 2000

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