| .TH "CAPNG_SETPID" "3" "June 2009" "Red Hat" "Libcap-ng API" |
| .SH NAME |
| capng_setpid \- set working pid |
| .SH "SYNOPSIS" |
| .B #include <cap-ng.h> |
| .sp |
| void capng_setpid(int pid); |
| |
| .SH "DESCRIPTION" |
| |
| capng_pid sets the working pid for capabilities operations. This is useful if you want to get the capabilities of a different process. |
| |
| .SH NOTES |
| |
| If your process calls |
| .B 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 |
| .B 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 |
| .B capng_setpid |
| and adjust the stored pid manually. |
| |
| .SH "RETURN VALUE" |
| |
| None. |
| |
| .SH "SEE ALSO" |
| |
| .BR capng_get_caps_process (3), |
| .BR capabilities (7) |
| |
| .SH AUTHOR |
| Steve Grubb |
