tcgetpgrp - Gets foreground process group ID
Standard C Library (libc.so, libc.a)
Application developers may want to specify an #include statement for <sys/types.h> before the one for <unistd.h> if programs are being developed for multiple platforms. The additional #include statement is not required on Tru64 UNIX systems or by ISO or X/Open standards, but may be required on other vendors' systems that conform to these standards.
Interfaces documented on this reference page conform to industry standards as follows:
tcgetpgrp(): XPG4, XPG4-UNIX
Refer to the standards(5) reference page for more information about industry standards and associated tags.
Indicates the open file descriptor for the terminal special file.
The tcgetpgrp() function returns the value of the process group ID of the foreground process group associated with the terminal. The function can be called from a background process; however, the information may be subsequently changed by the foreground process.
Upon successful completion, the process group ID of the foreground process is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.
The tcgetpgrp() function sets errno to the specified values for the following conditions: The filedes parameter is not a valid file descriptor. The calling process does not have a controlling terminal or the file is not the controlling terminal.
Functions: setpgid(2), setsid(2), tcsetpgrp(3)
Standards: standards(5) delim off