getuserrange man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

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_encod‐
       ings(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.10			  20 Jul 2007		   getuserrange(3TSOL)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net