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
       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_SETPID(3)

Pages that refer to this page: capng_get_caps_process(3)

HTML rendering created 2024-06-26 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.