getfscreatecon(3) SELinux API documentation getfscreatecon(3)

# [NAME](#NAME)

getfscreatecon, setfscreatecon - get or set the SELinux security context used for creating a new file system object

# [SYNOPSIS](#SYNOPSIS)

**#include <selinux/selinux.h>**

**int getfscreatecon(char \*\*con);**

**int getfscreatecon\_raw(char \*\*con);**

**int setfscreatecon(const char \*context);**

**int setfscreatecon\_raw(const char \*context);**

# [DESCRIPTION](#DESCRIPTION)

**getfscreatecon**() retrieves the context used for creating a new file system object. This returned context should be freed with [**freecon**(3)](/man/os/libselinux/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)](/man/os/libselinux/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.

# [RETURN VALUE](#RETURN_VALUE)

On error -1 is returned. On success 0 is returned.

# [SEE ALSO](#SEE_ALSO)

[**selinux**(8)](/man/os/libselinux/selinux.8), [**freecon**(3)](/man/os/libselinux/freecon.3), [**getcon**(3)](/man/os/libselinux/getcon.3), [**getexeccon**(3)](/man/os/libselinux/getexeccon.3)

1 January 2004 russell@coker.com.au

---

Document: setfscreatecon(3) from libselinux 3.11-r2 (Chainguard OS)
Source: https://github.com/SELinuxProject/selinux.git