bltocolor man page on Solaris

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

bltocolor(3TSOL)     Trusted Extensions Library Functions     bltocolor(3TSOL)

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

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

       #include <tsol/label.h>

       char *bltocolor(const m_label_t *label);

       char *bltocolor_r(const m_label_t *label, const int size,
	   char *color_name);

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

       The calling process must have PRIV_SYS_TRANS_LABEL in its set of effec‐
       tive  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  bltocolor_r()  function returns a pointer to the color_name 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.  color_name	 must  provide	for  a
       string of at least size characters.

FILES
       /etc/security/tsol/label_encodings

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

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

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

       These functions are obsolete and retained for  ease  of	porting.  They
       might  be  removed  in a future Solaris Trusted Extensions release. Use
       the label_to_str(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 bltocolor_r()	 func‐
       tion should be used in multithreaded applications.

SEE ALSO
       label_to_str(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 speci‐
       fied  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.10			  20 Jul 2007		      bltocolor(3TSOL)
[top]

List of man pages available for Solaris

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