selinux_file_context_cmp(3) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | NOTES | EXAMPLE | SEE ALSO | COLOPHON

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

NAME         top

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

SYNOPSIS         top

       #include <selinux/selinux.h>

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

DESCRIPTION         top

       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         top

       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         top

       None.

NOTES         top

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

EXAMPLE         top

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

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

Pages that refer to this page: selinux_lsetfilecon_default(3)