getuserrange(3tsol) [opensolaris man page]

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)

Check Out this Related Man Page

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

NAME

       getdevicerange - get the label range of a device

SYNOPSIS

       cc [flag...] file... -lbsm -ltsol [library...]

       #include <tsol/label.h>

       blrange_t *getdevicerange(const char *device);

DESCRIPTION

       The getdevicerange() function returns the label range of a user-allocatable device.

       If the label range is not specified for device, getdevicerange() returns the default values of ADMIN_LOW for the lower bound and ADMIN_HIGH
       for the upper bound of device.

       From the command line, list_devices(1) can be used to see the label range of device.

RETURN VALUES

       The getdevicerange() function returns NULL on failure and sets errno. On successful completion, it returns a pointer to a blrange_t  struc-
       ture which must be freed by the caller, as follows:

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

ERRORS

       The getdevicerange() function will fail if:

       EAGAIN	  There is not enough memory available to allocate the required bytes. The application could try later.

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

       ENOTSUP	  Invalid upper or lower bound for device.

ATTRIBUTES

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

       +-----------------------+-----------------------------------+
       |    ATTRIBUTE TYPE     |	  ATTRIBUTE VALUE	   |
       +-----------------------+-----------------------------------+
       |Interface Stability    | Committed			   |
       +-----------------------+-----------------------------------+
       |MT-Level	       | MT-Safe			   |
       +-----------------------+-----------------------------------+

SEE ALSO

       list_devices(1), free(3C), libtsol(3LIB), m_label_free(3TSOL), attributes(5)

       Validating the Label Request Against the Printer's Label Range in Solaris Trusted Extensions Developer's Guide

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 					     getdevicerange(3TSOL)

Linux and UNIX Man Pages

getuserrange(3tsol) [opensolaris man page]

Check Out this Related Man Page