selinux_file_context_cmp(3) — Linux manual page

selinux_...text_cmp(3)  Library Functions Manual  selinux_...text_cmp(3)

NAME

       selinux_file_context_cmp - Compare two SELinux security contexts
       excluding the 'user' component

SYNOPSIS

       #include <selinux/selinux.h>

       int selinux_file_context_cmp(const char *a,
              const char *b);

DESCRIPTION

       selinux_file_context_cmp() compares two context strings excluding
       the user component with strcmp(3) as shown in the EXAMPLE
       section.

       This is useful as for most object contexts, the user component is
       not relevant.

RETURN VALUE

       The return values follow the strcmp(3) function, where:
              0  if they are equal.
              1  if a is greater than b
              -1 if a is less than b

ERRORS

       None.

NOTES

       The contexts being compared do not specifically need to be file
       contexts.

EXAMPLE

       If context a is:
              user_u:user_r:user_t:s0

       and context b is:
              root:user_r:user_t:s0

       then the actual strings compared are:
              :user_r:user_t:s0 and :user_r:user_t:s0

       Therefore they will match and selinux_file_context_cmp() will
       return zero.

SEE ALSO

       selinux(8)

COLOPHON

       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 2024-06-14.  (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

SELinux API documentation     08 March 2011       selinux_...text_cmp(3)

Pages that refer to this page: selinux_lsetfilecon_default(3)

---