capng_setpid(3) — Linux manual page

CAPNG_SETPID(3)               Libcap-ng API               CAPNG_SETPID(3)

NAME         top

       capng_setpid - set working pid

SYNOPSIS         top

       #include <cap-ng.h>

       void capng_setpid(int pid);

DESCRIPTION         top

       capng_pid sets the working pid for capabilities operations. This
       is useful if you want to get the capabilities of a different
       process.

NOTES         top

       If your process calls fork , then the child process will still
       have the pid of the parent process stored in libcap-ng's internal
       data. It is disallowed to do any kind of setcap operations because
       you would be crossing process boundaries. To correct this, if your
       program links against pthreads, then libcap-ng will use the
       pthread_atfork function (as a weak symbol) to reset the pid
       information to the new process automatically. You are not required
       to link against pthreads. You can call capng_setpid and adjust the
       stored pid manually.

RETURN VALUE         top

       None.

SEE ALSO         top

       capng_get_caps_process(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                         June 2009                 CAPNG_SETPID(3)

Pages that refer to this page: capng_get_caps_process(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.