HP-UX Reference (11i v1 05/09) - 3 Library Functions N-Z (vol 7)

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.