Standard C Library Functions                         tcgetsid(3C)

NAME
     tcgetsid - get process group ID for session leader for  con-
     trolling terminal

SYNOPSIS
     #include <termios.h>

     pid_t tcgetsid(int fildes);

DESCRIPTION
     The tcgetsid() function obtains the process group ID of  the
     session  for  which  the terminal specified by fildes is the
     controlling terminal.

RETURN VALUES
     Upon successful completion, tcgetsid() returns  the  process
     group  ID  associated with the terminal.  Otherwise, a value
     of (pid_t)-1 is returned and errno is set  to  indicate  the
     error.

ERRORS
     The tcgetsid() function will fail if:

     EACCES
           The fildes argument is not associated with a  control-
           ling terminal.

     EBADF The fildes argument is not a valid file descriptor.

     ENOTTY
           The file associated with fildes is not a terminal.

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

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

SEE ALSO
     attributes(5), termio(7I)

SunOS 5.8           Last change: 29 Dec 1996                    1