context_new

Section: SELinux API documentation (3)
Updated: 15 November 2004
Index Return to Main Contents
 

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 );

const char * context_type_set(context_t con , const char* type);

const char * context_range_set(context_t con , const char* range);

const char * context_role_set(context_t con , const char* role );

const char * 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 ALSO

selinux(8)