NAME¶
context_new, context_str, context_free, context_type_get, context_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
SYNOPSIS¶
#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);
DESCRIPTION¶
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.
RETURN VALUE¶
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.
SEE ALSO¶
selinux(8)