Manual Pages for UNIX Operating System command usage for man getsid

System Calls                                            getsid(2)



NAME
     getsid - get process group ID of session leader

SYNOPSIS
     #include 

     pid_t getsid(pid_t pid);


DESCRIPTION
     The getsid() function obtains the process group  ID  of  the
     process  that is the session leader of the process specified
     by pid.  If pid is (pid_t)0, it specifies the  calling  pro-
     cess.

RETURN VALUES
     Upon successful completion,  getsid()  returns  the  process
     group  ID  of  the  session leader of the specified process.
     Otherwise, it returns (pid_t)-1 and sets errno  to  indicate
     the error.

ERRORS
     The getsid() function will fail if:

     EPERM    The process specified by pid is  not  in  the  same
              session as the calling process, and the implementa-
              tion does not allow access to the process group  ID
              of the session leader of that process from the cal-
              ling process.


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


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


SEE ALSO
     exec(2), fork(2), getpid(2),  getpgid(2),  setpgid(2),  set-
     sid(2), attributes(5), standards(5)





SunOS 5.11          Last change: 22 Jan 1996                    1