TCGETPGRP(3-POSIX)  RISC/os Reference Manual   TCGETPGRP(3-POSIX)



NAME
     tcgetpgrp - get foreground process group ID

SYNOPSIS
     #include <sys/types.h>

     pidt tcgetpgrp(fildes)
     int fildes;

DESCRIPTION
     tcgetpgrp returns the value of the process group ID of the
     foreground process group associated with the terminal.
     tcgetpgrp may be called from a background process; however,
     the information may be subsequently changed by a process
     that is a member of a foreground process group.

RETURN VALUES
     Upon successful completion, tcgetpgrp returns the process
     group ID of the foreground process group associated with the
     terminal.  If there is no foreground process group,
     tcgetpgrp will return a value greater than 1 that does not
     match the process group ID of any existing process group.
     Otherwise, -1 is returned and errno is set to indicate the
     error.

ERRORS
     If any of the following conditions occur, tcgetpgrp returns
     -1 and sets errno to the corresponding value:

     [EBADF]             fildes is not a valid file descriptor.

     [ENOTTY]            The calling process does not have a con-
                         trolling terminal or the file is not the
                         controlling terminal.

SEE ALSO
     setsid(2), setpgid(2), tcsetpgrp(3).


















                         Printed 1/15/91                   Page 1