context_new(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | SEE ALSO | COLOPHON

context_new(3)          SELinux API documentation         context_new(3)

NAME         top

       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         top

       #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         top

       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         top

       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         top

       selinux(8)

COLOPHON         top

       This page is part of the selinux (Security-Enhanced Linux user-
       space libraries and tools) project.  Information about the
       project can be found at 
       ⟨https://github.com/SELinuxProject/selinux/wiki⟩.  If you have a
       bug report for this manual page, see
       ⟨https://github.com/SELinuxProject/selinux/wiki/Contributing⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/SELinuxProject/selinux⟩ on 2023-12-22.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-05-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

dwalsh@redhat.com           20 December 2011              context_new(3)