HP-UX Reference (11i v3 07/02) - 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.

WARNINGS

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 appli-

cations therefore should not rely on this error condition.