Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3tsol/getuserrange.3tsol
Real path: /usr/share/man/man3tsol/getuserrange.3tsol
Zurück

'\" te
.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates. All rights reserved.
.TH getuserrange 3TSOL "10 Sep 2014" "Oracle Solaris 11.4" "Trusted Extensions Library Functions"
.SH NAME
getuserrange \- get the label range of a user
.SH SYNOPSIS

.LP
.nf
\fBcc\fR [\fIflags\fR...] \fIfile\fR... \fB-ltsol\fR [\fIlibrary\fR...]
.fi

.LP
.nf
#include <tsol/label.h>

\fBm_range_t *\fR\fBgetuserrange\fR(\fBconst char *\fR\fIusername\fR);
.fi
.SH DESCRIPTION
.sp
.LP
The \fBgetuserrange()\fR function returns the label range of \fIusername\fR. 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.
.sp
.LP
The default value for a user's label range is specified in \fBlabel_encodings\fR(5). Overriding values for individual users are specified in \fBuser_attr\fR(5).
.sp
.LP
If the \fBlabeld\fR(8) service is enabled, the default value for a user's label range is specified in \fBlabel_encodings\fR(5). Otherwise, the default clearance is specified by the \fBCLEARANCE\fR property in \fBpolicy.conf\fR(5), which defaults to \fBADMIN_HIGH\fR. Overriding values for individual users are specified in \fBuser_attr\fR(5).
.SH RETURN VALUES
.sp
.LP
The \fBgetuserrange()\fR function returns \fBNULL\fR if the memory allocation fails. Otherwise, the function returns a structure which must be freed by the caller, as follows:
.sp
.in +2
.nf
m_range_t  *range;
    ...
    m_label_free(range->lower_bound);
    m_label_free(range->upper_bound);
    free(range);
.fi
.in -2
.sp
.SH ERRORS
.sp
.LP
The \fBgetuserrange()\fR function will fail if:
.sp
.ne 2
.mk
.na
\fB\fBENOMEM\fR\fR
.ad
.RS 10n
.rt
The physical limits of the system are exceeded by size bytes of memory which cannot be allocated.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.17i) |cw(3.33i) 
lw(2.17i) |lw(3.33i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Interface Stability
See below.
_
MT-Level
MT-Safe
.TE
.sp
.sp
.LP
The \fBgetuserrange()\fR function is Committed for systems that implement the Defense Intelligence Agency (DIA) MAC policy of \fBlabel_encodings\fR(5). Other policies might exist in a future release of Trusted Extensions that might make obsolete or supplement \fBlabel_encodings\fR.
.SH SEE ALSO
.sp
.LP
\fBfree\fR(3C), \fBlibtsol\fR(3LIB), \fBm_label_free\fR(3TSOL), \fBlabel_encodings\fR(5), \fBuser_attr\fR(5), \fBattributes\fR(7)