context_new

Section: SELinux API documentation (3)
Updated: 20 December 2011
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);

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)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 12:11:47 GMT, March 29, 2024