unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.9)
Page:
Section:
Apropos / Subsearch:
optional field



System Calls                                            getpid(2)



NAME
     getpid, getpgrp, getppid, getpgid  -  get  process,  process
     group, and parent process IDs

SYNOPSIS
     #include <unistd.h>

     pid_t getpid(void);

     pid_t getpgrp(void);

     pid_t getppid(void);

     pid_t getpgid(pid_t pid);

DESCRIPTION
     The getpid() function returns the process ID of the  calling
     process.

     The getpgrp() function returns the process group ID  of  the
     calling process.

     The getppid() function returns the parent process ID of  the
     calling process.

     The getpgid() function returns the process group ID  of  the
     process  whose  process  ID  is equal to pid, or the process
     group ID of the calling process, if pid is equal to 0.

RETURN VALUES
     Upon successful completion, these functions return the  pro-
     cess  group  ID.  Otherwise, getpgid() returns (pid_t)-1 and
     sets errno to indicate the error.

ERRORS
     The getpgid() function will fail if:

     EPERM The process whose process  ID is equal to pid  is  not
           in  the  same  session as the calling process, and the
           implementation does not allow access  to  the  process
           group ID of that process from the calling process.

     ESRCH There is no process with a process ID equal to pid.

     The getpgid() function may fail if:

     EINVAL
           The value of the pid argument is invalid.

ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



SunOS 5.9           Last change: 28 Dec 1996                    1






System Calls                                            getpid(2)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | Async-Signal-Safe           |
    |_____________________________|_____________________________|


SEE ALSO
     intro(2),   exec(2),   fork(2),    getsid(2),    setpgid(2),
     setpgrp(2), setsid (2), signal(3C), attributes(5)













































SunOS 5.9           Last change: 28 Dec 1996                    2