Trusted Extensions Library Functions             bltocolor(3TSOL)



NAME
     bltocolor, bltocolorr - get character-coded color  name  of
     label

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


     #include 

     char *bltocolor(const mlabelt *label);


     char *bltocolorr(const mlabelt *label, const int size,
          char *colorname);


DESCRIPTION
     The  bltocolor()  and  bltocolorr()   functions   get   the
     character-coded  color name associated with the binary label
     label.


     The calling process must have  PRIVSYSTRANSLABEL  in  its
     set  of  effective  privileges  to get color names of labels
     that dominate the current process's sensitivity label.

RETURN VALUES
     The bltocolor() function returns a pointer to  a  statically
     allocated  string  that  contains  the character-coded color
     name specified for the label or returns (char  *)0  if,  for
     any  reason,  no character-coded color name is available for
     this binary label.


     The  bltocolorr()  function  returns  a  pointer   to   the
     colorname  string  which contains the character-coded color
     name specified for the label or returns (char  *)0  if,  for
     any  reason,  no character-coded color name is available for
     this binary label. colorname must provide for a  string  of
     at least size characters.

FILES
     /etc/security/tsol/labelencodings

         The label encodings  file  contains  the  classification
         names,  words,  constraints,  and values for the defined
         labels of this system.


ATRIBUTES




SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions             bltocolor(3TSOL)



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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Obsolete                    
    
     MT-Level                     MT-Safe with exceptions     
    



     These functions are obsolete and retained for ease of  port-
     ing.  They  might  be  removed  in  a future Solaris Trusted
     Extensions release.  Use  the  labeltostr(3TSOL)  function
     instead.


     The bltocolor() function returns a pointer to  a  statically
     allocated string. Subsequent calls to it will overwrite that
     string with a new character-coded color name. It is not  MT-
     Safe.  The  bltocolorr()  function  should  be used in mul-
     tithreaded applications.

SEE ALSO
     labeltostr(3TSOL), libtsol(3LIB), attributes(5)

NOTES
     The functionality described on this manual page is available
     only if the system is configured with Trusted Extensions.


     If label includes a specified word or words, the  character-
     coded color name associated with the first word specified in
     the label encodings  file  is  returned.  Otherwise,  if  no
     character-coded color name is specified for label, the first
     character-coded color name specified in the label  encodings
     file  with  the  same  classification as the binary label is
     returned.













SunOS 5.11          Last change: 20 Jul 2007                    2