tcsetpgrp(3) [freebsd man page]

TCSETPGRP(3)						   BSD Library Functions Manual 					      TCSETPGRP(3)

NAME

     tcsetpgrp -- set foreground process group ID

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <sys/types.h>
     #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 currently 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 indi-
     cate 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 terminal, or the file represented by fd is not the controlling 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.

BSD
								   June 4, 1993 							       BSD

tcsetpgrp(3)						     Library Functions Manual						      tcsetpgrp(3)

NAME

       tcsetpgrp -  Sets foreground process group ID

LIBRARY

       Standard C Library (libc.so, libc.a)

SYNOPSIS

       #include <unistd.h>

       int tcsetpgrp(
	       int filedes,
	       pid_t pgrp_id );

       Application  developers	may  want  to  specify an #include statement for <sys/types.h> before the one for <unistd.h> if programs are being
       developed for multiple platforms. The additional #include statement is not required on Tru64 UNIX systems or by ISO  or	X/Open	standards,
       but may be required on other vendors' systems that conform to these standards.

PARAMETERS

       Specifies an open file descriptor.  Specifies the process group identifier.

DESCRIPTION

       If  the	process  has a controlling terminal, the tcsetpgrp() function sets the foreground process group ID associated with the terminal to
       the value of the pgrp_id parameter. The file associated with the filedes parameter 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 the pgrp_id parameter must
       match a process group ID of a process in the same session as the calling process.

RETURN VALUES

       Upon successful completion, a value of 0 (zero) is returned. Otherwise, a value of -1 is returned and errno is set to indicate the error.

ERRORS

       The tcsetpgrp() function sets errno to the specified values for the following conditions:

       The filedes parameter is not a valid file descriptor.  The pgrp_id parameter is invalid.  The calling process does not have  a  controlling
       terminal,  the  file  is  not the controlling terminal, or the controlling terminal is no longer associated with the session of the calling
       process.  The value of the pgrp_id parameter does not match the process group ID of a process in the same session as the calling process.

RELATED INFORMATION

       Functions: tcgetpgrp (3)

       Standards: standards(5) delim off

																      tcsetpgrp(3)