GETUSERRANGE(3TSOL) Trusted Extensions Library Functions GETUSERRANGE(3TSOL)


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.


July 20, 2007 GETUSERRANGE(3TSOL)