TCGETPGRP(3) | Library Functions Manual | TCGETPGRP(3)

# NAME

`tcgetpgrp` — get foreground process group ID

# SYNOPSIS

`#include <unistd.h>`

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 is compliant with the IEEE Std 1003.1-1988 (“POSIX.1”) specification.

January 12, 2023 | Debian