context_new(3) SELinux API documentation context_new(3)NAME
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
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
Return a new context initialized to a context string
context_str
Return 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
Free 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 success, zero is returned. On failure, -1 is returned and errno is
set appropriately.
SEE ALSOselinux(8)dwalsh@redhat.com 20 December 2011 context_new(3)