NAME
tcgetpgrp
- get foreground process group ID
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
pid_t
tcgetpgrp(
int fd
)
DESCRIPTION
The
tcgetpgrp
function returns the value of the process group ID of the foreground
process group associated with the terminal device.
If there is no foreground process group,
tcgetpgrp
returns an invalid process ID.
ERRORS
If an error occurs,
tcgetpgrp
returns -1 and the global variable
errno
is set to indicate the error, as follows:
- [
EBADF
] -
The
fd
argument is not a valid file descriptor.
- [
ENOTTY
] -
The calling process does not have a controlling terminal or the
underlying terminal device represented by
fd
is not the controlling terminal.
SEE ALSO
setpgid(2),
setsid(2),
tcsetpgrp(3)
STANDARDS
The
tcgetpgrp
function conforms to
ISO/IEC 9945-1:1990 (``POSIX.1'') .