Table of Contents
If the
process has a controlling terminal, the function sets the foreground process
group ID associated with the terminal device to The terminal device associated
with must be the controlling terminal of the calling process and the controlling
terminal must be currently associated with the session of the calling process.
The value of must be the same as the process group ID of a process in
the same session as the calling process. Upon successful completion, returns
a value of zero.
If an error occurs, returns -1 and the global variable
is set to indicate the error, as follows: The argument is not a valid
file descriptor. An invalid value of was specified. The calling process
does not have a controlling terminal, or the file represented by is not
the controlling terminal, or the controlling terminal is no longer associated
with the session of the calling process. The argument does not match the
process group ID of a process in the same session as the calling process.
The function is expected to be compliant with the
specification.
Table of Contents