HP-UX Reference (11i v1 00/12) - 3 Library Functions N-Z (vol 7)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/nan.3m
________________________________________________________________
___ ___
t
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 fildes 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.
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] fildes is not a valid file descriptor.
[EINVAL] The value of the pgrp_id argument is not supported.
[ENOTTY] The calling process does not have a controlling terminal, or the fildes 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.
APPLICATION USAGE
tcsetpgrp() is thread-safe and async-cancel-safe.
SEE ALSO
setpgid(2), setsid(2), tcgetpgrp(3C), termio(7).
STANDARDS CONFORMANCE
tcsetpgrp() : AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1
Section 3−−974 − 1 − HP-UX Release 11i: December 2000
___
___