System Calls                                            getsid(2)



NAME
     getsid - get process group ID of session leader

SYNOPSIS
     #include 

     pidt getsid(pidt 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 (pidt)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 (pidt)-1 and sets errno  to  indicate
     the error.

ERORS
     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.


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



     
           ATRIBUTE TYPE               ATRIBUTE 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