setpgid(2)                                                       setpgid(2)




 NAME    [Toc]    [Back]
      setpgid(), setpgrp2() - set process group ID for job control

 SYNOPSIS    [Toc]    [Back]
      #include <unistd.h>

      int setpgid(pid_t pid, pid_t pgid);

      int setpgrp2(pid_t pid, pid_t pgid);

 DESCRIPTION    [Toc]    [Back]
      The setpgid() and setpgrp2() system calls cause the process specified
      by pid to join an existing process group or create a new process group
      within the session of the calling process.  The process group ID of
      the process whose process ID is pid is set to pgid.  If pid is zero,
      the process ID of the calling process is used.  If pgid is zero, the
      process ID of the indicated process is used.  The process group ID of
      a session leader does not change.

      setpgrp2() is provided for backward compatibility only.

 RETURN VALUE    [Toc]    [Back]
      setpgid() and setpgrp2() return the following values:

            0   Successful completion.
           -1   Failure.  errno is set to indicate the error.

 ERRORS    [Toc]    [Back]
      If setpgid() or setpgrp2() fails, errno is set to one of the following
      values.

           [EACCES]       The value of pid matches the process ID of a child
                          process of the calling process and the child
                          process has successfully executed one of the
                          exec(2) functions.

           [EINVAL]       The value of pgid is less than zero or is outside
                          the range of valid process group ID values.

           [EPERM]        The process indicated by pid is a session leader.

           [EPERM]        The value of pid is valid but matches the process
                          ID of a child process of the calling process, and
                          the child process is not in the same session as
                          the calling process.

           [EPERM]        The value of pgid does not match the process ID of
                          the process indicated by pid and there is no
                          process with a process group ID that matches the
                          value of pgid in the same session as the calling
                          process.



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 setpgid(2)                                                       setpgid(2)




           [ESRCH]        The value of pid does not match the process ID of
                          the calling process or of a child process of the
                          calling process.

 AUTHOR    [Toc]    [Back]
      setpgid() and setpgrp2() were developed by HP and the University of
      California, Berkeley.

 SEE ALSO    [Toc]    [Back]
      bsdproc(3C), exec(2), exit(2), fork(2), getpid(2), kill(2), setsid(2),
      signal(2), termio(7).

 STANDARDS CONFORMANCE    [Toc]    [Back]
      setpgid(): AES, SVID3, XPG3, XPG4, FIPS 151-2, POSIX.1


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003