FreeBSD Manual Pages
TCSETPGRP(3) FreeBSD Library Functions Manual TCSETPGRP(3) NAME tcsetpgrp -- set foreground process group ID LIBRARY Standard C Library (libc, -lc) SYNOPSIS #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 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. RETURN VALUES 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 error. ERRORS 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 process. [EPERM] The pgrp_id argument does not match the process group ID of a process in the same session as the calling process. SEE ALSO setpgid(2), setsid(2), tcgetpgrp(3) STANDARDS The tcsetpgrp() function is expected to be compliant with the IEEE Std 1003.1-1988 ("POSIX.1") specification. FreeBSD 13.0 November 28, 2022 FreeBSD 13.0
NAME | LIBRARY | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | STANDARDS
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=tcsetpgrp&sektion=3&manpath=FreeBSD+13.2-RELEASE>