|PMSETPROCESSIDENTITY(3)||Library Functions Manual||PMSETPROCESSIDENTITY(3)|
NAME¶pmSetProcessIdentity - set process user and group id
C SYNOPSIS¶#include <pcp/pmapi.h>
pmSetProcessIdentity(const char *username);
cc ... -lpcp
DESCRIPTION¶pmSetProcessIdentity provides a platform-independent method to set the user id of a process to that matching username.
If possible (when the caller is already running as root) pmSetProcessIdentity will set the group id of the process to that of the matching user, e.g. using username and getpwnam(3).
A return value of 0 indicates success, otherwise the return value is an error code that may be decoded with pmErrStr(3).
pmSetProcessIdentity is most often used in conjunction with pmGetUsername(3) at process start up.
SEE ALSO¶getpwnam(3), PMAPI(3), pmErrStr(3), pmGetUsername(3), setgid(3) and setuid(3).