NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON |
context_new(3) SELinux API documentation context_new(3)
context_new, context_str, context_free, context_type_get, con‐ text_type_set, context_range_get, context_range_set,context_role_get, context_role_set, context_user_get, context_user_set - Routines to manipulate SELinux security contexts
#include <selinux/context.h> context_t context_new(const char *context_str); const char * context_str(context_t con); void context_free(context_t con); const char * context_type_get(context_t con); const char * context_range_get(context_t con); const char * context_role_get(context_t con); const char * context_user_get(context_t con); int context_type_set(context_t con, const char *type); int context_range_set(context_t con, const char *range); int context_role_set(context_t con, const char *role); int context_user_set(context_t con, const char *user);
These functions allow an application to manipulate the fields of a security context string without requiring it to know the format of the string. context_new() returns a new context initialized to a context string. context_str() returns a pointer to the string value of the context_t, valid until the next call to context_str() or context_free() for the same context_t*. context_free() frees the storage used by a context. context_type_get(), context_range_get(), context_role_get(), context_user_get() get a pointer to the string value of a context component. Note: Values returned by the get functions are only valid until the next call to a set function or context_free() for the same context_t structure. context_type_set(), context_range_set(), context_role_set(), context_user_set() set a context component.
On failure context_*_set() functions return non-zero and 0 on success. The other functions return NULL on failure and non-NULL on success. On failure errno is set appropriately.
selinux(8)
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 2017-07-05. 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
dwalsh@redhat.com 20 December 2011 context_new(3)