|
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON |
|
|
|
getfscreatecon(3) SELinux API documentation getfscreatecon(3)
getfscreatecon, setfscreatecon - get or set the SELinux security
context used for creating a new file system object
#include <selinux/selinux.h>
int getfscreatecon(char **con);
int getfscreatecon_raw(char **con);
int setfscreatecon(const char *context);
int setfscreatecon_raw(const char *context);
getfscreatecon() retrieves the context used for creating a new
file system object. This returned context should be freed with
freecon(3) if non-NULL. getfscreatecon() sets *con to NULL if no
fscreate context has been explicitly set by the program (i.e.
using the default policy behavior).
setfscreatecon() sets the context used for creating a new file
system object. NULL can be passed to setfscreatecon() to reset to
the default policy behavior. The fscreate context is
automatically reset after the next execve(2), so a program doesn't
need to explicitly sanitize it upon startup.
setfscreatecon() can be applied prior to library functions that
internally perform an file creation, in order to set an file
context on the objects.
getfscreatecon_raw() and setfscreatecon_raw() behave identically
to their non-raw counterparts but do not perform context
translation.
Note: Signal handlers that perform a setfscreatecon() must take
care to save, reset, and restore the fscreate context to avoid
unexpected behavior.
Note: Contexts are thread specific.
On error -1 is returned. On success 0 is returned.
selinux(8), freecon(3), getcon(3), getexeccon(3)
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 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 is not part of the original manual page), send a mail to
[email protected]
[email protected] 1 January 2004 getfscreatecon(3)
Pages that refer to this page: getfilecon(3), matchpathcon(3), matchpathcon_checkmatches(3), selinux_lsetfilecon_default(3), setfilecon(3), set_matchpathcon_flags(3)