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

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.7.9.tar.gz fetched from
       ⟨https://people.redhat.com/sgrubb/libcap-ng/index.html⟩ on
       2018-04-30.  If you discover any rendering problems in this HTML ver‐
       sion 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 man‐
       ual 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)