tcsetpgrp(3) DG/UX 4.30 tcsetpgrp(3)
NAME
tcsetpgrp - Set foreground process group ID.
SYNOPSIS
#include <sys/types.h>
int tcsetpgrp (fildes, pgrp_id)
int fildes;
pid_t pgrp_id;
DESCRIPTION
If {_POSIX_JOB_CONTROL} is defined:
If the process has a controlling terminal, the
tcsetpgrp() function shall set the foreground process
group ID associated with the terminal to pgrp_id. The
file associated with fildes 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.
Otherwise:
The implementation shall either support the tcsetpgrp()
function as described above, or the tcsetpgrp() call
shall fail.
RETURNS
Upon successful completion, tcsetpgrp() returns a value of
zero. Otherwise, a value of -1 is returned and errno is set
to indicate the error.
ERRORS
If any of the following conditions occur, the tcsetpgrp()
function shall return -1 and set errno to the corresponding
value:
[EBADF]
The fildes argument is not a valid file descriptor.
[EINVAL]
The value of the pgrp_id argument is a value not
supported by the implementation.
[ENOSYS]
The tcsetpgrp() function is not supported in this
Licensed material--property of copyright holder(s) Page 1
tcsetpgrp(3) DG/UX 4.30 tcsetpgrp(3)
implementation.
[ENOTTY]
The calling process does not have a controlling
terminal, or the file 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 value supported by the
implementation but does not match the process group ID
of a process in the same session as the calling
process.
COPYRIGHTS
Portions of this text are reprinted from IEEE Std 1003.1-
1988, Portable Operating System Interface for Computer
Environment, copyright © 1988 by the Institute of Electrical
and Electronics Engineers, Inc., with the permission of the
IEEE Standards Department. To purchase IEEE Standards, call
800/678-IEEE.
In the event of a discrepancy between the electronic and the
original printed version, the original version takes
precedence.
STANDARDS
The tcsetpgrp() function is fully supported, regardless of
whether _POSIX_JOB_CONTROL is defined.
Licensed material--property of copyright holder(s) Page 2