capng_have_capabilities(3) — Linux manual page

CAPNG_HAVE_CAPABILITIES(3)    Libcap-ng API   CAPNG_HAVE_CAPABILITIES(3)

NAME

       capng_have_capabilities, capng_have_permitted_capabilities - check for capabilities

SYNOPSIS

       #include <cap-ng.h>

       capng_results_t capng_have_capabilities(capng_select_t set);
       capng_results_t capng_have_permitted_capabilities(void);

DESCRIPTION

       capng_have_capabilities will check the selected internal
       capabilities sets to see what the status is. The capabilities
       sets must be previously setup with calls to
       capng_get_caps_process, capng_get_caps_fd, or in some other way
       setup. The options are CAPNG_SELECT_CAPS for the traditional
       capabilities, CAPNG_SELECT_BOUNDS for the bounding set,
       CAPNG_SELECT_BOTH if checking both are desired,
       CAPNG_SELECT_AMBIENT if only checking the ambient capabilities,
       or CAPNG_SELECT_ALL if testing all sets is desired. When
       capabilities are checked, it will only look at the effective
       capabilities.

       If, however, the source of capabilities comes from a file, then
       you may need to additionally check the permitted capabilities.
       It's for this reason that capng_have_permitted_capabilities was
       created. It takes no arguments because it simply checks the
       permitted set.

RETURN VALUE

       This function will return one of the following four self
       explanatory values: CAPNG_FAIL, CAPNG_NONE, CAPNG_PARTIAL,
       CAPNG_FULL.

SEE ALSO

       capng_get_caps_process(3), capng_get_caps_fd(3),
       capng_have_capability(3), capabilities(7)

AUTHOR

       Steve Grubb

COLOPHON

       This page is part of the libcap-ng (capabilities commands and
       library (NG)) project.  Information about the project can be
       found at ⟨https://people.redhat.com/sgrubb/libcap-ng/⟩.  It is
       not known how to report bugs for this man page; if you know,
       please send a mail to man-pages@man7.org.  This page was obtained
       from the tarball libcap-ng-0.8.5.tar.gz fetched from
       ⟨https://people.redhat.com/sgrubb/libcap-ng/index.html⟩ on
       2024-06-14.  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

Red Hat                         Sept 2020     CAPNG_HAVE_CAPABILITIES(3)

Pages that refer to this page: capng_have_capability(3)

---