NAME    [Toc]    [Back]

     tcgetpgrp -- get foreground process group ID

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <unistd.h>

     pid_t
     tcgetpgrp(int fd);

DESCRIPTION    [Toc]    [Back]

     The tcgetpgrp() function returns the value of the process group ID of the
     foreground process group associated with the terminal device.  If there
     is no foreground process group, tcgetpgrp() returns an invalid process
     ID.

ERRORS    [Toc]    [Back]

     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.

     [ENOTTY]		The calling process does not have a controlling terminal
 or the underlying terminal device represented by
			fd is not the controlling terminal.

SEE ALSO    [Toc]    [Back]

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

STANDARDS    [Toc]    [Back]

     The tcgetpgrp() function is expected to be compliant with the IEEE Std
     1003.1-1988 (``POSIX.1'') specification.


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1