tcsetpgrp(3C)tcsetpgrp(3C)NAMEtcsetpgrp() - set foreground process group id
SYNOPSISDESCRIPTION
If the calling process has a controlling terminal, sets the foreground
process group ID associated with the terminal referenced by fildes to
pgrp_id. The file associated with fildes must be the controlling ter‐
minal of the calling process and the controlling terminal must be cur‐
rently associated with the session of the calling process. The value
of pgrp_id must match a process group ID of a process in the same ses‐
sion as the calling process.
RETURN VALUE
Upon successful completion, returns zero. Otherwise, returns −1 and
sets to indicate the error.
ERRORS
fails if any of the following conditions are encountered:
[EBADF] fildes is not a valid file descriptor.
[EINVAL] The value of the pgrp_id argument is not sup‐
ported.
[ENOTTY] The calling process does not have a controlling
terminal, or the fildes is not the controlling
terminal, or the controlling terminal is no
longer associated with the session of the calling
process.
[EPERM] The value of pgrp_id is a supported value but
does not match the process group ID of a process
in the same session as the calling process.
SEE ALSOsetpgid(2), setsid(2), tcgetpgrp(3C), thread_safety(5), termio(7).
STANDARDS CONFORMANCEtcsetpgrp(3C)