opensolaris man page for getuserrange

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.

SunOS 5.11							    20 Jul 2007 					       getuserrange(3TSOL)