tcgetpgrp(3)                        CLIX                        tcgetpgrp(3)



  NAME

    tcgetpgrp - Gets foreground process group ID

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    #include <sys/types.h>

    pid_t tcgetpgrp(
      int file_des );

  PARAMETERS

    file_des   Specifies 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.

  RETURN VALUE

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

  ERRORS

    This function fails for the following reasons:

    [EBADF]    The file_des parameter is not a valid file descriptor.

    [ENOTTY]   The calling process does not have a controlling terminal.

  RELATED INFORMATION

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












  2/94 - Intergraph Corporation                                              1