tcsetpgrp(3)                        CLIX                        tcsetpgrp(3)



  NAME

    tcsetpgrp - Sets foreground process group ID

  LIBRARY

    Standard C Library (libc.a)

  SYNOPSIS

    #include <sys/types.h>

    int tcsetpgrp(
      int filedescriptor ,
      pid_t processgroupid );

  PARAMETERS

    filedescriptor   Specifies an open file descriptor.

    processgroupid   Specifies the process group ID.

  DESCRIPTION

    The tcsetpgrp() function sets the foreground process group ID associated
    with the terminal to the value of the processgroupid parameter, if the
    process has a controlling terminal.  The file associated with the
    filedescriptor 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 processgroupid
    parameter must match a process group ID of a process in the same session
    as the calling process.

  RETURN VALUE

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

  ERRORS

    This function can fail for any of the following reasons:

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

    [EINVAL]   The processgroupid parameter is invalid.

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

    [EPERM]    The processgroupid parameter is valid, but matches a process ID



  2/94 - Intergraph Corporation                                              1

  tcsetpgrp(3)                        CLIX                        tcsetpgrp(3)



               or process group ID of a process in another session.

  RELATED INFORMATION

    Functions: tcgetpgrp(3)

















































  2                                              Intergraph Corporation - 2/94