- NetBSD Manual Pages
TCSETPGRP(3) NetBSD Library Functions Manual TCSETPGRP(3)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
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.
Upon successful completion, tcsetpgrp returns a value of zero.
If an error occurs, tcgetpgrp returns -1 and the global variable errno is
set to indicate the error, as follows:
[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 tcsetpgprp function conforms to ISO/IEC 9945-1:1990 (``POSIX.1'').
NetBSD 9.1 June 4, 1993 NetBSD 9.1