Movatterモバイル変換

getfilecon(3) — Linux manual page

getfilecon(3)           SELinux API documentationgetfilecon(3)

NAME        top

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

SYNOPSIS        top

#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(intfd, char **con);int fgetfilecon_raw(intfd, char **con);

DESCRIPTION        top

getfilecon() retrieves the context associated with the given path       in the file system, the length of the context is returned.lgetfilecon() is identical togetfilecon(), except in the case of       a symbolic link, where the link itself is interrogated, not the       file that it refers to.fgetfilecon() is identical togetfilecon(), only the open file       pointed to by filedes (as returned byopen(2)) is interrogated in       place of path.  Since libselinux 3.4 a file opened viaO_PATH is       supported.getfilecon_raw(),lgetfilecon_raw() andfgetfilecon_raw() behave       identically to their non-raw counterparts but do not perform       context translation.       The returned context should be freed withfreecon(3) if non-NULL.

RETURN VALUE        top

       On success, a positive number is returned indicating the size of       the extended attribute value. On failure, -1 is returned anderrno       is  set appropriately.       If the context does not exist, or the process has no access to       this attribute,errno is set toENODATA.       If extended attributes are not supported by the filesystem, or are       disabled,errno is set toENOTSUP.       The errors documented for thestat(2) system call are also       applicable here.

SEE ALSO        top

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

COLOPHON        top

       This page is part of theselinux (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 2025-08-11.  (At       that time, the date of the most recent commit that was found in       the repository was 2025-08-04.)  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 isnot part of the original manual page), send a mail to       man-pages@man7.orgrussell@coker.com.au          1 January 2004getfilecon(3)

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

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.