Manual Pages for UNIX Operating System command usage for man Xbcleartos

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 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  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
                  label_encodings(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:
                  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 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 NULL if the label or clearance is not
     a  valid, required type as defined in the label_encodings(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 specified in the label_encodings(4) file, a font list,
     and clips the translated 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  attri-
     butes:





SunOS 5.11          Last change: 20 Jul 2007                    2






Trusted Extensions Library Functions         labelclipping(3TSOL)



     ____________________________________________________________
    |       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.11          Last change: 20 Jul 2007                    3