TCGETPGRP(3P) TCGETPGRP(3P)
NAME
tcgetpgrp - get distinguished process group ID
SYNOPSIS
#include <termios.h>
int tcgetpgrp(fildes)
int fildes;
DESCRIPTION
tcgetpgrp returns the value of the process group ID of the
distinguished process group associated with the terminal.
tcgetpgrp is part of the POSIX Job Control Option.
RETURN VALUE
Upon successful completion, tcgetpgrp returns the process
group ID of the distinguished process group associated with
the terminal. Otherwise, -1 is returned and errno is set to
indicate the error.
ERRORS
If any of the following conditions occur, tcgetpgrp will
return -1 and set errno to the corresponding value:
[EBADF] fildes is not a valid file descriptor.
[EINVAL] tcgetpgrp is not permitted for the device
associated with fildes.
[ENOTTY] The calling process does not have a
controlling terminal or the file is not the
controlling terminal.
SEE ALSO
setpgrp(2), setpgid(2), tcsetpgrp(3P).
Page 1 May 1989