getsockcreatecon(3) SELinux API documentation getsockcreatecon(3)

# [NAME](#NAME)

getsockcreatecon, setsockcreatecon - get or set the SELinux security context used for creating a new labeled sockets

# [SYNOPSIS](#SYNOPSIS)

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

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

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

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

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

# [DESCRIPTION](#DESCRIPTION)

**getsockcreatecon**() retrieves the context used for creating a new labeled network socket. This returned context should be freed with [**freecon**(3)](/man/os/libselinux/freecon.3) if non-NULL. **getsockcreatecon**() sets \*con to NULL if no sockcreate context has been explicitly set by the program (i.e. using the default policy behavior).

**setsockcreatecon**() sets the context used for creating a new labeled network sockets NULL can be passed to **setsockcreatecon**() to reset to the default policy behavior. The sockcreate 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.

**setsockcreatecon**() can be applied prior to library functions that internally perform an file creation, in order to set an file context on the objects.

**getsockcreatecon\_raw**() and **setsockcreatecon\_raw**() behave identically to their non-raw counterparts but do not perform context translation.

**Note:** Signal handlers that perform a **setsockcreatecon**() must take care to save, reset, and restore the sockcreate 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)

24 September 2008 dwalsh@redhat.com

---

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