#include <sys/types.h>
#include <unistd.h> int
tcsetpgrp (int fd pid_t pgrp_id);
DESCRIPTION
If the process has a controlling terminal, the
tcsetpgrp ();
function sets the foreground process group ID associated with the
terminal device to
Fa pgrp_id .
The terminal device associated with
Fa fd
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
Fa pgrp_id
must be the same as the process group ID of a process in the same
session as the calling process.
RETURN VALUES
Rv -std tcsetpgrp
ERRORS
The
tcsetpgrp ();
function will fail if:
Bq Er EBADF
The
Fa fd
argument is not a valid file descriptor.
Bq Er EINVAL
An invalid value of
Fa pgrp_id
was specified.
Bq Er ENOTTY
The calling process does not have a controlling terminal, or the file
represented by
Fa fd
is not the controlling terminal, or the controlling terminal is no
longer associated with the session of the calling process.
Bq Er EPERM
The
Fa pgrp_id
argument does not match the process group ID of a process in the same
session as the calling process.
