tcsetpgrp(3) - NetBSD Manual Pages

Command: Section: Arch: Collection:  
TCSETPGRP(3)            NetBSD 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. Upon successful completion, tcsetpgrp returns a value of zero.
ERRORS
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 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 tcsetpgprp function conforms to ISO/IEC 9945-1:1990 (``POSIX.1''). NetBSD 7.1.2 June 4, 1993 NetBSD 7.1.2
Powered by man-cgi (2024-03-20). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.