labelclipping man page on SunOS

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

labelclipping(3TSOL) 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 <Dt/label_clipping.h>

       XmString Xbsltos(Display *display, const m_label_t *senslabel,
	   Dimension width, const XmFontList fontlist, const int flags);

       XmString Xbcleartos(Display *display, const m_label_t *clearance,
	   Dimension width, const XmFontList fontlist, const int flags);

DESCRIPTION
       The calling process must have PRIV_SYS_TRANS_LABEL in its set of effec‐
       tive  privileges	 to  translate	labels or clearances 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) man‐
		    ual page for more information on the clipped indicator. If
		    the	 specified  width  is equal to the display width (dis‐
		    play), 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
		    label_encodings(4)	file are used for the translation. See
		    the bltos(3TSOL) manual page for a description of the flag
		    values:   LONG_WORDS,   SHORT_WORDS,  LONG_CLASSIFICATION,
		    SHORT_CLASSIFICATION,     ALL_ENTRIES,     ACCESS_RELATED,
		    VIEW_EXTERNAL, VIEW_INTERNAL, NO_CLASSIFICATION. BRACKETED
		    is an additional flag that	can  be	 used  with  Xbsltos()
		    only. It encloses the sensitivity label in square brackets
		    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 NULL if the label or
       clearance is not a valid, required type as defined in the  label_encod‐
       ings(4)	file,  or  not dominated by the process' sensitivity label and
       the PRIV_SYS_TRANS_LABEL privilege is not asserted.

FILES
       /usr/dt/include/Dt/label_clipping.h

	   Header file for label clipping functions

       /etc/security/tsol/label_encodings

	   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 speci‐
       fied in the label_encodings(4) file, a font list, and clips the	trans‐
       lated clearance to a width of 72 pixels.

	 xmstr = Xbcleartos(XtDisplay(topLevel),
	 &clearance, 72, fontlist, LONG_WORDS

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │Interface Stability	     │Obsolete			   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │MT-Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

       The  labelclipping functions, Xbsltos() and Xbcleartos(), are obsolete.
       Use the label_to_str(3TSOL) function instead.

SEE ALSO
       bltos(3TSOL),  label_to_str(3TSOL),  libtsol(3LIB), label_encodings(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.10			  20 Jul 2007		  labelclipping(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