tcgetpgrp(3C) tcgetpgrp(3C)
NAME
tcgetpgrp() - get foreground process group id
SYNOPSIS
DESCRIPTION
returns the value of the process group ID of the foreground process group associated with the terminal referenced by fildes. is allowed
from a process that is a member of a background 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, returns the value of the process group ID of the foreground process group associated with the terminal refer-
enced by fildes. Otherwise, returns a value of -1 and sets to indicate the error.
ERRORS
fails if any of the following conditions are encountered:
The file associated with
fildes is the controlling terminal of the calling process, however, there is no foreground process group defined for
the controlling terminal.
fildes is not a valid file descriptor.
The file associated with
fildes is not the controlling terminal or the calling process does not have a controlling terminal.
WARNINGS
The error which is returned if the controlling terminal has no foreground process group, might not be returned in future releases, depend-
ing on the course taken by the POSIX standard. Portable applications therefore should not rely on this error condition.
SEE ALSO
setpgid(2), setsid(2), tcsetpgrp(3C), thread_safety(5), termio(7).
STANDARDS CONFORMANCE
tcgetpgrp(3C)