tcgetpgrp - Get foreground process group ID
int filedes );
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
Standard C Library (libc)
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
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
Functions: setpgid(2), setsid(2), tcsetpgrp(3)
[ Back ]