以 PDF 格式下載這本書 (1911 KB)

getuserrange(3TSOL)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also | Notes

Name

getuserrange– get the label range of a user

Synopsis

cc [flags...] file... -ltsol [library...]

#include <tsol/label.h>

m_range_t *getuserrange(const char *username);

Description

The getuserrange() function returns the label range of username. The lower bound in the range is used as the initial workspace label when a user logs into a multilevel desktop. The upper bound, or clearance, is used as an upper limit to the available labels that a user can assign to labeled workspaces.

The default value for a user's label range is specified in label_encodings(4). Overriding values for individual users are specified in user_attr(4).

Return Values

The getuserrange() function returns NULL if the memory allocation fails. Otherwise, the function returns a structure which must be freed by the caller, as follows:

m_range_t *range; ... m_label_free(range->lower_bound); m_label_free(range->upper_bound); free(range);

Errors

The getuserrange() function will fail if:

ENOMEM

The physical limits of the system are exceeded by size bytes of memory which cannot be allocated.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	See below.
MT-Level	MT-Safe

The getuserrange() function is Committed for systems that implement the Defense Intelligence Agency (DIA) MAC policy of label_encodings(4). Other policies might exist in a future release of Trusted Extensions that might make obsolete or supplement label_encodings.

See Also

free(3C), libtsol(3LIB), m_label_free(3TSOL), label_encodings(4), user_attr(4), attributes(5)

Notes

The functionality described on this manual page is available only if the system is configured with Trusted Extensions.

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also | Notes