tcsetpgrp.3c (2010 09)

tcsetpgrp(3C) tcsetpgrp(3C)

NAME

tcsetpgrp( ) - set foreground process group id

SYNOPSIS

#include <unistd.h>

int tcsetpgrp(int fildes, pid_t pgrp_id);

DESCRIPTION

If the calling process has a controlling terminal,

tcsetpgrp() sets the foreground process group ID

associated with the terminal referenced by ﬁldes to pgrp_id . The ﬁle associated with ﬁldes 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 pgrp_id must match a process group

ID of a process in the

same session as the calling process.

RETURN VALUE

Upon successful completion,

tcsetpgrp() returns zero. Otherwise,

tcsetpgrp() returns −1 and

sets

errno to indicate the error.

ERRORS

tcsetpgrp() fails if any of the following conditions are encountered:

[EBADF] ﬁldes is not a valid ﬁle descriptor.

[EINVAL] The value of the pgrp_id argument is not supported.

[ENOTTY] The calling process does not have a controlling terminal, or the ﬁldes is not the con-

trolling 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.