NAME    [Toc]    [Back]

     tcgetsid - get session ID associated with a controlling terminal

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <unistd.h>

     pid_t
     tcgetsid(int fd);

DESCRIPTION    [Toc]    [Back]

     The tcgetsid function returns the value of the session ID associated with
     the specified controlling terminal device.  The session ID is defined as
     the process group ID of the session leader.

ERRORS    [Toc]    [Back]

     If an error occurs, tcgetsid returns -1 and the global variable errno is
     set to indicate the error, as follows:

     [EBADF]            The fd argument is not a valid file descriptor.

     [ENOTTY]           The calling process does not have a controlling terminal
 or the underlying terminal device represented by
                        fd is not the controlling terminal.

SEE ALSO    [Toc]    [Back]

     getsid(2), setsid(2), tcgetpgrp(3)

STANDARDS    [Toc]    [Back]

     The tcgetsid function conforms to X/Open Portability Guide Issue 4.2
     (``XPG4.2'').

BSD                            February 13, 1998                           BSD