Content-type: text/html Man page of getuserrange

getuserrange

Section: Trusted Extensions Library Functions (3TSOL)
Updated: 20 Jul 2007
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE

Interface StabilitySee below.

MT-Level

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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:38:33 GMT, October 02, 2010