GETPID(2) - man page online | system calls

Get process identification.

GETPID(2)                           Linux Programmer's Manual                           GETPID(2)


getpid, getppid - get process identification


#include <sys/types.h> #include <unistd.h> pid_t getpid(void); pid_t getppid(void);


getpid() returns the process ID of the calling process. (This is often used by routines that generate unique temporary filenames.) getppid() returns the process ID of the parent of the calling process.


These functions are always successful.


POSIX.1-2001, POSIX.1-2008, 4.3BSD, SVr4.


If the caller's parent is in a different PID namespace (see pid_namespaces(7)), getppid() returns 0. C library/kernel differences Since glibc version 2.3.4, the glibc wrapper function for getpid() caches PIDs, so as to avoid additional system calls when a process calls getpid() repeatedly. Normally this caching is invisible, but its correct operation relies on support in the wrapper functions for fork(2), vfork(2), and clone(2): if an application bypasses the glibc wrappers for these system calls by using syscall(2), then a call to getpid() in the child will return the wrong value (to be precise: it will return the PID of the parent process). See also clone(2) for discussion of a case where getpid() may return the wrong value even when invoking clone(2) via the glibc wrapper function.


clone(2), fork(2), kill(2), exec(3), mkstemp(3), tempnam(3), tmpfile(3), tmpnam(3), cre‐ dentials(7), pid_namespaces(7)


This page is part of release 4.04 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at
Linux 2015-07-23 GETPID(2)
This manual Reference Other manuals
getpid(2) referred by capget(2) | clone(2) | cr_restart(1) | credentials(7) | execve(2freebsd) | fanotify(7) | fcntl(2) | fexecve(2freebsd) | gawk(1) | getpid(2freebsd) | getppid(2freebsd) | gettid(2) | kill(2freebsd) | lamtrace(1) | libcap(3) | pid_namespaces(7) | procenv(1) | pthreads(7) | raise(3) | sched_setaffinity(2)
refer to clone(2) | exec(3) | fork(2) | kill(2) | mkstemp(3) | pid_namespaces(7) | syscall(2) | tempnam(3) | tmpfile(3) | tmpnam(3) | vfork(2)