context_new

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 );
       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
	Functions to deal with security contexts in user space.

       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,	 con-
       text_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,	 con-
       text_user_set Set a context component


RETURN VALUE
       On  success, zero is returned. On failure, -1 is returned and errno is
       set appropriately.




dwalsh@redhat.com	       15 November 2004		       context_new(3)