tcgetpgrp(3C)
NAME
tcgetpgrp - get foreground process group ID
SYNOPSIS
#include <sys/types.h>
#include <unistd.h>
pid_t tcgetpgrp(int fildes);
DESCRIPTION
The tcgetpgrp() function will return the value of the pro-
cess group ID of the foreground process group associated
with the terminal.
If there is no foreground process group, tcgetpgrp() returns
a value greater than 1 that does not match the process group
ID of any existing process group.
The tcgetpgrp() function is allowed from a process that is a
member of a background process group; however, the informa-
tion may be subsequently changed by a process that is a
member of a foreground process group.
RETURN VALUES
Upon successful completion, tcgetpgrp() returns the value of
the process group ID of the foreground process associated
with the terminal. Otherwise, -1 is returned and errno is
set to indicate the error.
ERRORS
The tcgetpgrp() function will fail if:
EBADF The fildes argument is not a valid file descriptor.
ENOTTY
The calling process does not have a controlling termi-
nal, or the file is not the controlling terminal.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
______________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_______________________________|
| MT-Level | MT-Safe, and Async-Signal-Safe|
|_____________________________|_______________________________|
SEE ALSO
setpgid(2), setsid(2), tcsetpgrp(3C), attributes(5),
termio(7I)
Man(1) output converted with
man2html