tcsetpgrp(3) [osf1 man page]

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)

Check Out this Related Man Page

tcgetpgrp(3)						     Library Functions Manual						      tcgetpgrp(3)

NAME

       tcgetpgrp -  Gets foreground process group ID

LIBRARY

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

SYNOPSIS

       #include <unistd.h>

       pid_t tcgetpgrp(
	       int filedes);

       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.

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       tcgetpgrp():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       Indicates the open file descriptor for the terminal special file.

DESCRIPTION

       The  tcgetpgrp() function returns the value of the process group ID of the foreground process group associated with the terminal. The func-
       tion can be called from a background process; however, the information may be subsequently changed by the foreground process.

RETURN VALUES

       Upon successful completion, the process group ID of the foreground process is returned. Otherwise, a value of -1 is returned and  errno	is
       set to indicate the error.

ERRORS

       The  tcgetpgrp()  function  sets  errno	to  the  specified  values for the following conditions: The filedes parameter is not a valid file
       descriptor.  The calling process does not have a controlling terminal or the file is not the controlling terminal.

RELATED INFORMATION

       Functions: setpgid(2), setsid(2), tcsetpgrp(3)

       Standards: standards(5) delim off

																      tcgetpgrp(3)

Linux and UNIX Man Pages

tcsetpgrp(3) [osf1 man page]

Check Out this Related Man Page