tcgetpgrp(3)               DG/UX 4.30                tcgetpgrp(3)



     NAME
          tcgetpgrp - Get foreground process group ID.

     SYNOPSIS
          #include <sys/types.h>

          pid_t tcgetpgrp (fildes)
          int fildes;

     DESCRIPTION
          If {_POSIX_JOB_CONTROL} is defined:

               (1) The tcgetpgrp() function shall return the value of
               the process group ID of the foreground process group
               associated with the terminal.

               (2) The tcgetpgrp() function is allowed from a process
               that is a member of a background process group;
               however, the information may be subsequently changed by
               a process that is a member of a foreground process
               group.

          Otherwise:

               The implementation shall either support the tcgetpgrp()
               function as described above, or the tcgetpgrp() call
               shall fail.

     RETURNS
          Upon successful completion, tcgetpgrp() returns the process
          group ID of the foreground process group associated with the
          terminal.  Otherwise, a value of -1 is returned and errno is
          set to indicate the error.

     ERRORS
          If any of the following conditions occur, the tcgetpgrp()
          function shall return -1 and set errno to the corresponding
          value:

          [EBADF]
               The fildes argument is not a valid file descriptor.

          [ENOSYS]
               The tcgetpgrp() function is not supported in this
               implementation.

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

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



     Licensed material--property of copyright holder(s)         Page 1

     tcgetpgrp(3)               DG/UX 4.30                tcgetpgrp(3)



     COPYRIGHTS
          Portions of this text are reprinted from IEEE Std 1003.1-
          1988, Portable Operating System Interface for Computer
          Environment, copyright © 1988 by the Institute of Electrical
          and Electronics Engineers, Inc., with the permission of the
          IEEE Standards Department.  To purchase IEEE Standards, call
          800/678-IEEE.

          In the event of a discrepancy between the electronic and the
          original printed version, the original version takes
          precedence.

     STANDARDS
          The tcgetpgrp() function is fully supported, regardless of
          whether _POSIX_JOB_CONTROL is defined.








































     Licensed material--property of copyright holder(s)         Page 2