Manual Pages for UNIX Operating System command usage for man label_to_str

Trusted Extensions Library Functions          label_to_str(3TSOL)



NAME
     label_to_str - convert labels to human readable strings

SYNOPSIS
     cc [flag...] file... -ltsol [library...]


     #include 

     int label_to_str(const m_label_t *label, char **string,
         const m_label_str_t conversion_type, uint_t flags);


DESCRIPTION
     label_to_str() is a simple function to convert various  man-
     datory label types to human readable strings.


     label is the mandatory label to convert.  string  points  to
     memory that is allocated by label_to_str() that contains the
     converted string. The  caller  is  responsible  for  calling
     free(3C) to free allocated memory.


     The calling process must have mandatory read access  to  the
     resulting human readable string. Or the calling process must
     have the sys_trans_label privilege.


     The conversion_type parameter controls  the  type  of  label
     conversion.  Not  all  types of conversion are valid for all
     types of label:

     M_LABEL               Converts label  to  a  human  readable
                           string based on its type.


     M_INTERNAL            Converts label  to  an  internal  text
                           representation  that is safe for stor-
                           ing  in  a  public  object.   Internal
                           conversions  can  later  be  parsed to
                           their same value.


     M_COLOR               Converts  label  to  a   string   that
                           represents  the  color  name  that the
                           administrator has associated with  the
                           label.


     PRINTER_TOP_BOTTOM    Converts label  to  a  human  readable
                           string  that is appropriate for use as



SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions          label_to_str(3TSOL)



                           the top and bottom label of banner and
                           trailer  pages in the Defense Intelli-
                           gence Agency (DIA)  encodings  printed
                           output schema.


     PRINTER_LABEL         Converts label  to  a  human  readable
                           string  that is appropriate for use as
                           the banner page downgrade  warning  in
                           the   DIA   encodings  printed  output
                           schema.


     PRINTER_CAVEATS       Converts label  to  a  human  readable
                           string  that is appropriate for use as
                           the banner page caveats section in the
                           DIA encodings printed output schema.


     PRINTER_CHANNELS      Converts label  to  a  human  readable
                           string  that is appropriate for use as
                           the banner page handling  channels  in
                           the   DIA   encodings  printed  output
                           schema.



     The flags parameter provides a hint to the label conversion:

     DEF_NAMES      The default names are preferred.


     SHORT_NAMES    Short names are preferred where defined.


     LONG_NAMES     Long names are preferred.


RETURN VALUES
     Upon  successful  completion,  the  label_to_str()  function
     returns  0. Otherwise, -1 is returned, errno is set to indi-
     cate the error and the string pointer is set to NULL.

ERRORS
     The label_to_str() function will fail if:

     EINVAL     Invalid parameter.


     ENOTSUP    The system does not support label translations.





SunOS 5.11          Last change: 20 Jul 2007                    2






Trusted Extensions Library Functions          label_to_str(3TSOL)



     ENOMEM     The physical limits of the system are exceeded by
                size bytes of memory which cannot be allocated.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | See below.                  |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|
    | Standard                    | See below.                  |
    |_____________________________|_____________________________|



     The  label_to_str()  function  is  Committed.  The  returned
     string  is Not-an-Interface and is dependent on the specific
     label_encodings file. The conversion type INTERNAL is Uncom-
     mitted,    but    is    always    accepted   as   input   to
     str_to_label(3TSOL).


     Conversion types that are  relative  to  the  DIA  encodings
     schema    are    Standard.    Standard   is   specified   in
     label_encodings(4).

SEE ALSO
     free(3C),        libtsol(3LIB),         str_to_label(3TSOL),
     label_encodings(4), attributes(5), labels(5)


     Using the label_to_str Function in  Oracle  Solaris  Trusted
     Extensions Developer's Guide

WARNINGS
     A number of these conversions rely on the DIA  label  encod-
     ings  schema.  They might not be valid for other label sche-
     mata.

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