Trusted Extensions Library Functions labelclipping(3TSOL)
NAME
labelclipping, Xbsltos, Xbcleartos - translate a binary
label and clip to the specified width
SYNOPSIS
cc [flag...] file... -ltsol -lDtTsol [library...]
#include
XmString Xbsltos(Display *display, const mlabelt *senslabel,
Dimension width, const XmFontList fontlist, const int flags);
XmString Xbcleartos(Display *display, const mlabelt *clearance,
Dimension width, const XmFontList fontlist, const int flags);
DESCRIPTION
The calling process must have PRIVSYSTRANSLABEL in its
set of effective privileges to translate labels or clear-
ances that dominate the current process' sensitivity label.
display The structure controlling the connection to an
X Window System display.
senslabel The sensitivity label to be translated.
clearance The clearance to be translated.
width The width of the translated label or clearance
in pixels. If the specified width is shorter
than the full label, the label is clipped and
the presence of clipped letters is indicated by
an arrow. In this example, letters have been
clipped to the right of: TS<-. See the
sbltos(3TSOL) manual page for more information
on the clipped indicator. If the specified
width is equal to the display width (display),
the label is not truncated, but word-wrapped
using a width of half the display width.
fontlist A list of fonts and character sets where each
font is associated with a character set.
flags The value of flags indicates which words in the
labelencodings(4) file are used for the
SunOS 5.11 Last change: 20 Jul 2007 1
Trusted Extensions Library Functions labelclipping(3TSOL)
translation. See the bltos(3TSOL) manual page
for a description of the flag values:
LONGWORDS, SHORTWORDS, LONGCLASIFICATION,
SHORTCLASIFICATION, ALENTRIES,
ACESRELATED, VIEWEXTERNAL, VIEWINTERNAL,
NOCLASIFICATION. BRACKETED is an additional
flag that can be used with Xbsltos() only. It
encloses the sensitivity label in square brack-
ets as follows: [C].
RETURN VALUES
These functions return a compound string that represents the
character-coded form of the sensitivity label or clearance
that is translated. The compound string uses the language
and fonts specified in fontlist and is clipped to width.
These functions return NUL if the label or clearance is not
a valid, required type as defined in the labelencodings(4)
file, or not dominated by the process' sensitivity label and
the PRIVSYSTRANSLABEL privilege is not asserted.
FILES
/usr/dt/include/Dt/labelclipping.h
Header file for label clipping functions
/etc/security/tsol/labelencodings
The label encodings file contains the classification
names, words, constraints, and values for the defined
labels of this system.
EXAMPLES
Example 1 Translate and Clip a Clearance.
This example translates a clearance to text using the long
words specified in the labelencodings(4) file, a font list,
and clips the translated clearance to a width of 72 pixels.
xmstr = Xbcleartos(XtDisplay(topLevel),
&clearance, 72, fontlist, LONGWORDS
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 20 Jul 2007 2
Trusted Extensions Library Functions labelclipping(3TSOL)
ATRIBUTE TYPE ATRIBUTE VALUE
Interface Stability Obsolete
MT-Level MT-Safe
The labelclipping functions, Xbsltos() and Xbcleartos(), are
obsolete. Use the labeltostr(3TSOL) function instead.
SEE ALSO
bltos(3TSOL), labeltostr(3TSOL), libtsol(3LIB),
labelencodings(4), attributes(5)
See XmStringDraw(3) and FontList(3) for information on the
creation and structure of a font list.
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 3
|
