tcgetsid.3c (2010 09)

tcgetsid(3C) tcgetsid(3C)

NAME

tcgetsid() - get terminal session ID

SYNOPSIS

#include <termios.h>

pid_t tcgetsid (int fildes);

DESCRIPTION

The tcgetsid() function returns the value of the session ID of the foreground process associated with

the terminal referenced by ﬁldes.

tcgetsid() is allowed from a process that is a member of a back-

ground process group (see termio (7)).

RETURN VALUE

Upon successful completion,

tcgetsid() returns the value of the session ID of the foreground process

associated with the terminal referenced by ﬁldes . Otherwise,

tcgetsid() returns a value of −1 and

sets

errno to indicate the error.

ERRORS

If the

tcgetsid() function fails, it sets errno

(see errno(2)) to one of the following values:

[EACCES] The ﬁle associated with ﬁldes is the controlling terminal of the calling process; how-

ever, there is no foreground process group deﬁned for the controlling terminal.

[EBADF] ﬁldes is not a valid ﬁle descriptor.

[ENOTTY] The ﬁle associated with ﬁldes is not the controlling terminal or the calling process

does not have a controlling terminal.