setpgrp3(2)                                                     setpgrp3(2)
                               TO BE OBSOLETED



 NAME    [Toc]    [Back]
      setpgrp3 - create session and set process group ID; for HP-UX 9.x
      compatibility.

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

      pid_t setpgrp3(void);

 DESCRIPTION    [Toc]    [Back]
      If the calling process is not a process group leader, setpgrp3()
      creates a new session.  The calling process becomes the session leader
      of this new session, it becomes the process group leader of a new
      process group, and it has no controlling terminal.  The process group
      ID of the calling process is set equal to the process ID of the
      calling process.  The calling process is the only process in the new
      process group, and the only process in the new session.

      setpgrp3() function is provided for HP-UX compatibility in future
      releases. setpgrp3() is functionally equivalent to setpgrp() as
      provided in HP-UX 9.x.

 RETURN VALUE    [Toc]    [Back]
      Upon successful completion, setpgrp3() returns the value of the
      process group ID of the calling process.  Otherwise, it returns a
      value of -1, and sets errno to indicate the error.

 ERRORS    [Toc]    [Back]
      No errors are defined.

 WARNINGS    [Toc]    [Back]
    Obsolescent Interfaces
      setpgrp3() is to be obsoleted at a future date.

 AUTHOR    [Toc]    [Back]
      setpgrp3() was developed by HP.

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


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