1getuserrange(3TSOL) Trusted Extensions Library Functions getuserrange(3TSOL)
2
3
4
6 getuserrange - get the label range of a user
7
9 cc [flags...] file... -ltsol [library...]
10
11
12 #include <tsol/label.h>
13
14 m_range_t *getuserrange(const char *username);
15
16
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
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
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
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
70 free(3C), libtsol(3LIB), m_label_free(3TSOL), label_encodings(4),
71 user_attr(4), attributes(5)
72
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)