man7.org > Linux > man-pages

Linux/UNIX system programming training

capng_have_capabilities(3) — Linux manual page

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

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

NAME         top

       capng_have_capabilities, capng_have_permitted_capabilities - check for capabilities

SYNOPSIS         top

       #include <cap-ng.h>

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

DESCRIPTION         top

       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         top

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

SEE ALSO         top

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

AUTHOR         top

       Steve Grubb

COLOPHON         top

       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
       2025-02-02.  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)

HTML rendering created 2025-02-02 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI