getfilecon(3) — Linux manual page

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, char **con);

       int getfilecon_raw(const char *path, char **con);

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

       int lgetfilecon_raw(const char *path, char **con);

       int fgetfilecon(int fd, char **con);

       int fgetfilecon_raw(int fd, char **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 interrogated, 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.  Since libselinux 3.4 a file opened via O_PATH is
       supported.

       getfilecon_raw(), lgetfilecon_raw() and fgetfilecon_raw() behave
       identically to their non-raw counterparts but do not perform
       context translation.

       The returned context should be freed with freecon(3) 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 disabled, 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)

COLOPHON

       This page is part of the selinux (Security-Enhanced Linux user-
       space libraries and tools) project.  Information about the
       project can be found at 
       ⟨https://github.com/SELinuxProject/selinux/wiki⟩.  If you have a
       bug report for this manual page, see
       ⟨https://github.com/SELinuxProject/selinux/wiki/Contributing⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/SELinuxProject/selinux⟩ on 2024-06-14.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-05-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

russell@coker.com.au         1 January 2004                getfilecon(3)

Pages that refer to this page: security_class_to_string(3), setfilecon(3)

---