Manual Pages for UNIX Operating System command usage for man getuserrange

Trusted Extensions Library Functions          getuserrange(3TSOL)



NAME
     getuserrange - get the label range of a user

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


     #include 

     m_range_t *getuserrange(const char *username);


DESCRIPTION
     The getuserrange() function returns the label range of user-
     name.  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 allo-
     cation  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  attri-
     butes:







SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions          getuserrange(3TSOL)



     ____________________________________________________________
    |     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          Last change: 20 Jul 2007                    2