DragonFly On-Line Manual Pages
TCSETPGRP(3) DragonFly Library Functions Manual TCSETPGRP(3)
tcsetpgrp -- set foreground process group ID
Standard C Library (libc, -lc)
tcsetpgrp(int fd, pid_t pgrp_id);
If the process has a controlling terminal, the tcsetpgrp() function sets
the foreground process group ID associated with the terminal device to
pgrp_id. The terminal device associated with fd must be the controlling
terminal 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 be the same as the process group ID of a process in the same
session as the calling process.
The tcsetpgrp() function returns the value 0 if successful; otherwise the
value -1 is returned and the global variable errno is set to indicate the
The tcsetpgrp() function will fail if:
[EBADF] The fd argument is not a valid file descriptor.
[EINVAL] An invalid value of pgrp_id was specified.
[ENOTTY] The calling process does not have a controlling termi-
nal, or the file represented by fd is not the control-
ling terminal, or the controlling terminal is no
longer associated with the session of the calling
[EPERM] The pgrp_id argument does not match the process group
ID of a process in the same session as the calling
setpgid(2), setsid(2), tcgetpgrp(3)
The tcsetpgrp() function is expected to be compliant with the IEEE Std
1003.1-1988 (``POSIX.1'') specification.
DragonFly 4.1 June 4, 1993 DragonFly 4.1