Man Pages

getfilecon(3) - phpMan getfilecon(3) - phpMan

Command: man perldoc info search(apropos)  


getfilecon(3)              SELinux API documentation             getfilecon(3)



NAME
       getfilecon, fgetfilecon, lgetfilecon - get SELinux security context of a file

SYNOPSIS
       #include <selinux/selinux.h>

       int getfilecon(const char *path, security_context_t *con);

       int lgetfilecon(const char *path, security_context_t *con);

       int fgetfilecon(int fd, security_context_t *con);

DESCRIPTION
       getfilecon  retrieves  the context associated with the given path in the file system, the length of the context
       is returned.

       lgetfilecon is identical to getfilecon, except in the case of a symbolic link, where the link itself is  inter-
       rogated, not the file that it refers to.

       fgetfilecon  is  identical  to getfilecon, only the open file pointed to by filedes (as returned by open(2)) is
       interrogated in place of path.


       The returned context should be freed with freecon if non-NULL.

RETURN VALUE
       On success, a positive number is returned indicating the size of the extended attribute value. On  failure,  -1
       is returned and errno is  set appropriately.

       If the context does not exist, or the process has no access to this attribute, errno is set to ENODATA.

       If extended attributes are not supported by the filesystem, or are dis- abled, errno is set to ENOTSUP.

       The errors documented for the stat(2) system call are also applicable here.


SEE ALSO
       selinux(8), freecon(3), setfilecon(3), setfscreatecon(3)



russellATcoker.au            1 January 2004                   getfilecon(3)