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)

Referenced By

The man pages context_free(3), context_range_get(3), context_range_set(3), context_role_get(3), context_role_set(3), context_type_get(3), context_type_set(3), context_user_get(3) and context_user_set(3) are aliases of context_new(3).

20 December 2011 dwalsh@redhat.com SELinux API documentation