1getuserrange(3TSOL)  Trusted Extensions Library Functions  getuserrange(3TSOL)
2
3
4

NAME

6       getuserrange - get the label range of a user
7

SYNOPSIS

9       cc [flags...] file... -ltsol [library...]
10
11
12       #include <tsol/label.h>
13
14       m_range_t *getuserrange(const char *username);
15
16

DESCRIPTION

18       The  getuserrange()  function  returns the label range of username. The
19       lower bound in the range is used as the initial workspace label when  a
20       user  logs into a multilevel desktop. The upper bound, or clearance, is
21       used as an upper limit to the available labels that a user  can  assign
22       to labeled workspaces.
23
24
25       The default value for a user's label range is specified in label_encod‐
26       ings(4). Overriding  values  for  individual  users  are  specified  in
27       user_attr(4).
28

RETURN VALUES

30       The  getuserrange()  function  returns  NULL  if  the memory allocation
31       fails. Otherwise, the function returns a structure which must be  freed
32       by the caller, as follows:
33
34         m_range_t  *range;
35             ...
36             m_label_free(range->lower_bound);
37             m_label_free(range->upper_bound);
38             free(range);
39
40
41

ERRORS

43       The getuserrange() function will fail if:
44
45       ENOMEM    The  physical limits of the system are exceeded by size bytes
46                 of memory which cannot be allocated.
47
48

ATTRIBUTES

50       See attributes(5) for descriptions of the following attributes:
51
52
53
54
55       ┌───────────────────────┬───────────────────────────────────┐
56       │    ATTRIBUTE TYPE     │          ATTRIBUTE VALUE          │
57       ├───────────────────────┼───────────────────────────────────┤
58       │Interface Stability    │ See below.                        │
59       ├───────────────────────┼───────────────────────────────────┤
60       │MT-Level               │ MT-Safe                           │
61       └───────────────────────┴───────────────────────────────────┘
62
63
64       The getuserrange() function is Committed for systems that implement the
65       Defense  Intelligence  Agency  (DIA)  MAC policy of label_encodings(4).
66       Other policies might exist in a future release  of  Trusted  Extensions
67       that might make obsolete or supplement label_encodings.
68

SEE ALSO

70       free(3C),   libtsol(3LIB),   m_label_free(3TSOL),   label_encodings(4),
71       user_attr(4), attributes(5)
72

NOTES

74       The functionality described on this manual page is  available  only  if
75       the system is configured with Trusted Extensions.
76
77
78
79SunOS 5.11                        20 Jul 2007              getuserrange(3TSOL)
Impressum