System Calls                                          getlabel(2)



NAME
     getlabel, fgetlabel - get file sensitivity label

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


     #include 

     int getlabel(const char *path, mlabelt *labelp);


     int fgetlabel(int fd, mlabelt *labelp);


DESCRIPTION
     The getlabel() function obtains the sensitivity label of the
     file  that  is  named  by path. Discretionary read, write or
     execute permission to the final component  of  path  is  not
     required,  but  all  directories  in the path prefix of path
     must be searchable.


     The fgetlabel() function obtains the label of an  open  file
     that  is  referred  to  by  the argument descriptor, such as
     would be obtained by an open(2) call.


     The labelp argument is a pointer to an opaque label  struc-
     ture.  The  caller  must allocate space for labelp by using
     mlabelalloc(3TSOL).

RETURN VALUES
     Upon  successful  completion,  getlabel()  and   fgetlabel()
     return 0. Otherwise they return -1 and set errno to indicate
     the error.

ERORS
     The getlabel() function will fail if:

     EACES          Search permission is denied for a  component
                     of the path prefix of path. To override this
                     restriction, the calling process can  assert
                     the PRIVFILEDACSEARCH privilege.


     EFAULT          labelp  or  path  points  to   an   invalid
                     address.


     EIO             An I/O error occurred while reading from  or
                     writing to the file system.



SunOS 5.11          Last change: 20 Jul 2007                    1






System Calls                                          getlabel(2)



     ELOP           Too many symbolic links were encountered  in
                     translating path.


     ENAMETOLONG    The length  of  the  path  argument  exceeds
                     PATHMAX,  or a pathname component is longer
                     than NAMEMAX while  POSIXNOTRUNC  is  in
                     effect (see pathconf(2)).


     ENOENT          The file referred to by path does not exist.


     ENOTDIR         A component of the path prefix  of  path  is
                     not a directory.



     The fgetlabel() function will fail if:

     EBADF     The fd argument is not a valid open file  descrip-
               tor.


     EFAULT    The labelp argument points to an invalid address.


     EIO       An I/O error occurred while reading from or  writ-
               ing to the file system.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcslr                    
    
     Interface Stability          Committed                   
    


SEE ALSO
     open(2), pathconf(2),  mlabelalloc(3TSOL),  attributes(5),
     labels(5)






SunOS 5.11          Last change: 20 Jul 2007                    2






System Calls                                          getlabel(2)



     Obtaining  a  File  Label  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                    3