Trusted Extensions Library Functions               mlabel(3TSOL)



NAME
     mlabel, mlabelalloc, mlabeldup, mlabelfree -  mlabel
     functions

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


     #include 

     mlabelt *mlabelalloc(const mlabeltypet labeltype);


     int mlabeldup(mlabelt **dst, const mlabelt *src);


     void mlabelfree(mlabelt *label);


DESCRIPTION
     The mlabelalloc() function allocates resources for  a  new
     label.  The labeltype argument defines the type for a newly
     allocated label. The label type can be:

     MACLABEL     A Mandatory Access Control (MAC) label.


     USERCLEAR    A user clearance.



     The mlabeldup() function allocates resources for a new dst
     label.  The  function  returns  a  pointer  to the allocated
     label, which is an exact copy of the src label.  The  caller
     is  responsible  for freeing the allocated resources by cal-
     ling mlabelfree().


     The mlabelfree() function frees resources that are associ-
     ated with the previously allocated label.

RETURN VALUES
     Upon successful  completion,  the  mlabelalloc()  function
     returns  a  pointer to the newly allocated label. Otherwise,
     mlabelalloc() returns NUL and errno is  set  to  indicate
     the error.


     Upon  successful  completion,  the  mlabeldup()   function
     returns  0.  Otherwise,  -1  is returned and errno is set to
     indicate the error.




SunOS 5.11          Last change: 20 Jul 2007                    1






Trusted Extensions Library Functions               mlabel(3TSOL)



ERORS
     The mlabelalloc() function will fail if:

     EINVAL    Invalid parameter.


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


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT-Level                     Safe                        
    


SEE ALSO
     labeltostr(3TSOL),   libtsol(3LIB),   strtolabel(3TSOL),
     labelencodings(4), attributes(5), labels(5)


     Determining Whether the Printing Service  Is  Running  in  a
     Labeled    Environment   in   Solaris   Trusted   Extensions
     Developer's Guide

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                    2