capng_get_caps_fd(3) — Linux manual page

CAPNG_GET_CAPS_FD(3)          Libcap-ng API         CAPNG_GET_CAPS_FD(3)

NAME

       capng_get_caps_fd - read file-based capabilities from extended
       attributes

SYNOPSIS

       #include <cap-ng.h>

       int capng_get_caps_fd(int fd);

DESCRIPTION

       This function will read the file based capabilities stored in
       extended attributes of the file that the descriptor was opened
       against. The bounding set is not included in file based
       capabilities operations. Note that this function will only work
       if compiled on a kernel that supports file based capabilities
       such as 2.6.26 and later. If the "magic" bit is set, then all
       effect capability bits are set. Otherwise the bits are cleared.

RETURN VALUE

       This returns 0 on success and -1 on failure.

SEE ALSO

       capng_set_caps_fd(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                         June 2009           CAPNG_GET_CAPS_FD(3)

Pages that refer to this page: capng_apply_caps_fd(3), capng_get_rootid(3), capng_have_capabilities(3), capng_have_capability(3)

---