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

tcgetpgrp(3C) tcgetpgrp(3C)

NAME

tcgetpgrp( ) - get foreground process group id

SYNOPSIS

#include <unistd.h>

pid_t tcgetpgrp(int fildes);

DESCRIPTION

tcgetpgrp() returns the value of the process group

ID of the foreground process group associated with

the terminal referenced by ﬁldes.

tcgetpgrp()

is allowed from a process that is a member of a back-

ground process group (see termio(7)); however, the information can be subsequently changed by a process

that is a member of a foreground process group.

RETURN VALUE

Upon successful completion,

tcgetpgrp() returns the value of the process group

ID of the foreground

process group associated with the terminal referenced by ﬁldes. Otherwise,

tcgetpgrp() returns a

value of −1 and sets

errno

to indicate the error.

ERRORS

tcgetpgrp() fails if any of the following conditions are encountered:

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

WARNING

The error EACCES, which is returned if the controlling terminal has no foreground process group, might not

be returned in future releases, depending on the course taken by the POSIX standard. Portable applications

therefore should not rely on this error condition.